微信支付开发demo 微信支付接入指引 公众号支付接口统一下单API 一站式开发服务 现成代码 2~3天即可上线

简体   繁體 字体:

1.  微信公众号支付场景介绍

2.  微信公众号支付开发步骤 / 接入指南

3.  微信公众号支付业务流程时序图

4.  微信公众号支付WeixinJSBridge参数说明及示例代码

5.  微信支付商户系统帐号参数说明

6.  微信支付协议规则和安全规范

7.  微信支付验收指引 / 验收指南

8.  联系我们

微信公众号开发文档: https://www.cloudagiles.com/weixin-gongzhonghao-platform-develop-api/

微信扫码登录网页开发文档: https://www.cloudagiles.com/weixin-scan-qr-code-login-website/

微信移动客服系统开发文档: https://www.cloudagiles.com/weixin-gongzhonghao-mobile-customer-service-system/

 

咨询电话:0755 – 3635 7758      开发费用:欢迎来电洽谈      上线时间: 2~3天


1. 微信公众号支付场景介绍

公众号支付是用户在微信中打开商户的H5页面,商户在H5页面通过调用微信支付提供的JSAPI接口调起微信支付模块完成支付。应用场景有:

◆ 用户在微信公众账号内进入商家公众号,打开某个主页面,完成支付

◆ 用户的好友在朋友圈、聊天窗口等分享商家页面连接,用户点击链接打开商家页面,完成支付

◆ 将商户页面转换成二维码,用户扫描二维码后在微信浏览器中打开页面后完成支付

场景以微信公众号支付为例来介绍:

用户通过消息或扫描二维码在微信内打开网页时,可以调用微信支付完成下单购买的流程。

步骤(1): 商户下发图文消息或者通过自定义菜单吸引用户点击进入商户网页

微信支付示例

 

步骤(2): 进入商户网页,用户选择购买,完成选购流程

微信支付示例

 

步骤(3): 调起微信支付控件,用户开始输入支付密码

微信支付示例

 

步骤(4): 密码验证通过,支付成功。商户后台得到支付成功的通知

微信支付示例

 

步骤(5): 返回商户页面,显示购买成功。该页面由商户自定义

微信支付示例

 

步骤(6): 公众号下发消息,提示发货成功(该步骤可选)

微信支付示例

 

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

手机端与后台服务器之间的交互细节:

以下是支付场景的交互细节,设计商户页面的逻辑:

(1)用户打开商户网页选购商品,发起支付,在网页通过JavaScript调用getBrandWCPayRequest接口,发起微信支付请求,用户进入支付流程。

(2)用户成功支付点击完成按钮后,商户的前端会收到JavaScript的返回值。商户可直接跳转到支付成功的静态页面进行展示。

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

注意:(2)和(3)的触发不保证遵循严格的时序。JS API返回值作为触发商户网页跳转的标志,但商户后台应该只在收到微信后台的支付成功回调通知后,才做真正的支付成功的处理。

 

咨询电话:0755 – 3635 7758      开发费用:欢迎来电洽谈      上线时间: 2~3天


2. 微信公众号支付开发步骤 / 接入指南

步骤(1): 设置支付目录

在微信公众平台设置您的公众号支付支付目录,设置路径见下图。公众号支付在请求支付的时候会校验请求来源是否有在公众平台做了配置,所以必须确保支付目录已经正确的被配置,否则将验证失败,请求支付不成功。

微信支付开发步骤

 

步骤(2): 设置授权域名

开发公众号支付时,在统一下单接口中要求必传用户openid,而获取openid则需要您在公众平台设置获取openid的域名,只有被设置过的域名才是一个有效的获取openid的域名,否则将获取失败。

微信支付开发步骤

 

