5.8拓展参数说明


extendparams
每个活动extendparams的字段均不相同,请按照 规范填写

1、支付宝点餐小程序活动填写规范

只对交易方式为支付宝JS支付(A02)有效
Extendparams的字段如下:

参数 参数名称 数据类型 可空 备注
food_order_type 点餐场景类型 String(32)

qr_order(店内扫码点餐),pre_order(预点到店自提)

home_delivery (外送到家),direct_payment(直接付款),other(其他)

填写样例
extendparams={"food_order_type":"qr_order"}

 

2 、微信设备信息(device_info)

透传ISV服务商或门店商户的设备号到微信系统

参数 参数名称 数据类型 可空 备注
device_info 设备号 String(32) 终端设备号(门店号或收银设备ID),注意:PC网页或JSAPI支付请传"WEB"

填写样例
extendparams={"device_info":" 013467007045764"}

 

3、支付宝外部指定买家

ext_user_info内容为支付宝OPENAPI接口文档中ExtUserInfo的json字符串(String类型)

参数 参数名称 可空 长度 说明 示例
ext_user_info ExtUserInfo - 外部指定卖家 -
name String 16

姓名

注:need_check_info=T时,该参数才有效

黎明
mobile String 20

手机号

注:该参数暂不校验

16578789955
cert_type String 32

身份证:IDENTIFY_CARD、护照:PASSPORT

军官证:OFFICER_CARD、士兵证:SOLDIER_CARD

户口本:HOKOU等。如有其它类型需要支持,请与蚂蚁金服工作人员联系。

IDENTIFY_CARD
cert_no String 可选 64

证件号

注:need_check_info=T时该参数才有效

362334768769238881
fix_buyer String 可选 8

是否强制校验付款人身份信息

T:强制校验,F:不强制    F

F
min_age String 可选 3

允许的最小买家年龄,买家年龄必须大于等于所传数值

注:

1. need_check_info=T时该参数才有效

2. min_age为整数,必须大于等于0    18

18
need_check_info String 可选 1

是否强制校验身份信息

T:强制校验,F:不强制

F

填写样例:
例如,如果要控制18岁的用户才能交易
extendparams={"ext_user_info":"{"need_check_info":"T","min_age":"18"}"}

 

4、支付宝停车行业活动接入

具体行业活动介绍参考官方说明,链接如下:https://alipay.open.taobao.com/doc2/detail?&docType=1&articleId=108053
停车场订单埋点参数:industry_reflux_info(此参数为各2.0支付产品接口中extend_params的下级参数,包含在biz_content中,且特别注意industry_reflux_info为json对象)

参数 参数名称 类型(字节长度) 参数说明 可空 样例
industry_reflux_info 场景数据 String(100) 场景的数据表示. json 数组格式,根据场景不同的模型,参见industry_reflux_info参数说明”  

industry_reflux_info参数填充内容

参数 参数名称 类型(字节长度) 参数说明 可空 样例
scene_code 场景标识 String(100) 用于标识数据模型,由isdsp配置提供,固定parking_fee_order parking_fee_order
channel 渠道 String(32) 场景的来源渠道,固定common_park_provider common_park_provider
scene_data 场景数据 json 场景的数据表示. json 数组格式,根据场景不同的模型,参见“1.1.2scene_data参数说明”  

scene_data参数说明

参数 参数名称 类型(字节长度) 参数说明 可空 样例
license_plate 车牌号 String(32) 用户车辆车牌号 浙A3DK19
start_time 入场时间 String(32)

停车场入场时间(YY-MM-DD HH:MM:SS)。

若获取不到入场时间,可用支付时间替代。

2017/6/13 17:30
end_time 支付时间 String(32) 停车场出场支付时间(YY-MM-DD HH:MM:SS) 2017/6/13 17:40
parking_time 停车时长 String 停车时长,单位秒 1200
parking_lot_id 停车场ID String(32)

停车场编号

alipay.eco.mycar.parking.parkinglotinfo.create

(录入停车场信息)返回的parking_id

PI1504848980
parkling_lot_name 停车场名称 String 停车场名称 山下停车场
parking_lot_longitude 停车场经度 String 停车场位置经度 232.2323
parking_lot_latitude 停车场纬度 String 停车场位置纬度 2323.232
city_code 城市编码 String

当前停车场城市编码,填省市即可

无需精确到区的城市编码

110100

填写样例:
extendparams={"sys_service_provider_id":"2088711077456570","industry_reflux_info":{"scene_data":{"start_time":"2020-08-31 09:30:26","license_plate":"川A1ph13","parkling_lot_name":"测试停车场","city_code":"510100","parking_lot_id":"PI1596794061186322467"},"channel":"common_park_provider","scene_code":"parking_fee_order"}}
JSON数据格式如下:
{
"sys_service_provider_id":"2088711077456570",
"industry_reflux_info":{
"scene_data":{
"start_time":"2020-08-31 09:30:26",
"license_plate":"川A1ph13",
"parkling_lot_name":"四川测试停车场",
"city_code":"510100",
"parking_lot_id":"PI1596794061186322467"},
"channel":"common_park_provider",
"scene_code":"parking_fee_order"
}
}

 

