微信公众号支付接口文档
V3.3
微信公众号支付接口文档
微信公众号支付接口文档
微信公众号支付接口文档
微信公众号支付接口文档
(V3.3.6)
(V3.3.6)
(V3.3.6)
(V3.3.6)
微信公众号支付接口文档
V3.3
目录
目录
目录
目录
微信公众号支付接口文档
............................................................................................................... 1
1.
微信支付简介
................................................................................................................................ 4
1.1.
功能简介
............................................................................................................................. 4
1.2.
支付账户
............................................................................................................................. 4
1.3.
支付方式
............................................................................................................................. 5
2.
支付场景介绍
................................................................................................................................ 5
2.1.
网页内支付场景
---JS API
（网页内）支付接口
.............................................................. 5
2.1.1.
交互细节
.................................................................................................................. 7
2.1.2.JSAPI
支付时序图
................................................................................................... 8
2.1.3.
获取当前微信版本号
.............................................................................................. 8
2.1.4.
显示微信安全支付标题
.......................................................................................... 8
2.2.
线下扫码购买场景
---Native
（原生）支付接口
............................................................... 9
2.2.1
使用场景
.................................................................................................................. 9
2.2.2.Native
（原生）支付
URL
定义
........................................................................... 10
3.
接口说明
...................................................................................................................................... 12
3.1.
接口调用规则
................................................................................................................... 12
3.2.Sign
签名生成方法
........................................................................................................... 13
3.3.
代码实例
........................................................................................................................... 14
4.API
说明
...................................................................................................................................... 15
4.1.
统一支付接口
................................................................................................................... 15
微信公众号支付接口文档
V3.3
4.2.
通用通知接口
................................................................................................................... 17
4.3.
订单查询接口
................................................................................................................... 19
4.4.JSAPI
支付 ——
H5
网页端调起支付接口
...................................................................... 21
4.5.Native
支付
——
二维码链接
............................................................................................ 22
4.6.Native
支付
——
请求商家获取商品信息接口
................................................................ 23
4.7
关闭订单接口
................................................................................................................... 24
4.8.
退款申请接口
................................................................................................................... 25
4.9.
退款查询接口
................................................................................................................... 27
4.10.
对账单接口
..................................................................................................................... 29
4.11.
短链接转换接口
............................................................................................................. 30
5.
企业红包使用说明
...................................................................................................................... 31
5.1 创建批次企业红包
.......................................................................................................... 31
5.2 提交支付使用企业红包
.................................................................................................. 31
5.3 查询使用企业红包金额
.................................................................................................. 32
5.4 企业红包对账单
.............................................................................................................. 32
6.
错误码列表
.................................................................................................................................. 32
7.
常见问题和注意事项
.................................................................................................................. 32
7.1.
常见基本概念疑惑
........................................................................................................... 32
7.2.
常见错误现象及解决方法
............................................................................................... 33
7.3.
常见注意事项
................................................................................................................... 34
7.4.
联系我们
........................................................................................................................... 35
微信公众号支付接口文档
V3.3
1.
1.
1.
1. 微信支付简介
微信支付简介
微信支付简介
微信支付简介
1.1.
1.1.
1.1.
1.1. 功能简介
功能简介
功能简介
功能简介
微信支付，是基于微信客户端提供的支付服务功能。同时向商户提供销售经营分析 、 账
户和资金管理的功能支持 。 用户通过扫描二维码 、 微信内打开商品页面购买等多种方式调起
微信支付模块完成支付。
微信支持公众号内支付 ， 即基于公众号向用户收款 ， 公众号相当于收款的商户 。 其中支
付方式，可以分为 JS API （网页内）支付、 Native （原生）支付。商户可以结合业务场景
，
自主选择支付方式。
本文将全面介绍微信支付的技术方案。
1.2.
1.2.
1.2.
1.2. 支付账户
支付账户
支付账户
支付账户
商户向微信提交企业以及银行账户资料 ， 商户功能审核通过后 ， 可以获得以下帐户 （ 包
含财付通的商户账户 ） ，用于公众号支付。
帐号
帐号
帐号
帐号 作用
作用
作用
作用
appId
微信公众号身份的唯一标识。审核通过后，在微信发送的邮件中查看。
M chid
商户 ID ，身份标识，在微信发送的邮件中查看。
Key
商户支付密钥 Key 。 登录微信商户后台 ， 进入栏目 【 账户设置 】 【 密码安全
】
【 API 安全 】 【 API 密钥 】 ， 进入 设置 API 密钥。
Appsecret
JSAPI
接口中获取
openid
，审核后在公众平台开启开发模式后可查看。
微信公众号支付接口文档
V3.3
注意 ： 支付密钥
Key
是验证商户唯一性的安全标识 ， 请妥善保管 ， 仅保留在第三方后
台和微信后台，不会在网络中传播。
1.3.
1.3.
1.3.
1.3. 支付方式
支付方式
支付方式
支付方式
JS
JS
JS
JS API
API
API
API （
（
（
（ 网页内
网页内
网页内
网页内 ）
）
）
） 支付
支付
支付
支付 ： 是指用户打开图文消息或者扫描二维码 ， 在微信内置浏览器打
开网页进行的支付 。 商户网页前端通过使用微信提供的 JS API ， 调用微信支付模块 。 这种方
式，适合需要在商户网页进行选购下单的购买流程。
Native
Native
Native
Native （原生）支付：
（原生）支付：
（原生）支付：
（原生）支付： 是指商户组成符合 Native （原生）支付规则的 URL 链接，用户
可通过在会话中点击链接或者扫描对应的二维码直接进入微信支付模块（客户端界面 ） ，即
可进行支付。这种方式，适合无需选购直接支付的购买流程。跟 JSAPI 最大的区别是不经
过网页调起支付。
2.
2.
2.
2.
支付场景介绍
支付场景介绍
支付场景介绍
支付场景介绍
2.1.
2.1.
2.1.
2.1. 网页内支付场景
网页内支付场景
网页内支付场景
网页内支付场景 ---JS
---JS
---JS
---JS API
API
API
API （网页内）支付接口
（网页内）支付接口
（网页内）支付接口
（网页内）支付接口
商户已有 H5 商城网站 ， 在微信内打开网页时 ， 可以调用微信支付完成下单购买的流程 。
步骤 （ 1 ） ： 左图 ， 商户下发图文消息或者通过自定义菜单吸引用户点击进入商户网页 。
步骤（ 2 ） ：右图，进入家网页，用户选择购买，完成选购流程。
- 1
- 2
- 3
- 4
- 5
- 6
前往页