extendparams
每个活动extendparams的字段均不相同,请按照 规范填写
1.云闪付主扫/被扫交易终端号透传
商户在执行paytype=U01及统一被扫云闪付交易时,可透传收银机终端编号到银联系统。
参数 | 参数名称 | 类型(字节长度) | 参数说明 | 可空 | 样例 |
---|---|---|---|---|---|
uptermno | 场景数据 | String(8) | 数字及字母,限8位 | 是 |
填写样例:
extendparams={"uptermno":"12345678"}
注:不再推荐使用本拓展参数,请使用接口的terminfo信息上送银联终端号
2.云闪付营销活动
参数 | 参数名称 | 类型(字节长度) | 参数说明 | 可空 | 样例 |
---|---|---|---|---|---|
discountCode | 场景数据 | String(20) | 数字及字母,限20位 | 是 |
填写样例:
extendparams={"discountCode":"SXEJDS"}
3.云闪付云梯计划
云闪付云梯计划供不是云闪付app打开的H5也能拉起云闪付app或者云闪付微信小程序进行支付。例如在微信收款H5上选择云闪付支付,调用通联统一下单接口后返回云闪付跳转url直接重定向即可拉起云闪付app或者云闪付微信小程序完成支付。
本规范仅适用于4.1统一支付接口
填写规范:
- paytype填U02,acct填空
- extendparams填写规范如下:
参数 |
参数名称 |
数据类型 |
可空 |
备注 |
ytPlanInfo |
云梯计划信息 |
Object(ytPlanInfo) |
否 |
|
其中ytPlanInfo的字段如下
参数 |
参数名称 |
数据类型 |
可空 |
备注 |
qrCode |
码牌地址 |
String |
否 |
收款码牌的url。如果不是收款码牌,则填收银台url |
payChannel |
支付渠道 |
String |
否 |
01- 云闪付微信小程序支付,在微信APP内调用云闪付微信小程序支付场景 02- 云闪付微信公众号支付,在微信APP内调用云闪付公众号拉起云闪付APP支付的场景 |
subThirdAppId |
第三方appid |
String |
可 |
填商户微信小程序appid,payChannel=01时必填 |
样例:
extendparams={"ytPlanInfo":{"qrCode":"https://syb-test.allinpay.com/apiweb/usertrans/onepay?c=00CGNTMh","payChannel":"02","subThirdAppId":"wx6fe6f75cce9de0b7"}}
如果payChannel为02,下单成功后,直接跳转到payinfo返回的url即可
如果payChannel为01,下单成功后,需要按照小程序的规范进行跳转
其中redirectUrl为下单成功后payinfo返回的url.
4.云闪付服务商PIDINFO
云银联云闪付激励政策,银联二维码交易需增加上送pidinfo三个信息
- extendparams填写规范如下:
参数 |
参数名称 |
数据类型 |
可空 |
备注 |
unPidInfo |
服务商信息 |
Object(unPidInfo) |
否 |
|
其中unPidInfo的字段如下
参数 |
参数名称 |
数据类型 |
可空 |
备注 |
pnrOrderId |
服务商订单编号 |
String |
可 |
服务商自定义并发送,同一交易日期内不可重复,订单编号将作为服务商和银联对账的唯一索引,不超过40字节的变长字母和/或数字字符,不能含“”或“”。 |
pidSct |
服务商密文 |
String |
可 |
由服务商根据服务商代码标识加密算法生成 |
tradeScene |
场景标识 |
String |
可 |
取值如下: 1-扫码点餐 |
extendparams={"unPidInfo":{"pnrOrderId":"123456","pidSct":"lidj@163.com","tradeScene":"1"}}
代理商上送的参数需要遵循以下文档:[附件]服务商机构标识码信息保护技术改造指引0418(PID2.0服务商版).zip
5.银联平台类商户上送信息
- extendparams填写规范如下:
参数 |
参数名称 |
数据类型 |
可空 |
备注 |
ylSubMerInfo |
银联二级商户信息 |
Object(ylSubMerInfo) |
否 |
|
其中ylSubMerInfo的字段如下
参数 |
参数名称 |
数据类型 |
可空 |
备注 |
subMerId |
二级商户代码 |
String |
否 |
|
subMerName | 二级商户名称 | String | 否 | |
subMerAbbr |
二级商户简称 |
String |
否 |
仅支持8位字母或汉字或其组合 |