当前位置：文档之家 › 【微信支付】微信公众号支付接口文档V3.3.7

【微信支付】微信公众号支付接口文档V3.3.7

  • 格式：pdf
  • 大小：1.67 MB
  • 文档页数：36

微信公众号支付接口文档(V3.3.7)目录微信公众号支付接口文档 (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)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.退款查询接口 (26)4.10.对账单接口 (28)4.11.短链接转换接口 (30)4.12.接口调用上报接口 (31)5.企业红包使用说明 (32)5.1创建批次企业红包 (32)5.2提交支付使用企业红包 (33)5.3查询使用企业红包金额 (33)5.4企业红包对账单 (33)6.错误码列表 (33)7.常见问题和注意事项 (34)7.1.常见基本概念疑惑 (34)7.2.常见错误现象及解决方法 (34)7.3.常见注意事项 (35)7.4.联系我们 (36)1.微信支付简介1.1.功能简介微信支付，是基于微信客户端提供的支付服务功能。

同时向商户提供销售经营分析、账户和资金管理的功能支持。

用户通过扫描二维码、微信内打开商品页面购买等多种方式调起微信支付模块完成支付。

微信支持公众号内支付，即基于公众号向用户收款，公众号相当于收款的商户。

其中支付方式，可以分为JS API（网页内）支付、Native（原生）支付。

商户可以结合业务场景，自主选择支付方式。

本文将全面介绍微信支付的技术方案。

1.2.支付账户商户向微信提交企业以及银行账户资料，商户功能审核通过后，可以获得以下帐户（包含财付通的商户账户），用于公众号支付。

帐号作用appId微信公众号身份的唯一标识。

审核通过后，在微信发送的邮件中查看。

Mchid商户ID，身份标识，在微信发送的邮件中查看。

Key商户支付密钥Key。

登录微信商户后台，进入栏目【账户设置】【密码安全】【API安全】【API密钥】，进入设置API密钥。

AppsecretJSAPI接口中获取openid，审核后在公众平台开启开发模式后可查看。

注意：支付密钥Key是验证商户唯一性的安全标识，请妥善保管，仅保留在第三方后台和微信后台，不会在网络中传播。

1.3.支付方式JS API（网页内）支付：是指用户打开图文消息或者扫描二维码，在微信内置浏览器打开网页进行的支付。

商户网页前端通过使用微信提供的JS API，调用微信支付模块。

这种方式，适合需要在商户网页进行选购下单的购买流程。

Native（原生）支付：是指商户组成符合Native（原生）支付规则的URL链接，用户可通过在会话中点击链接或者扫描对应的二维码直接进入微信支付模块（客户端界面），即可进行支付。

这种方式，适合无需选购直接支付的购买流程。

跟JSAPI最大的区别是不经过网页调起支付。

2.支付场景介绍2.1.网页内支付场景---JS API（网页内）支付接口商户已有H5商城网站，在微信内打开网页时，可以调用微信支付完成下单购买的流程。

步骤（1）：左图，商户下发图文消息或者通过自定义菜单吸引用户点击进入商户网页。

步骤（2）：右图，进入家网页，用户选择购买，完成选购流程。

步骤（3）：左图，调起微信支付控件，用户开始输入支付密码。

步骤（4）：右图，密码验证通过，支付成功。

商户后台得到支付成功的通知。

步骤（5）：左图，返回商户页面，显示购买成功。

该页面由商户自定义。

步骤（6）：右图，公众号下发消息，提示发货成功。

该步骤可选。

注意：商户也可以把商品网页的链接生成二维码，用户扫一扫打开后即可完成购买支付。

2.1.1.交互细节以下是支付场景的交互细节，请认真阅读，并设计商户页面的逻辑：（1）用户打开商户网页选购商品，发起支付，在网页通过JavaScript 调用getBrandWCPayRequest 接口，发起微信支付请求，用户进入支付流程。

（2）用户成功支付点击完成按钮后，商户的前端会收到JavaScript 的返回值。

商户可直接跳转到支付成功的静态页面进行展示。

（3）商户后台收到来自微信开放平台的支付成功回调通知，标志该笔订单支付成功。

注：（2）和（3）的触发不保证遵循严格的时序。

JS API 返回值作为触发商户网页跳转的标志，但商户后台应该只在收到微信后台的支付成功回调通知后，才做真正的支付成功的处理。

JS API 返回值目前只在支付成功时返回，后续版本将扩展返回值，以便商户做更多个性化的展示。

2.1.2.JSAPI支付时序图2.1.3.获取当前微信版本号由于微信5.0版本后才加入微信支付模块，低版本用户调用微信支付功能将无效。

因此，建议商户通过user agent来确定用户当前的版本号后再调用支付接口。

