跳转至

extra参数说明

特定渠道发起交易时需要的额外参数，以及部分渠道支付成功返回的额外参数。

wx_wap（微信H5支付）

extra参数 说明
sceneInfo
-h5_info
-- wap_name WAP网站名称
--wap_url WAP网站URL地址域名
--type 场景，固定值 
1
2
3
4
//wx_wap H5应用调用时
{
"extra":"{\"sceneInfo\":{\"h5_info\":{\"wap_name\":\"测试页面\",\"wap_url\":\"https://anntest.shengpay.com\",\"type\":\"wap_url\"}}}"
}

注意： 拉起支付页面的域名必须和微信开放平台配置的域名一致。参考文档

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
//微信支持app通过native调用H5支付，但不建议。
//Android调用时,extra值为：
{
    "sceneInfo":{
        "h5_info":{
            "app_name":"王者荣耀",
            "package_name":"com.tencent.tmgp.sgame",
            "type":"Android"
        }
    }
}
//其中：app_name  为应用名，package_name 为包名，type 为场景，固定值;

//IOS调用时,extra值为：
{
    "sceneInfo":{
        "h5_info":{
            "app_name":"王者荣耀",
            "package_name":"com.tencent.tmgp.sgame",
            "type":"Android"
        }
    }
}
//其中：app_name  为应用名，bundle_id 为bundle_id，type 为场景，固定值;

wx_app（微信代扣-支付中签约时）

extra参数 说明
agreementNo 协议请求号
planId 协议模板ID
signDisplayName 签名信息
agreementMerchantNotifyUrl 协议的异步通知地址 
1
2
3
4
//wx_app 微信代扣 支付中签约时
{
"extra": "{\"agreementNo\":\"1600060328354\",\"planId\":\"139441\",\"signDisplayName\":\"连信读书\",\"agreementMerchantNotifyUrl\":\"http://www.baidu.com\"}"
}

alipay_app（支付宝代扣-支付中签约时）

extra参数 说明
agreementMerchantNotifyUrl 协议回调地址
agreementNo 外部协议号
signScene 代扣场景，参考
externalLogonId 签约用户名称
subMerchantServiceName 子商户的服务名称 ，参考
subMerchantServiceDescription 子商户的服务描述 
1
2
3
4
//alipay_app 支付宝代扣 支付中签约时
{
 "extra": "{\"agreementMerchantNotifyUrl\":\"http://www.bai.com/\",\"agreementNo\":\"1591783834107\",\"signScene\":\"INDUSTRY|SOCIALIZATION\",\"externalLogonId\":\"会员号2038020\",\"subMerchantServiceDescription\":\"在下次充值时，自动通过支付宝为您发起充值，如果关闭服务则不再发起充值\",\"subMerchantServiceName\":\"连尚读书\"}"
}

注：支付成功后，系统会异步通知协议信息或通过查询接口查询协议信息。

wx_period（微信代扣-扣款）

extra参数 说明
instAgreementNo 微信代签协议号。可以通过签约的异步通知接口或者签约查询接口获取。 
1
2
3
4
//wx_period  微信代扣-扣款
{
    "extra":"{\"instAgreementNo\":\"20205229614814327660\"}"
}

alipay_period（支付宝代扣-扣款）

extra参数 说明
instAgreementNo 支付宝代签协议号。可以通过签约的异步通知接口或者签约查询接口获取。 
1
2
3
4
//alipay_period 支付宝代扣-扣款
{
    "extra":"{\"instAgreementNo\":\"20205229614814327660\"}"
}

wx_lite和wx_jsapi （微信小程序和公众号）

extra参数 说明
openId 微信用户标识
appId 微信应用标识 
1
2
3
{
    "extra": "{\"openId\":\"o7Kcet_CTuITXqTPT2bYc0pZOGO8\",\"appId\":\"wx4b6978eab2d102cf\"}"
}

shengpay_wap （钱包H5快捷支付）

extra参数 说明
unionId 连尚账户体系的用户标识
appId 连尚分配的商户应用标识
appName 商户应用名称
Back to top