小程序
跳转公益侧一起捐详情页支付
公益小程序 appid
wxfdcee92a299bcaf1
页面 URL
pages/yqj_v2/detail/main
页面参数:
| 字段 | 类型 | 必选 | 说明 |
|---|---|---|---|
| id | string | √ | 项目ID。 |
| bid | string | √ | 业务ID。 |
| did | string | √ | 一起捐ID |
| ticket | string | 如果bid需要回传数据，要传ticket,生成规则见 获取下单ticket | |
| action | pay |
是否直接打开支付浮层，仅支持pay值 |
|
| type | mp / no |
默认取值为 mp， 支付成功后回跳应用侧。取值为 no 则不跳回第三方小程序，剩余流程均在公益小程序中进行 |
|
| spmet | string | 捐款渠道标识，用于统计捐款的渠道来源。 | |
| money | string | 是否指定捐款金额，单位为分 |
小程序 跳转小程序示例
// 小程序跳转
wx.navigateToMiniProgram({
appId: 'wxfdcee92a299bcaf1',
path: 'pages/yqj_v2/detail/main?id=xxx&did=xxx&bid=xxx&ticket=xxx&spmet=xxx'
})
// 打开半屏小程序
wx.openEmbeddedMiniProgram({
appId: 'wxfdcee92a299bcaf1',
path: 'pages/yqj_v2/detail/main?id=xxx&did=xxx&bid=xxx&ticket=xxx&spmet=xxx'
})
小程序回传
用户支付完成后，小程序会返回第三方小程序，并携带相关订单信息的参数
支付成功
extraData = { transcode: '', // 公益侧支付单号 money: 100, // 用户实际支付的金额，以分为单位 }
支付通知
用户支付完成后，公益侧会发送支付通知给业务侧配置的回调 url，具体见支付通知
说明
外部业务调用支付接入，必须先调用 用户授权，否则下单会报错。请务必做好交互流程，避免影响用户体验！
H5
跳转公益侧一起捐详情页支付
页面 URL
https://ssl.gongyi.qq.com/m/weixin/yqj_v2_detail.html
页面参数:
| 字段 | 类型 | 必选 | 说明 |
|---|---|---|---|
| id | string | √ | 项目ID。 |
| bid | string | √ | 业务ID。 |
| did | string | √ | 一起捐ID |
| ticket | string | √ | 校验下单的票据，申请校验则该字段必填。 生成规则见 获取下单ticket |
| action | pay |
是否直接打开支付浮层，仅支持pay值 |
|
| ref_url | string | 支付完成后跳转回业务的回调地址，需要进行一次uriencode，传空则会跳转到公益侧的结果页, 只填写域名后的全路径和参数, 不包含域名，域名提前配置。 | |
| spmet | string | 捐款渠道标识，用于统计捐款的渠道来源。 | |
| money | string | 是否指定捐款金额，单位为分 |
H5跳转链接示例
页面支付后回调
在公益侧支付成功后，会在传入的 ref_url 链接中添加以下字段：
transcode={公益侧支付单号}&money={用户实际支付金额}，
示例：
假设 domain 为 https://www.qq.com，ref_url 为 /callbackurl，则回调时候的结果为
https://www.qq.com/callbackurl?transcode={公益侧支付单号}&money={用户实际支付金额}。
如无设置 ref_url，公益侧会跳转到公益侧感谢用户捐赠的页面。
| 字段 | 类型 | 说明 |
|---|---|---|
| transcode | number | 公益侧支付单号 |
| money | float | 用户实际支付金额，以 分 为单位。 |
小程序内嵌h5
如业务场景是在小程序内嵌webview中打开的h5， 则还需要另外配置业务域名（h5域名和ref_url域名都需要配置） 需在域名根目录下放置校验文件，配置后要能直接访问到https://www.xxxxx.com/AOccIb7kDP.txt， 并联系开发同学在小程序管理端配置业务域名。
<<<<<<< HEAD
App 客户端
=======
App 客户端
origin/saiwang
App 客户端接入的方式目前仅提供 使用 webview 打开公益侧 h5 页面 的方式。
接入时客户端需要准备好的工作
- 在
android下，webview 要在 http 请求头里面补充 referer 属性。具体见 微信支付文档 中的 “二、其它常见错误 - 序号2” 的说明。
已知问题
- 在
iOS下，存在部分客户端在跳转微信支付后，无法返回到原来客户端而是跳转 safari 情况，暂时还没找到解决方案。