步骤(3): 验证域名是否工作正常(填写的域名必须已经完成ICP备案

将验证文件MP_verify_***********.txt文件上传到自己的Web服务器相应的域名目录下,同时设置好该文件的正确访问权限。接着,就可点击“确认”按钮来验证是否通过。

微信支付开发步骤

 

咨询电话:0755 – 3635 7758      开发费用:欢迎来电洽谈      上线时间: 2~3天


3. 微信公众号支付业务流程时序图

 

微信支付业务流程时序图

 

商户后台服务器系统和微信支付系统之间主要交互所要完成的动作:

(1)商户后台server调用统一下单接口请求订单

(2)商户后台server接收支付通知

(3)商户后台server查询支付结果

 

咨询电话:0755 – 3635 7758      开发费用:欢迎来电洽谈      上线时间: 2~3天


4. 微信公众号支付WeixinJSBridge参数说明及示例代码

在微信浏览器里面打开H5 Web网页中执行JS调起支付(接口输入输出数据格式为JSON)。

注意:WeixinJSBridge内置对象在其他浏览器中无效。

 

WeixinJSBridge对象参数以及返回值说明表:

名称 变量名 必填 类型 示例值 描述
公众号id appId String(16) wx8888888888888888 商户注册具有支付权限的公众号成功后即可获得
时间戳 timeStamp String(32) 1414561699 当前的时间
随机字符串 nonceStr String(32) 5K8264ILTKCH16CQ2502SI8ZNMTM67VS 随机字符串,不长于32位
订单详情扩展字符串 package String(128) prepay_id=123456789 统一下单接口返回的prepay_id参数值,提交格式如:prepay_id=***
签名方式 signType String(32) MD5 签名算法,暂支持MD5
签名 paySign String(64) C380BEC2BFD727A4B6845133519F3AD6 签名

 

支付接口err_msg返回结果值说明表:

返回值 描述
get_brand_wcpay_request: ok 支付成功
get_brand_wcpay_request: cancel 支付过程中用户取消
get_brand_wcpay_request: fail 支付失败

 

注意:JS API的返回结果get_brand_wcpay_request: ok 仅在用户成功完成支付时返回。由于前端交互复杂,get_brand_wcpay_request: cancel 或者 get_brand_wcpay_request: fail 可以统一处理为用户遇到错误或者主动放弃,不必细化区分。

微信公众号支付示例代码如下:

1  function onBridgeReady() {
2  WeixinJSBridge.invoke(
3   ‘getBrandWCPayRequest’, {
4        ”appId”: “wx2421b1c4370ec43b”,     //公众号名称,由商户传入
5        ”timeStamp”: “1395712654″,           //时间戳,自1970年以来的秒数
6        ”nonceStr”: “e61463f8efa94090b1f366cccfbbb444″, //随机串
7        ”package”: “prepay_id=u802345jgfjsdfgsdg888″,
8        ”signType”: “MD5″,         //微信签名方式
9        ”paySign”: “70EA570631E4BB79628FBCA90534C63FF7FADD89″ //微信签名
10   },
11  function(res) {
12  if(res.err_msg == ”get_brand_wcpay_request:ok” ) {}
13  }
14  );
15  }
16  if (typeof WeixinJSBridge == ”undefined”) {
17   if( document.addEventListener ) {
18         document.addEventListener(‘WeixinJSBridgeReady’, onBridgeReady, false);
19   } else if (document.attachEvent) {
20        document.attachEvent(‘WeixinJSBridgeReady’, onBridgeReady);
21        document.attachEvent(‘onWeixinJSBridgeReady’, onBridgeReady);
22   }
23  } else {
24        onBridgeReady();
25  }

 

咨询电话:0755 – 3635 7758      开发费用:欢迎来电洽谈      上线时间: 2~3天


5. 微信支付商户系统帐号参数说明

商户在微信公众平台(申请扫码支付、公众号支付)或开放平台(申请APP支付)按照相应提示,申请相应微信支付模式。微信支付工作人员审核资料无误后开通相应的微信支付权限。微信支付申请审核通过后,商户在申请资料填写的邮箱中收取到由微信支付小助手发送的邮件,此邮件包含开发时需要使用的支付账户信息:

邮件中参数 API参数名 详细说明
APPID appid appid是微信公众账号或开放平台APP的唯一标识,在公众平台申请公众账号或者在开放平台申请APP账号后,微信会自动分配对应的appid,用于标识该应用。可在微信公众平台–>开发–>基本配置里面查看,商户的微信支付审核通过邮件中也会包含该字段值。
微信支付商户号 mch_id 商户申请微信支付后,由微信支付分配的商户收款账号。
API密钥 key 交易过程生成签名的密钥,仅保留在商户系统和微信支付后台,不会在网络中传播。商户妥善保管该Key,切勿在网络中传输,不能在其他客户端中存储,保证key不会被泄漏。商户可根据邮件提示登录微信商户平台进行设置。也可按一下路径设置:微信商户平台(pay.weixin.qq.com)–>账户中心–>账户设置–>API安全–>密钥设置
Appsecret secret AppSecret是APPID对应的接口密码,用于获取接口调用凭证access_token时使用。在微信支付中,先通过OAuth2.0接口获取用户openid,此openid用于微信内网页支付模式下单接口使用。可登录公众平台–>微信支付,获取AppSecret(需成为开发者且帐号没有异常状态)。

 

咨询电话:0755 – 3635 7758      开发费用:欢迎来电洽谈      上线时间: 2~3天


6. 微信支付协议规则和安全规范

(1)商户接入微信支付,调用API必须遵循以下协议规则:

传输方式 为保证交易安全性,采用HTTPS传输
提交方式 采用POST方法提交
数据格式 提交和返回数据都为XML格式,根节点名为xml
字符编码 统一采用UTF-8字符编码
签名算法 MD5,后续会兼容SHA1、SHA256、HMAC等。
签名要求 请求和接收数据均需要校验签名,详细方法请参考安全规范-签名算法
证书要求 调用申请退款、撤销订单接口需要商户证书
判断逻辑 先判断协议字段返回,再判断业务返回,最后判断交易状态

 

(2)安全规范

① 签名生成的通用步骤如下:

第一步

设所有发送或者接收到的数据为集合M,将集合M内非空参数值的参数按照参数名ASCII码从小到大排序(字典序),使用URL键值对的格式(即key1=value1&key2=value2…)拼接成字符串stringA。

特别注意以下重要规则:

◆ 参数名ASCII码从小到大排序(字典序);

◆ 如果参数的值为空不参与签名;

◆ 验证调用返回或微信主动通知签名时,传送的sign参数不参与签名,将生成的签名与该sign值作校验

◆ 微信接口可能增加字段,验证签名时必须支持增加的扩展字段

第二步

在stringA最后拼接上key得到stringSignTemp字符串,并对stringSignTemp进行MD5运算,再将得到的字符串所有字符转换为大写,得到sign值signValue。

◆ key设置路径:微信商户平台(pay.weixin.qq.com)–>账户设置–>API安全–>密钥设置

举例:

假设传送的参数如下:

appid: wxd930ea5d5a258f4f

mch_id: 10000100

device_info: 1000

body: test

nonce_str: ibuaiVcKdpRxkhJA

 

Step1:对参数按照key=value的格式,并按照参数名ASCII字典序排序如下:

stringA=”appid=wxd930ea5d5a258f4f&body=test&device_info=1000&mch_id=10000100&nonce_str=ibuaiVcKdpRxkhJA”;

 

Step2:拼接API密钥:

stringSignTemp=stringA+”&key=192006250b4c09247ec02edce69f6a2d” //注:key为商户平台设置的密钥key

sign=MD5(stringSignTemp).toUpperCase()=”9A0A8659F005D6984697E2CA0A9CF3B7″ //注:MD5签名方式

sign=hash_hmac(“sha256″,stringSignTemp,key) //注:HMAC-SHA256签名方式

 

最终得到,最终发送的数据:

<xml>

<appid>wxd930ea5d5a258f4f</appid>

<mch_id>10000100</mch_id>

<device_info>1000</device_info>

<body>test</body>

<nonce_str>ibuaiVcKdpRxkhJA</nonce_str>

<sign>9A0A8659F005D6984697E2CA0A9CF3B7</sign>

</xml>

 

 生成随机数算法

微信支付API接口协议中包含字段nonce_str,主要保证签名不可预测。我们推荐生成随机数算法如下:调用随机数函数生成,将得到的值转换为字符串。

③ 商户证书

❶ 获取商户证书

微信支付接口中,涉及资金回滚的接口会使用到商户证书,包括退款、撤销接口。商家在申请微信支付成功后,收到的相应邮件后,可以按照指引下载API证书,也可以按照以下路径下载:微信商户平台(pay.weixin.qq.com)–>账户中心–>账户设置–>API安全–>证书下载 。

证书文件有四个,分别说明如下:

证书附件 描述 使用场景 备注
pkcs12格式
(apiclient_cert.p12)
包含了私钥信息的证书文件,为p12(pfx)格式,由微信支付签发给您用来标识和界定您的身份 撤销、退款申请API中调用 windows上可以直接双击导入系统,导入过程中会提示输入证书密码,证书密码默认为您的商户ID(如:10010000)

 

以下两个证书在PHP环境中使用:

证书附件 描述 使用场景 备注
CA证书
(rootca.pem)
微信支付api服务器上也部署了证明微信支付身份的服务器证书,您在使用api进行调用时也需要验证所调用服务器及域名的真实性 该文件为签署微信支付证书的权威机构的根证书,可以用来验证微信支付服务器证书的真实性 部分工具已经内置了若干权威机构的根证书,无需引用该证书也可以正常进行验证,这里提供给您在未内置所必须根证书的环境中载入使用
证书pem格式
(apiclient_cert.pem)
从apiclient_cert.p12中导出证书部分的文件,为pem格式,请妥善保管不要泄漏和被他人复制 PHP等不能直接使用p12文件,而需要使用pem,为了方便您使用,已为您直接提供 您也可以使用openssl命令来自己导出:openssl pkcs12 -clcerts -nokeys -in apiclient_cert.p12 -out apiclient_cert.pem
证书密钥pem格式
(apiclient_key.pem)
从apiclient_key.pem中导出密钥部分的文件,为pem格式 PHP等不能直接使用p12文件,而需要使用pem,为了方便您使用,已为您直接提供 您也可以使用openssl命令来自己导出:openssl pkcs12 -nocerts -in apiclient_cert.p12 -out apiclient_key.pem

 

❷ 使用商户证书

◆ apiclient_cert.p12是商户证书文件,除PHP外的开发均使用此证书文件。

◆ 商户如果使用.NET环境开发,请确认Framework版本大于2.0,必须在操作系统上双击安装证书apiclient_cert.p12后才能被正常调用。

◆ 商户证书调用或安装都需要使用到密码,该密码的值为微信商户号(mch_id)

◆ PHP开发环境请使用商户证书文件apiclient_cert.pem和apiclient_key.pem ,rootca.pem是CA证书。

❸ 商户证书安全

证书文件不能放在web服务器虚拟目录,应放在有访问权限控制的目录中,防止被他人下载。商户服务器要做好病毒和木马防护工作,不被非法侵入者窃取证书文件。

 商户回调API安全

在普通的网络环境下,HTTP请求存在DNS劫持、运营商插入广告、数据被窃取,正常数据被修改等安全风险。商户回调接口使用HTTPS协议可以保证数据传输的安全性。所以微信支付建议商户提供给微信支付的各种回调采用HTTPS协议。

 

咨询电话:0755 – 3635 7758      开发费用:欢迎来电洽谈      上线时间: 2~3天


7. 微信支付验收指引 / 验收指南

(1)概述

为保证商户接入质量,提升交易安全及用户体验,微信支付的合作服务商在正式上线交易前,必须先根据本文指引完成验收。验收完成后,服务商在验收公众平台(微信号:WXPayAssist)提交验收通过申请,审核通过后,才能开通相应的支付权限(如:刷卡支付)。否则,请根据审核驳回提示,重新完成验收。

(2)仿真测试系统

为降低商户测试门槛,微信支付团队开发了一套独立的仿真测试系统。该系统根据验收用例金额的不同返回不同的响应报文,以满足商户正常功能测试、安全/异常测试及性能测试的需求。

微信支付仿真测试系统

为微信支付仿真测试系统(后简称仿真系统)的简化原理图。仿真系统的API协议与正式API完全相同(API接口文档)。商户开发者只需将正式API的调用URL增加一层sandboxnew路径,即可对接到仿真系统。

例如,刷卡支付URL:https://api.mch.weixin.qq.com/pay/micropay

变更为:https://api.mch.weixin.qq.com/sandboxnew/pay/micropay。

仿真系统与生产环境完全独立,包括存储层。商户在仿真系统所做的所有交易(如下单、支付、查询)均为无资金流的假数据,即:用户无需真实扣款,商户也不会有资金入账。代金券同理,沙箱环境中无需商户真实制券与发券,亦不会出现真实扣券情况。验收仿真测试系统的API验签密钥需从API获取:

获取验签秘钥API:

请求Url https://api.mch.weixin.qq.com/sandboxnew/pay/getsignkey
是否需要证书
请求方式 POST

 

请求参数:

字段名 字段 必填 示例值 类型 说明
商户号 mch_id 1305638280 String(32) 微信支付分配的微信商户号
随机字符串 nonce_str 5K8264ILTKCH16CQ2502SI8ZNMTM67VS String(32) 随机字符串,不长于32位
签名 sign 5K8264ILTKCH16CQ2502SI8ZNMTM67VS String(32) 签名值

 

返回参数:

字段名 字段 必填 示例值 类型 说明
返回状态码 return_code SUCCESS String(16) SUCCESS/FAIL 此字段是通信标识,非交易标识
返回信息 return_msg 签名失败 String(128) 返回信息,如非空,为错误原因 ,签名失败 ,参数格式校验错误

 

以下字段在return_code 为SUCCESS的时有返回。

字段名 字段 必填 示例值 类型 说明
商户号 mch_id 1305638280 String(32) 微信支付分配的微信商户号
沙箱密钥 sandbox_signkey 013467007045764 String(32) 返回的沙箱密钥

 

商户接入仿真系统的交互流程示例:

1. 商户发起刷卡支付请求,使用POST方式调用 https://api.mch.weixin.qq.com/sandboxnew/pay/micropay

2. 带sandboxnew 的https请求会被nginx路由到仿真系统。仿真系统根据支付金额(total_fee字段)返回预期报文给商户。同时,落地该笔请求数据;

3. 商户发起查单,调用 https://api.mch.weixin.qq.com/sandboxnew/pay/orderquery,带上微信订单号(transaction_id)或商户内部单号(out_trade_no);

4. 仿真系统收到查单请求后,根据单号及金额返回预期的查单结果给商户;

5. 商户下载对账单,调用 https://api.mch.weixin.qq.com/sandboxnew/pay/downloadbill,仿真系统返回固定的账单格式给商户。注:账单内容不一定与商户在仿真系统产生的交易完全相同。

(3)验收流程

微信支付商户接入验收流程

商户在收到微信支付审核通过的邮件后,即可用邮件中提供的开发者信息,启动测试验收工作。

验收开始后,验收负责人可按照下表步骤操作:

步骤 准备项 说明
1 商户通过审核,收到审核通过的邮件。邮件中包含了商户的MCHID、APPID及密码等开发者信息。
2 测试硬件全部到位,且被测的APP已被成功安装在硬件。 1、APP支付:测试手机(安卓/IOS/winphone)1台,被测app及微信已安装2、公众支付:测试手机(安卓/IOS/winphone)1台,微信已安装且已关注被测公众号3、刷卡支付:被测app已被安装至收银台平板,机具或扫码枪功能正常4、扫码支付:联网PC一台,且网站已接入微信支付功能;手机1台,已安装微信
3 关注公众号“微信支付商户接入验收助手”( 微信号: WXPayAssist),在验收case栏,选择本次接入的支付类型,如刷卡支付,即可看到全部验收用例。
4 修改代码或配置中所有微信支付api的链接,对接仿真系统。 例如:刷卡支付现网的apihttps://api.mch.weixin.qq.com/pay/micropay变更为:https://api.mch.weixin.qq.com/sandboxnew/pay/micropay
5 严格按照用例的顺序、金额执行用例,确保用例的检查点完全符合预期。 注意:用例分必选和可选。必选是一定要验的,否则会直接导致验收审核不通过;可选是建议商户要做的,但不验也不会影响验收结果。
6 全部用例测试通过后,商户在公众号“我的验收”里提交验收通过申请。微信支付团队将在3个工作日内完成验收审核。 验收审核通过后,商户会收到邮件通知,相关支付权限开通,可正式上线交易;对于验收不通过的原因,可在公众号“我的验收”里查询验收详细结果,对未通过的case回归测试。

 


8. 联系我们

 咨询电话:0755 – 3635 7758     

 开发费用:欢迎来电洽谈,价格合理

 上线时间: 2~3天

 现成代码,可到现场讲解现场调试,解除您的后顾之忧。

 

微信公众号开发文档: https://www.cloudagiles.com/weixin-gongzhonghao-platform-develop-api/

微信扫码登录网页开发文档: https://www.cloudagiles.com/weixin-scan-qr-code-login-website/

微信移动客服系统开发文档: https://www.cloudagiles.com/weixin-gongzhonghao-mobile-customer-service-system/

 

关键词: , , , , , , , , , , , , , , , , , , , , , , ,