目录
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.