h5
跳转支付中间页
页面 URL: https://ssl.gongyi.qq.com/m/weixin/gopaylts.html
页面参数:
字段 | 类型 | 必选 | 说明 |
---|---|---|---|
pid | number | √ | 项目ID。 |
bid | string | √ | 业务ID。 |
sign | string | √ | 业务ID对应的 sign 值。使用公益侧提供的值即可,不需要再自己签名。 |
money | float | 支付金额,以 元 为单位。 |
|
btr | string | 应用侧自己生成的订单号,长度必须小于32位。 | |
attach | string | 应用侧携带订单的自定义数据,会写入订单信息。长度小于255个字节。如果使用 JSON 格式的数据,需要 JSON.stringify(jsondata) 。若encodeURIComponent了,需要decodeURIComponent |
|
ref_url | string | 支付成功后,跳转的感谢页,只填写域名后的全路径和参数,不包含域名,域名提前配置。 | |
ADTAG | string | 渠道标识,用于统计访问渠道来源。 | |
et | string | 捐款渠道标识,用于统计捐款的渠道来源。 | |
gt | string | 捐款渠道标识,用于统计捐款的渠道来源。 | |
pm | string | 在非微信和非手q客户端访问时,默认是使用微信支付,如果必须要用 qq 支付,需要在链接中加上 pm=qq 参数。 |
体验链接示例
在微信浏览器或其他移动端浏览器打开
- 测试项目活动跳转支付中间页:https://ssl.gongyi.qq.com/m/weixin/gopaylts.html?pid=403&money=0.01&bid=100000377&sign=431595d4a6b2644b4d79c9aa47e0e855
页面支付后回调
在公益侧支付成功后,会在传入的 ref_url
链接中添加以下字段:
transcode={公益侧支付单号}&money={用户实际支付金额}&btr={传入的btr}&attach={传入的attach}
,
示例:
假设 domain
为 https://www.qq.com
,ref_url
为 /callbackurl
,则回调时候的结果为
https://www.qq.com/callbackurl?transcode={公益侧支付单号}&money={用户实际支付金额}&btr={传入的btr}&attach={传入的attach}
。
如无设置 ref_url
,公益侧会跳转到公益侧感谢用户捐赠的页面。
字段 | 类型 | 说明 |
---|---|---|
transcode | number | 公益侧支付单号 |
money | float | 支付金额,以 分 为单位。 注:与传入URL参数的money单位不同 |
btr | string | 传入的btr |
attach | string | 传入的attach |
小程序内嵌h5
如业务场景是在小程序内嵌webview中打开的h5, 则还需要另外配置业务域名(h5域名和ref_url域名都需要配置) 需在域名根目录下放置校验文件,配置后要能直接访问到https://www.xxxxx.com/AOccIb7kDP.txt, 并联系开发同学在小程序管理端配置业务域名。
App 客户端
App 客户端接入的方式目前仅提供 使用 webview 打开公益侧 h5 页面 的方式。
接入时客户端需要准备好的工作
- 在
android
下,webview 要在 http 请求头里面补充 referer 属性。具体见 微信支付文档 中的 “二、其它常见错误 - 序号2” 的说明。
已知问题
- 在
iOS
下,存在部分客户端在跳转微信支付后,无法返回到原来客户端而是跳转 safari 情况,暂时还没找到解决方案。