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\":\"20250222YLXFQ\"}}");