以iPhone版本为例，可以通过user agent可获取如下微信版本示例信息："Mozilla/5.0(iphone;CPU iphone OS 5_1_1 like Mac OS X) AppleWebKit/534.46(KHTML,like Geocko) Mobile/9B206 MicroMessenger/5.0"其中5.0为用户安装的微信版本号，商户可以判定版本号是否高于或者等于5.0。

2.1.4.显示微信安全支付标题对于商户具有支付权限且需要调用微信支付的页面，为了让用户增加购买信心，确认交易环境安全，微信强烈建议商户使用“微信安全支付”标题。

安全支付标题的如下图。

显示支付安全标题，需将原始链接添加上"showwxpaytitle=1"的尾串。

通过这种方式，商户的页面将出现微信安全支付的标识。

例如，原始URL 为：htp://,显示安全支付标题的URL 为：htp://?showwxpaytitle=1。

当用户在微信里打开 不会直接出现微信安全支付的标题，而打开htp://?showwxpaytitle=1后将出现微信安全支付标题。

2.2.线下扫码购买场景---Native （原生）支付接口2.2.1使用场景与网页内支付场景不同，部分商户不需要经过网页选购，可以直接下单购买。

步骤（1）：左图，商户根据微信支付的规则，为不同商品生成不同的二维码，张贴在各种场景，便于用户扫描购买。

步骤（2）：右图，用户使用微信扫描二维码后，获取商品信息，同时到商户后台下单。

步骤（3）：左图，用户开始支付，输入支付密码。

步骤（4）：右图，支付成功，商户后台得到通知，进行发货处理。

2.2.2.Native（原生）支付URL定义模式一：商户按固定格式生成链接二维码，用户扫码后调微信会将productid和用户openid发送到商户设置的链接上，商户收到请求生成订单，调用统一支付接口下单提交到微信，微信会返回给商户prepayid，时序图如下：对应链接：weixin://wxpay/bizpayurl?sign=XXXXX&appid=XXXXX&mch_id=XXXXX&product_id= XXXXXX &time_stamp=XXXXXX&nonce_str=XXXXX模式二：商户生成订单，先调用统一支付接口获取到code_url，此URL直接生成二维码，用户扫码后调起支付。

时序图如下：code_url对应链接：weixin://wxpay/bizpayurl?sr=XXXXX3.接口说明3.1.接口调用规则◆认证方式：HTTPS认证，退款和冲正接口调用需要商户证书(证书在审核邮件附件中)◆请求采用POST方式◆提交和返回结果采用XML格式◆字符集默认使用UTF-8，请勿使用其它字符集◆商户与微信之间的交互(特别是Native回调和支付通知回调)，都需要验证签名处理返回时先判断协议返回错误码，再判断业务返回错误码，最后判断交易状态3.2.Sign签名生成方法微信支付中将对数据里面的内容进行鉴权，确定携带的信息是真实、有效、合理的。

因此，这里将定义生成sign字符串的方法。

a.对所有传入参数按照字段名的ASCII码从小到大排序（字典序）后，使用URL键值对的格式（即key1=value1&key2=value2…）拼接成字符串string1，注意：值为空的参数不参与签名；b.在string1最后拼接上key=Key(商户支付密钥)得到stringSignTemp字符串，并对stringSignTemp进行md5运算，再将得到的字符串所有字符转换为大写，得到sign值signValue。

