5.8.3云闪付拓展参数说明


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位字母或汉字或其组合


yinjr 2025年8月18日 16:00 收藏文档