微信公众号支付接口文档 V2. 2
内部文档，请勿外传
微信公众号支付接口文档
微信公众号支付接口文档
微信公众号支付接口文档
微信公众号支付接口文档
V2.
V2.
V2.
V2. 2
2
2
2
（内部文档，请勿外传）
（内部文档，请勿外传）
（内部文档，请勿外传）
（内部文档，请勿外传）
微信公众号支付接口文档 V2. 2
内部文档，请勿外传
1. 微信支付简介 ................................................................................................................................ 4
1.1 功能简介 ............................................................................................................................. 4
1.2 支付账户 ............................................................................................................................. 4
1.3 支付方式 ............................................................................................................................. 5
1.4 测试帐号 ............................................................................................................................. 6
2. JS A PI 支付接口 ............................................................................................................................ 6
2.1 支付场景 ............................................................................................................................. 6
2.2 功能交互 ............................................................................................................................. 8
2.3 获取当前微信版本号 ......................................................................................................... 8
2.4 显示微信安全支付标题 ..................................................................................................... 8
2.5JS API 支付接口（ getBrandWCPayRequest ）定义 .......................................................... 9
2.6 订单详情（ package ）扩展字符串定义 .......................................................................... 11
2.7 支付签名（ paySign ）生成方法 ...................................................................................... 15
2.8 接口使用示例 ................................................................................................................... 16
3.Native （原生）支付接口 ........................................................................................................... 17
3.1 支付场景 ........................................................................................................................... 17
3.2 基本交互 ........................................................................................................................... 18
3.3Native （原生）支付接口描述 .......................................................................................... 18
3.4Native （原生）支付 URL 定义 ........................................................................................ 18
3.5Native （原生）支付 URL 签名方式 ................................................................................ 19
3.6Native （原生）支付回调商户后台获取 package ............................................................ 20
4. 通知接口说明 .............................................................................................................................. 22
微信公众号支付接口文档 V2. 2
内部文档，请勿外传
4.1 通知接口简介 ................................................................................................................... 22
4.2 补单机制 ........................................................................................................................... 22
4.3 通知接口参数 ................................................................................................................... 23
4.4 后台通知结果返回 ........................................................................................................... 27
4.5 后台通知签名方式 ........................................................................................................... 27
5.API 接口说明 ............................................................................................................................... 30
5.1API 接口简介 ..................................................................................................................... 30
5.2API 使用方式 ..................................................................................................................... 30
5.3API 列表 ............................................................................................................................. 30
5.3.1 发货通知 delivernotify ........................................................................................... 30
5.3.2 订单查询 orderquery ............................................................................................. 32
微信公众号支付接口文档 V2. 2
内部文档，请勿外传
1
1
1
1 .
.
.
. 微信支付简介
微信支付简介
微信支付简介
微信支付简介
1.1
1.1
1.1
1.1
功能简介
功能简介
功能简介
功能简介
微信支付，是基于微信客户端提供的支付服务功能。同时向商户提供销售经营分析 、 账
户和资金管理的技术支持 。 用户通过扫描二维码 、 点击图文消息进入商品页面购买等多种方
式调起微信支付模块完成支付。
目前微信支持公众号内支付 。 其中支付方式 ， 可以分为 JS API 支付 、 Native( 原生 ) 支付
。
商户可以结合业务场景，自主选择支付形式。
本文将全面介绍公众号支付技术解决方案。
1.2
1.2
1.2
1.2 支付账户
支付账户
支付账户
支付账户
商户向微信公众平台提交企业信息以及银行账户资料 ， 审核通过并签约后 ， 可以获得以
下帐户（包含财付通的相关支付资金账户 ） ，用于公众号支付。
帐号
帐号
帐号
帐号 作用
作用
作用
作用
appId
公众号身份标识。
appSecret
公众平台 API( 参考文档 API 接口 部分 ) 的权限获取所需密钥 Key ，在使用所
有公众平台 API 时，都需要先用它去换取 access_token ，然后再进行调用 。
paySignKey
公众号支付请求中用于加密的密钥
Key
， 可验证商户唯一身份 ，
PaySignKe y
对应于支付场景中的
appKey
值。
partnerId
财付通商户身份标识。
partnerKey
财付通商户权限密钥 Key 。
微信公众号支付接口文档 V2. 2
内部文档，请勿外传
注意 ： appSecret 、 paySignKey 、 partnerKey 是验证商户唯一性的安全标识 ， 请妥善保管 。
对于 appSecret 和 paySignKey 的区别，可以这样认为： appSecret 是 API 使用时的登录
密码，会在网络中传播的；而 paySignKey 是在所有支付相关数据传输时用于加密并进行身
份校验的密钥，仅保留在第三方后台和微信后台，不会在网络中传播。
1.3
1.3
1.3
1.3 支付方式
支付方式
支付方式
支付方式
公众号支付有 2 种方式：
JS
JS
JS
JS API
API
API
API 支付
支付
支付
支付 ：是指用户打开图文消息或者扫描二维码，在微信内置浏览器 打开网页进
行的支付 。 商户网页前端通过使用微信提供的 JS API ， 调用微信支付模块 。 这种方式 ， 适合
需要在商户网页进行选购下单的购买流程。
Native
Native
Native
Native （原生）支付
（原生）支付
（原生）支付
（原生）支付 ：是指商户组成符合 Native （原生）支付规则的 URL 链接，用户
可通过点击该链接或者扫描对应的二维码 直接 进入微信支付模块（微信客户端界面 ） ，即可
进行支付。这种方式，适合无需选购直接支付的购买流程。
以上两种支付方式 ， 最大的差别在于是否需要经过网页调起支付
最大的差别在于是否需要经过网页调起支付
最大的差别在于是否需要经过网页调起支付
最大的差别在于是否需要经过网页调起支付 。 以下是两种支付方式
的基本交互：