下面定义了一段生成sign字符串的示范过程：假设以下为package传入参数：appid=wxd930ea5d5a258f4fauth_code=123456body=testdevice_info=123mch_id=1900000109nonce_str=960f228109051b9969f76c82bde183acout_trade_no=1400755861spbill_create_ip=127.0.0.1total_fee=1key=8934e7d15453e97507ef794cf7b0519di：经过a过程URL键值对字典序排序后的字符串string1为：appid=wxd930ea5d5a258f4f&auth_code=123456&body=test&device_info=123&mch_id=1 900000109&nonce_str=960f228109051b9969f76c82bde183ac&out_trade_no=1400755861&spbil l_create_ip=127.0.0.1&total_fee=1ii：经过b过程后得到sign为：sign=md5(string1&key=8934e7d15453e97507ef794cf7b0519d).toUpperCase=md5(appid=wxd930ea5d5a258f4f&auth_code=123456&body=test&device_info=123&mch_id=1900000109&nonce_str=960f228109051b9969f76c82bde183ac&out_trade_no=1400755861 &spbill_create_ip=127.0.0.1&total_fee=1&key=8934e7d15453e97507ef794cf7b0519d).toUpper Case()="c380bec2bfd727a4b6845133519f3ad6".toUpperCase()="C380BEC2BFD727A4B6845133519F3AD6"3.3.代码实例接口调用实例，以开发为例说明数据提交和返回的具体格式：提交数据：<xml><appid>wx2421b1c4370ec43b</appid><attach><![CDATA[att1]]></attach><body><![CDATA[JSAPI支付测试]]></body><device_info>1000</device_info><mch_id>10000100</mch_id><nonce_str>b927722419c52622651a871d1d9ed8b2</nonce_str><notify_url>/pub_v2/pay/notify.php</notify_url><out_trade_no>1405713376</out_trade_no><spbill_create_ip>127.0.0.1</spbill_create_ip><total_fee>1</total_fee><trade_type>JSAPI</trade_type><sign><![CDATA[3CA89B5870F944736C657979192E1CF4]]></sign></xml>协议级错误返回：<xml><return_code><![CDATA[FAIL ]]></return_code><return_msg><![CDA TA[SYSERR]]></return_msg></xml>正确返回数据：<xml><return_code><![CDATA[SUCCESS]]></return_code><return_msg><![CDA TA[OK]]></return_msg><appid><![CDA TA[wx2421b1c4370ec43b]]></appid><mch_id><![CDATA[10000100]]></mch_id><device_info><![CDATA[1000]]></device_info><nonce_str><![CDA TA[FvYSnPuFFPkAr77M]]></nonce_str><sign><![CDATA[63238039D6E43634297CF2A6EB5F3B72]]></sign><result_code><![CDA TA[SUCCESS]]></result_code><openid><![CDATA[oUpF8uN95-Ptaags6E_roPHg7AG0]]></openid><is_subscribe><![CDATA[Y]]></is_subscribe><trade_type><![CDATA[JSAPI]]></trade_type><bank_type><![CDATA[CCB_CREDIT]]></bank_type><total_fee>1</total_fee><coupon_fee>0</coupon_fee><fee_type><![CDATA[CNY]]></fee_type><transaction_id><![CDATA[1008450740201407220000058756]]></transaction_id><out_trade_no><![CDA TA[1406033828]]></out_trade_no><attach><![CDATA[att]]></attach><time_end><![CDATA[20140722160655]]></time_end></xml>业务级错误返回：<xml><return_code><![CDATA[SUCCESS]]></return_code><return_msg><![CDA TA[OK]]></return_msg><appid><![CDA TA[wx2421b1c4370ec43b]]></appid><mch_id><![CDATA[10000100]]></mch_id><device_info><![CDATA[1000]]></device_info><nonce_str><![CDA TA[sthBJ9QyUG6vkrjJ]]></nonce_str><sign><![CDATA[6277A96D7875D4FF23AA7B6A4C3046AB]]></sign><result_code><![CDA TA[FAIL]]></result_code><err_code><![CDATA[PAYERROR]]></err_code><err_code_des><![CDATA[支付错误]]></err_code_des></xml>4.API说明4.1.统一支付接口URL地址：https:///pay/unifiedorder统一支付接口，可接受JSAPI/NATIVE/APP下预支付订单，返回预支付订单号。

合集下载

微信支付API文档120(受理)

微信支付API文档120(受理)

1. 阅读对象本文阅读对象：商户系统（在线购物平台、人工收银系统、自动化智能收银系统或其他）集成微信支付涉及的技术架构师，研发工程师，测试工程师，系统运维工程师。

2. 术语1. 支付模式1) 被扫支付被扫支付是用户展示微信上“我的刷卡条码/二维码”给商户系统扫描后直接完成支付的模式。

主要应用线下面对面收银的场景。

2) 扫码支付扫码支付是商户系统按微信支付协议生成支付二维码，用户再用微信“扫一扫”完成支付的模式。

该模式适用于P C 网站支付、实体店单品或订单支付、媒体广告支付等场景。

3) 微信内网页支付微信内网页支付是用户在微信中打开商户的H5 页面，商户在H5 页面通过调用微信支付提供的JSAPI 接口调起微信支付模块完成支付。

应用场景有：•用户在微信公众账号内进入商家公众号，打开某个主页面，完成支付；•用户的好友在朋友圈、聊天窗口等分享商家页面连接，用户点击链接打开商家页面，完成支付•将商户页面转换成二维码，用户扫描二维码后在微信浏览器中打开页面后完成支付4) APP 支付APP 支付又称移动端支付，是商户通过在移动端应用APP 中集成开放SDK 调起微信支付模块完成支付的模式。

5) 普通浏览器网页支付模式正在建设中，敬请期待。

2. 名词解释1) 微信公众平台微信公众平台是微信公众账号申请入口和管理后台。

商户可以在公众平台提交基本资料、业务资料、财务资料申请开通微信支付功能。

