h5
跳转支付中间页
页面 URL: https://ssl.gongyi.qq.com/m/weixin/gonewpay.html
页面参数:
字段 | 类型 | 必选 | 说明 |
---|---|---|---|
pid | number | √ | 项目ID。 |
bid | string | √ | 业务ID。 |
money | number | 支付金额,以 元 为单位, 不填则允许用户自行输入金额。 |
|
ticket | string | 校验下单的票据,申请校验则该字段必填。 生成规则见 获取下单ticket | |
busi_code | string | 业务侧订单号(当携带 ticket 参数时,必须和生成 ticket 的 busi_code 值一致) | |
ref_url | string | 支付成功后,跳转的感谢页,只填写域名后的全路径和参数,不包含域名,域名提前配置。 | |
spmet | string | 捐款渠道标识,用于统计捐款的渠道来源。 |
体验链接示例
在微信浏览器或其他移动端浏览器打开
页面支付后回调
在公益侧支付成功后,会在传入的 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 | 用户实际支付金额,以 分 为单位。 注:与传入URL参数的money单位不同 |
小程序内嵌h5
如业务场景是在小程序内嵌webview中打开的h5, 则还需要另外配置业务域名(h5域名和ref_url域名都需要配置) 需在域名根目录下放置校验文件,配置后要能直接访问到https://www.xxxxx.com/AOccIb7kDP.txt, 并联系开发同学在小程序管理端配置业务域名。
App 客户端
App 客户端接入的方式目前仅提供 使用 webview 打开公益侧 h5 页面 的方式。
接入时客户端需要准备好的工作
在
android
下,webview 要在 http 请求头里面补充 referer 属性。具体见 微信支付文档 中的 “二、其它常见错误 - 序号2” 的说明。在
iOS
下,存在部分 app 在跳转微信支付后,无法返回到原 app 而是跳转 safari 情况。如果想跳回原app, 需要找微信支付侧申请app权限,可参考 https://iwiki.woa.com/p/1367703729