5、微信扫码点餐订单标识

商户创建订单的时候往attach字段传入订单标识信息,支付成功后,有优惠将根据扫码点餐商户白名单和attach里面的订单标识判定是否为扫码点餐订单。

参数 参数名称 类型(字节长度) 参数说明 可空 样例
attach 场景数据 String(127) 数字及字母,限8位  

填写样例:
extendparams={"attach":"OrderSource=FoodOrder"}

 

6、云闪付主扫/被扫交易终端号透传

商户在执行paytype=U01及统一被扫云闪付交易时,可透传收银机终端编号到银联系统。

参数 参数名称 类型(字节长度) 参数说明 可空 样例
uptermno 场景数据 String(8) 数字及字母,限8位  

填写样例:
extendparams={"uptermno":"12345678"}

 

7、支付宝小程序拓展参数(订单埋参回流)透传

具体参数介绍参考官方说明,链接如下:https://opendocs.alipay.com/mini/02j1c4

参数 参数名称 类型(字节长度) 参数说明 可空 样例
sys_service_provider_id 系统商编号 String(64) 该参数作为系统商返佣数据提取的依据,请填写系统商签约协议的PID 2088511833207846
card_type 卡类型 String(32)   S0JP0000
specified_seller_name 卖家名称 String(32) 特殊场景下,允许商户指定交易展示的卖家名称 XXX的跨境小铺

填写样例:
extendparams={"sys_service_provider_id":"2088511833207846","card_type":"S0JP0000","specified_seller_name":"XXX的跨境小铺"}

 

8、微信场景信息透传

场景信息 store_info字段说明

参数 参数名称 类型(字节长度) 参数说明 可空 样例
id 门店id String(32) 门店唯一标识 SZTX001
name 门店名称 String(64) 门店名称 腾讯大厦腾大餐厅
area_code

门店行政区划码

String(6) 门店所在地行政区划码 440305
address 门店详细地址 String(128) 门店详细地址 科技园中一路腾讯大厦

extendparams={"store_info":"{"id": "门店 ID","name": " 名称","area_code": " 编码","address": "地址" }"}

 

9、支付宝获取付款码用户id的外部业务号(sence_no)

参数 参数名称 类型(字节长度) 参数说明 是否可为空 样例
DYNAMIC_TOKEN_OUT_BIZ_NO 场景数据 String(128)      

填写样例:
extendparams={"DYNAMIC_TOKEN_OUT_BIZ_NO":"20170718xxxxxxxx"}

 

10、云闪付营销活动

参数 参数名称 类型(字节长度) 参数说明 可空 样例
discountCode 场景数据 String(20) 数字及字母,限20位  

填写样例:
extendparams={"discountCode":"SXEJDS"}

 

11、支付宝优惠券

只对交易方式为支付宝JS,APP支付(A02,A03)有效
Extendparams的字段如下:

参数 参数名称 数据类型 可空 备注
promo_params 优惠参数 String(512)

 

填写样例:

上海优惠券

params.put("extendparams","{\"promo_params\":{\"consumption_voucher \":\"20240928XFQ\"}}");

params.put("extendparams","{\"promo_params\":{\"goodsid\":\"20240928XFQ\"}}");

以旧换新优惠券

params.put("extendparams","{\"promo_params\":{\"electrical_equipment_category\":\"TEST_SJ_L2\"}}");

 

12、支付宝支卡通

只对交易方式为支付宝被扫
Extendparams的字段如下:

参数 参数名称 数据类型 可空 备注
scenePayLinkInfo

所有代扣订单都必须传该参数

支卡通相关参数,传固定字符串。

bizScene和subBizScene由支付宝侧BD提供,accountId字段传邮件申请得到的accountid

String
 

preset_pay_tool

支卡通相关参数传递

amount:支卡通预期使用的金额

templateId:4.2流程中开通的商家账户id

业务可根据场景是否需要叠加营销,可以对forceUse字段选择以下两种传参方式。

叠加营销场景:forceUse-N(支卡通可叠加营销,使用支卡通金额以异步通知为准)

屏蔽营销场景:forceUse-Y(支卡通不可叠加营销,使用支卡通金额为传入的amount)

String  

填写样例
params.put("extendparams","{\"preset_pay_tool\":\"{\\\"MERCHANTCARD_ZKT\\\":[{\\\"amount\\\":\\\"1.00\\\",\\\"templateId\\\":\\\"20220927003920015501242352352\\\",\\\"forceUse\\\":\\\"N\\\"}]}\",\"scenePayLinkInfo\":\"{\\\"bizProduct\\\":\\\"ZCARD\\\",\\\"accountId\\\":\\\"2022xxxx3467\\\",\\\"bizScene\\\":\\\"由支付宝侧分配\\\",\\\"subBizScene\\\":\\\"由支付宝侧分配\\\",\\\"bizMode\\\":\\\"MERCHANT_ORDER\\\"}\"}");

 

13、云闪付云梯计划

云闪付云梯计划供不是云闪付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

样例:

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.


        


yinjr 2025年4月24日 17:20 收藏文档