平台入口：。

2) 微信开放平台微信开放平台是商户APP 接入微信支付开放接口的申请入口，通过此平台可申请微信APP 支付。

平台入口：。

3) 微信商户平台微信商户平台是微信支付相关的商户功能集合，包括参数配置、支付数据查询与统计、在线退款、代金券或立减优惠运营等功能。

平台入口：。

4) 微信支付系统微信支付系统是指完成微信支付流程中涉及的API 接口、后台业务处理系统、账务系统、回调通知等系统的总称。

5) 商户收银系统商户收银系统即商户的POS 收银系统，是录入商品信息、生成订单、客户支付、打印小票等功能的系统。

【微信公众号支付】收货地址共享接口文档V1.4

【微信公众号支付】收货地址共享接口文档V1.4

收货地址共享接口文档V1.41 收货地址共享简介1.1 功能简介微信收货地址共享，是指用户在微信浏览器内打开商品H5 网页，填写过地址，后续支持快速选择免填写，也可增加和编辑。

此地址为用户属性，可在商户网页中共享使用。

支持原生控件填写地址，地址数据会传递到商户后台。

1.2 功能支持地址共享是基于微信JS API 实现，只能在微信内置浏览器中使用，其他浏览器调用无效。

同时，需要微信5.0 版本才能支持，建议通过user agent 来确定用户当前的版本号后再调用地址接口。

以iPhone 版本为例，可以通过user agent可获取如下微信版本示例信息："Mozilla/5.0(iphone;CPU iphone OS 5_1_1 like Mac OS X)AppleWebKit/534.46(KHTML,like Geocko) Mobile/9B206MicroMessenger/5.0"其中5.0 为用户安装的微信版本号，商户可以判定版本号是否高于或者等于5.0。

1.3 地址格式微信地址共享使用的数据字段包括：- 收货人姓名- 地区，省市区三级- 详细地址- 邮编- 联系电话其中，地区对应是国标三级地区码，如“广东省-广州市-天河区”，对应的是510630。

详情参考：HYPERLINK"/tjbz/xzqhdm/t20130118_402867249.html"2 公众号收货地址JS API 接口定义2.1 编辑并获取收货地址公众号编辑收货地址editAddress参数列表说明：addrSign 的生成规则如下。

参与addrSign 签名的字段包括：appId、url（当前网页url）、timestamp、noncestr、accessToken（用户授权凭证，请参照oauth2.0 协议获取）。

这里scope、signType 并不参与签名。

对所有待签名参数按照字段名的ASCII 码从小到大排序（字典序）后，使用URL 键值对的格式（即key1=value1&key2=value2…）拼接成字符串string1。

微信支付接入流程

微信支付接入流程

微信支付接入流程
1：公众平台开发配置：1).支付授权目录（微信公众平台=>>微信支付=>>支付授权目录）支付授权目录配置说明：如果使用总部代收，则可以忽略，不用设置。

如果使用自己的公众号支付,需要填写:/payway/wxorderpay/ 如下图
2).网页授权接口（微信公众平台=>>开发者中心=>>网页授权获取用户基本信息）
网页授权信息填写内容： 如下图
2.微信支付商户号：10位（微信支付申请审核通过后，会往注册邮箱发送邮件，邮件内容里查看）
3.设置API密钥：32位（登录微信商户平台,账户设置=>>API安全=>>设置密钥）如下图
APPID ：获取地址（微信公众平台=>> 开发=>>基本设置）如下图
4.AppSecret（微信公众平台=>> 开发=>>基本设置）如上图
5.支付接口配置（获取以上支付接口信息后，进入城市站管理平台 =>> 财务账户管理=>> 网上支付设置=>> 微信支付设置）填写相关信息如下图。

wxpay-payment-api

wxpay-payment-api

微信公众号支付接口文档V2.22V2.（内部文档，请勿外传）1.微信支付简介 (4)1.1功能简介 (4)1.2支付账户 (4)1.3支付方式 (5)1.4测试帐号 (6)2.JS API支付接口 (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)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)1.微信支付简介1.1功能简介微信支付，是基于微信客户端提供的支付服务功能。

同时向商户提供销售经营分析、账户和资金管理的技术支持。

用户通过扫描二维码、点击图文消息进入商品页面购买等多种方式调起微信支付模块完成支付。

目前微信支持公众号内支付。

其中支付方式，可以分为JS API支付、Native(原生)支付。

商户可以结合业务场景，自主选择支付形式。

本文将全面介绍公众号支付技术解决方案。

1.2支付账户商户向微信公众平台提交企业信息以及银行账户资料，审核通过并签约后，可以获得以下帐户（包含财付通的相关支付资金账户），用于公众号支付。