开发指引

更新时间:2025.04.17

1、开发前准备

1.1、设置安全联系人

微信支付日常安全监测发现技术异常时,会向安全联系人和超级管理员发送风险提醒。请商户超级管理员尽快设置技术同事为安全联系人,确保能及时接收异常信息评估业务风险,详见安全联系人设置指引

1.2、熟悉微信支付接口规则

正式进入开发前,开发者需要先阅读基本规则开发参数申请和配置了解调用微信支付接口的基本规则和签名规则。

1.3、准备开发参数

在发起接口请求时,开发者还需传入一些必要参数,如服务商商户号、子商户号(也叫特约商户号)、sp_appid、证书私钥、公钥等,获取方式详见:服务商模式开发必要参数说明

2、整体业务开发流程概览

注意:

  • 如果用户选择的是非微信分付支付,时序与普通支付的流程一致

  • 微信分付支付不支持H5支付和Native支付方式

用户选择微信分付支付的时序图如下所示,在当前接入微信支付的时序上新增1个交互接口,修改1个交互接口,以红线标识。

  1. 当用户查看商品详情页时,商户系统会查询微信支付系统以获取支付方式的曝光建议(步骤1.3),根据结果决定是否前置曝光支付方式,并获取曝光凭证market_exposure_token

  2. 用户选择微信分付支付方式付款,商户系统调用微信支付系统下单(步骤1.7,参考JSAPI/小程序下单,APP下单),获取预支付交易会话标识prepay_id

  3. 商户在调起微信支付(步骤1.9,参考JSAPI调起支付小程序调起支付APP调起支付)时,需通过一个扩展参数传递用户选择的支付方式,具体传参规则如下:

    • JSAPI支付和小程序支付场景:参数package为prepay_id=*&subsidy_period_type=DAILY&market_exposure_token=*,其中prepay_id的值传下单接口获取的“预支付交易会话标识”,subsidy_period_type传固定值“DAILY”,market_exposure_token的值传支付方式前置曝光接口获取的曝光凭证。

    • APP支付场景:参数packageValue为Sign=WXPay&SubsidyPeriodType=DAILY&MarketExposureToken=*,其中参数packageValueSign=WXPay&SubsidyPeriodType=DAILY,属于固定格式,MarketExposureToken的值传支付方式前置曝光接口获取的曝光凭证。