开发指引

为了在保证支付安全的前提下,带给商户简单、一致且易用的体验,我们推出了全新的微信支付3接口。该版本的具体规则请参考3接口规则。

者应当依据自身的编程语言来构建并配置相应的环境。 2.2.1. 账申请指引 小程序开通微信支付,即申请或复用微信支付商户,申请完小程序后,登录小程序后台 。点击左侧导航栏的微信支付,在页面中进行开通。(开通申请要求小程序已发布上线) 点击开通按钮后,有2种方式可以获取微信支付能力,新申请微信支付商户或绑定一个已有的微信支付商户,请根据你的业务需要和具体情况选择,只能二选一。开通指引

小程序访问商户服务都是通过,部署的时候需要服务器。

服务器域名配置。 每个微信小程序需要事先设置通信域名,小程序只可以跟指定的域名进行网络通信。包括普通 请求(.)、上传文件(.)、下载文件(.)和 通信(.) 从基础库 2.4.0 开始,网络接口允许与局域网 通信,但要注意 不允许与本机 通信

重点步骤说明:

步骤4: 用户下单发起支付,商户可通过下单创建支付订单。

步骤9: 商户小程序内使用小程序调起支付(.)发起微信支付,详见小程序文档 。

步骤16: 用户支付成功后,商户可接收到微信支付支付结果通知支付通知。

步骤21: 商户在没有接收到微信支付结果通知的情况下需要主动调用查询订单查询支付结果。

本章节展示了如何使用微信支付服务端 快速接入小程序支付产品,完成与微信支付对接的部分。 3.2.1. 【服务端】小程序下单

步骤说明:

用户通过商户小程序进入商户网页,当用户选择相关商品购买时,商户系统先调用该接口在微信支付服务后台生成预支付交易单。

重要入参说明: __: 商户系统内部订单,只能是数字、大小写字母_-且在同一个商户下唯一。 : 商品描述。 _: 支付回调通知,该地址必须为直接可访问的,不允许携带查询串。 : 订单总金额,单位为分。 : 是微信用户在下的唯一用户标识(不同,则获取到的就不同),可用于永久标记一个用户。获取方式请参考以下文档小程序获取 、公众获取 、获取 。

更多参数、响应详情及错误码请参见下单接口文档。 3.2.2.【客户端】小程序调起支付

步骤说明: 通过下单成功获取预支付交易会话标识(_) 后,需要通过调起支付来调起微信支付收银台。

重要入参说明: : 下单接口返回的_参数值,提交格式如:_=。 : 该接口3版本仅支持。 : 签名。

生成规则、响应详情及错误码请参见 小程序调起支付接口文档。 3.2.3. 【服务端】接收支付结果通知

步骤说明: 当用户完成支付,微信会把相关支付结果将通过异步回调的方式通知商户,商户需要接收处理,并按文档规范返回应答

更多参数、响应详情及错误码请参见 支付结果通知接口文档。 3.2.4. 【服务端】查询订单

步骤说明: 当商户后台、网络、服务器等出现异常,商户系统最终未接收到支付通知时,商户可通过查询订单接口核实订单支付状态。

示例代码(通过微信订单查询):

更多参数、响应详情及错误码请参见 微信支付订单/商户订单接口文档。 3.2.5. 【服务端】关闭订单

步骤说明: 当商户订单支付失败需要生成新单重新发起支付,要对原订单调用关单,避免重复支付;系统下单后,用户支付超时,系统退出不再受理,避免用户继续,请调用关单接口。

更多参数、响应详情及错误码请参见 关闭订单接口文档 3.2.6. 【服务端】申请交易账单

步骤说明: 微信支付按天提供交易账单文件,商户可以通过该接口获取账单文件的下载地址。

更多参数、响应详情及错误码请参见 申请交易账单接口文档。 3.2.7. 【服务端】下载账单

步骤说明: 申请交易账单接口获取到账单下载地址(_)后,再通过该接口获取到对应的账单文件,文件内包含交易相关的金额、时间、营销等信息,供商户核对订单、退款、银行到账等情况。

更多参数、响应详情及错误码请参见 下载账单接口文档。

:在小程序内通过外部5页面调起支付报错。

:请按以下几点进行排查: 请检查请求参数是否正确,如请求参数中的是否与小程序对应。 对应的小程序是否有开通小程序支付功能,权限状态是否正常,可登录商户平台核实。 与商户是否存在绑定关系,可登录商户平台核实。

:可通过以下两种方式开通: 绑定已有公众的微信支付:耗时10分钟即可,只需原有公众开通微信支付,小程序微信支付可以选择绑定原来的微信支付商户,即可开通成功。 新申请微信支付:耗时需要1-5个工作日,需要提交和申请小程序一样的资料进行审核,审核通过后才能开通成功。

© 版权声明
THE END
分享