5.8.2支付宝拓展参数说明


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 .支付宝外部指定买家

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"}"}

 

3.支付宝停车行业活动接入

具体行业活动介绍参考官方说明,链接如下: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"
}
}

 

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

具体参数介绍参考官方说明,链接如下: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的跨境小铺"}

 

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

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

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

 

6.支付宝优惠券

只对交易方式为支付宝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\"}}");

 

7.支付宝支卡通

只对交易方式为支付宝被扫
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\\\"}\"}");

 


        


yinjr 2025年7月29日 14:30 收藏文档