4.1.2业务订单创建


使用场景:
调用此接口创建业务订单
调用此接口前,需要商家在小程序调用小程序接口my.checkBeforeAddOrder获取source_id
创建成功,获得order_id,使用order_id调用支付宝小程序接口startOrderService拉起用户授权页面
接口编号:alipay.open.mini.order.create


请求参数(bizdata):

参数 参数名称 取值 可空 类型 备注
out_order_id

商户订单

[描述]注意:

不可使用特殊字符,如 /,=,& 等。

[示例值]Iphone14 256G

String(32)  
title 订单标题

[描述]注意:

不可使用特殊字符,如 /,=,& 等。

[示例值]Iphone14 256G

String(256)  
source_id 追踪ID

[描述]追踪ID,公域分发场景必传,

会影响主播归因、分享员归因等;

通过调用

my.checkBeforeAddOrder 接口返回

[示例值]MjAfSVNfTlVMA==

String

获取方式

见接口下

方链接

merchant_biz_type

订单类型

[描述]订单类型

[枚举值]

电商购物: 

KX_SHOPPING

团购劵: 

GROUP_SECURITIES

虚拟商品:

 VIRTUAL_RECHARGE

间联实物代扣: 

INDIRECT_PHYSICAL_ITEM_WITHHOLD

酒店日历房: 

HOTEL_BOOKING

演出票务: 

PERFORMANCE_TICKET

实物间联: 

INDIRECT

间联充电代扣: 

INDIRECT_CHARGE_WITHHOLD

标准租赁: 

STANDARD_RENT

String  
path

商家小程

序对应的

订单详情

页路径地

[描述]商家小程序对应的订单

详情页路径地址value

仅需传入小程序页面路径即可

同一笔订单的链接必须与第一

次传入的地址相同且需是小程

序内部页面路径

[示例值]

/pages/index/index?orderId=1019060

String  
order_detail 订单信息

[描述]订单信息

详见本接口下方“数组类字段说明:

order_detail的明细字段

object[order_detail]  
seller_id

卖家支付

宝用户ID

[描述]卖家支付宝用户ID。

收款账号优先级规则:

门店绑定的收款账户>

请求传入的seller_id>

商户签约账号对应的支付宝用户ID;

注:

直付通和机构间联场景下seller_id

无需传入或者保持跟pid一致

如果传入的seller_id与pid不一致

需要联系支付宝小二配置收款关系

本地商品无需填写

[必选条件]当需要指定收款账号时,

通过该参数传入,如果该值为空,

则默认为商户签约账号对应的支

付宝用户ID

本地商品无需填写。

[示例值]2088401374030307

string[1,32]  
buyer_id 买家ID

[描述]买家支付宝用户id

新商户建议使用

buyer_open_id替代该字段。

对于新商户,

buyer_id字段未来计划逐步回收

存量商户可继续使用。

如使用buyer_open_id

请确认

应用-开发配置-openid配置管理已启用

无该配置项,可查看openid配置申请。

[注意事项]交易的买家与卖家不能相同

[示例值]2088102146225135

string[1,128]

buyer_id

buyer_open_id

buyer_logon_id

三选一传入

buyer_open_id

买家支付

宝用户唯

一标识

[描述]买家支付宝用户唯一标识

详情可查看openid简介

[示例值]074a1CcTG1LelxKe4xQC0zg

string[1,128]
buyer_logon_id

买家支付

宝登录账

[描述]买家支付宝登录账号。

buyer_logon_id和buyer_id两者传其一

和buyer_id不能同时为空

建议通过buyer_id来传递买家信息。

[示例值]159********

string[1,128]
shop_info 门店信息

[描述]门店信息

详见本接口下方“数组类字段说明:

shop_info的明细字段

[必选条件]当merchant_biz_type为

HOTEL_BOOKING类型时

shop_info信息必传

 

object[shop_info]

(条件必传)

 
credit_info

芝麻信用

信息

[描述]芝麻信息

详见本接口下方“数组类字段说明:

credit_info的明细字段

[必选条件]使用芝麻先享能力时传入

 

object[credit_info]

(条件必传)

 
stage_pay_plans

阶段付款

计划

[描述]阶段付款计划

租赁场景或分期代扣场景

该字段必填

详见本接口下方“数组类字段说明:

stage_pay_plans的明细字段

[必选条件]

当传入STANDARD_RENT订单类型时

该字段必填

 

object[stage_pay_plans]

(条件必传)

 
contact_info

买家联系

人信息

详见本接口下方“数组类字段说明:

contact_info的明细字段

object[contact_info]  
address_info

订单收货

地址

详见本接口下方“数组类字段说明:

address_info的明细字段

object[address_info]  

promo_detai_info

订单优惠

信息

详见本接口下方“数组类字段说明:

promo_detail_info的明细字段

object

[promo_detail_info]

 
ext_info

订单扩展

字段

详见本接口下方“数组类字段说明:

ext_info的明细字段

object[ext_info]  
delivery_detail 物流信息

详见本接口下方“数组类字段说明:

delivery_detail的明细字段

object[delivery_detail]  

default_receiving_address

默认退货

地址

详见本接口下方“数组类字段说明:

default_receiving_address的明细字段

object

[default_receiving_address]

 

source_id获取接口链接: https://opendocs.alipay.com/mini/512c3ce1_my.checkBeforeAddOrder?pathHash=1a9f62f4

响应参数(bizdata):

字段ID 字段名称 取值 可空 类型 备注
order_id

交易组件

订单号

【描述】交易组件订单号。

可以把获取到的order_id作为alipay.trade.create

(统一收单交易创建接口)

extend_params.trade_component_order_id的入参进行关联。

【示例值】2015042321001004720200028594

String(128)  
out_order_id

外部商户

订单号

【描述】外部商户订单号

【示例值】20150423001001

string(32)  
customer_display_text

建议对客

展示文案

【描述】建议对客展示文案。

当接口返回异常时,建议将当前字段对客进行展示。

【示例值】同一时间下单人数过多,请稍后重试

string(128)  
pay_info_response 创单扩展 "pay_info_response": { "no_pay_close_time": "121212212" }    

1.Order_detail的明细字段

参数 参数名称 取值 可空 类型 备注
item_infos 商品详细信息 【描述】商品详细信息 object[item_infos]  
price_info 价格详细信息 【描述】价格详细信息 object[price_info]  
pay_info 支付信息 【描述】支付信息 object[pay_info]  

1-1)item_infos的明细字段

参数 参数名称 取值 可空 类型 备注
goods_name 商品名称

【描述】商品名称

【示例值】商品名称1

string[1,256]  
item_cnt 商品数量

【描述】商品数量

【示例值】5

string[1,10]  
sale_price 商品单价

【描述】商品单价

单位:元,精确到小数点后两位

【示例值】88.88

string[1,11]  
goods_id

商品的编

【描述】提报支付券优惠时的商品id

用于关联使用支付券

需要和支付券上绑定商品goods_id相同。

如果不使用支付券,

该字段传入商品最小粒度的商品id

如:若商品有 sku 粒度,则传商品 sku 粒度的id

【示例值】1234567

string[1,32]  
out_item_id

商户商品

ID

【描述】商户侧商品id

用于公域场景结算

会影响主播归因

私域场景无需传入

公域场景未传入会影响后续结算

【必选条件】公域场景使用必传

(订单前置判断接口返回的sourceId不为空)

【示例值】123

string[1,64]  
out_sku_id

商户商品

sku_id

【描述】商户侧商品sku_id,

用于公域场景结算,

如果商品有多个sku,

需要传入准确的sku_id,

无sku时不需要传入

【必选条件】公域场景下,

商品提报过多个out_sku_id时必传

【示例值】34567576565656

string[1,64]  
sale_real_price

商品实际

单价

【描述】商品真实单价,

单位:元,精确到小数点后两位,

有优惠信息时需要传入,

优惠方式sale_real_price与item_discount二选一

sale_real_price使用场景:

商品有单价优惠,

传入商品实际成交单价 item_discount使用场景:

同时购买多件商品时存在优惠,

传入优惠总额 优惠计算参考:

资金平衡校验 sale_real_price使用场景:

商品有单价优惠,

传入商品实际成交单价 item_discount使用场景:

同时购买多件商品时存在优惠,

传入优惠总额 优惠计算参考:

资金平衡校验

【必选条件】sale_real_price使用场景:

商品有单价优惠,传入商品实际成交单价

【示例值】68.88

string[1,11]  
item_discount

商家商品

优惠金额

【描述】单位元有优惠信息时需要传入,

优惠方式sale_real_price与item_discount二选一

sale_real_price使用场景:

商品有单价优惠,

传入商品实际成交单价item_discount使用场景:

同时购买多件商品时存在优惠,

传入优惠总额优惠计算参考:

文档中资金平衡校验

【必选条件】item_discount使用场景:

同时购买多件商品时存在优惠,传入优惠总额

【示例值】1.00

string[0,10]  
image_material_id

商家商品

素材ID

【描述】商品图片,用于小程序订单中心展示,

可通过 alipay.merchant.item.file.upload 

接口上传素材获取素材id。

默认使用已上报的商品库素材信息。

【必选条件】已上报的商品可不传入,

未上报商品库需传入。

为空会导致订单展示异常

string[1,256]  
item_installment_info

商品分期

信息

【描述】商品分期信息

【必选条件】分期代扣商品必填

object[item_installment_info]  
goods_type 商品类型

【描述】商品类型

【枚举值】

票务本地商品: TICKET

虚拟商品: VIRTUAL

【示例值】VIRTUAL

string[1,36]  
rent_info 租金信息 租金信息,租赁商品特有 object[rent_info]  
body

商品描述

信息

【描述】商品描述信息

【示例值】商品是法国生产

string[1,1000]  
effective_dates 价格日历 【描述】价格日历 object[effective_dates]  
ticket_info 票务信息 【描述】演出票务信息 object[ticket_info]  
activity_info 活动信息 【描述】活动信息 object[activity_info]  

1-1-1)item_installment_info的明细字段

字段ID 字段名称 取值 可空 类型 备注
period_num 总分期数

【描述】分期商品对应的总分期数

【示例值】12

number[1,36]  
period_max_price

每期最大

金额

【描述】分期商品每期金额不固定时

请填入该字段,

分期时分期金额会与该字段进行比较

单位为元。

【示例值】100.00

price[0.1,999999]

period_max_price和

period_price二选一传入

period_price 每期金额

【描述】分期商品每期金额固定时,

请填入该字段,

分期时分期金额会与该字段进行比较

单位为元

【示例值】50.00

price[0.1,999999]

1-1-2)rent_info的明细字段

字段ID 字段名称 取值 可空 类型 备注
rent_start_time 租期开始时间

【描述】租期开始时间

匹配格式yyyy-MM-dd HH:mm:ss的date类型

【必选条件】在创建订单接口的情况下,

订单模型类型为STANDARD_RENT必填

【示例值】2023-11-01 12:00:00

date  
rent_end_time 租期结束时间

【描述】租期结束时间

匹配格式yyyy-MM-dd HH:mm:ss的date类型

【必选条件】在创建订单接口的情况下,

订单模型类型为STANDARD_RENT必填

【示例值】2023-11-01 12:00:00

date  
buyout_price 买断价

【描述】买断价,单位元

【示例值】2000.00

string[1,100]  
deposit_price 押金金额

【描述】押金金额,单位元

【示例值】100.00

string[0,100]  

1-1-3)effective_dates的明细字段

字段ID 字段名称 取值 可空 类型 备注
date 价格日期

【描述】价格日期 yyyyMMdd

【示例值】20211101

string[0,1024]  
price 商品单价

【描述】商品单价,单位元

【示例值】20.00

string[0,256]  

1-1-4)ticket_info的明细字段

字段ID 字段名称 取值 可空 类型 备注
ticket_id 票编码ID

【描述】票编码ID,票的唯一标识

【示例值】

20240222123058189321

string[1,32]  
ticket_type 票类型

【描述】票类型

【枚举值】

实体票: PHYSICAL

电子票: ELECTRONIC

【示例值】ELECTRONIC

string[1,16]  
event_id 场次ID

【描述】场次唯一标识

【示例值】

202402221230581892322

string[1,32]  
event_name 场次名称

【描述】场次名称

【示例值】2024年4月18日场次

string[1,64]  
event_start_time

场次开始

时间

【描述】场次开始时间

匹配格式yyyy-MM-dd HH:mm:ss的date类型

【示例值】2021-11-23 20:30:00

date  
location_name 演出位置

【描述】演出位置

【示例值】杭州奥体中心体育场

string[1,64]  
city 演出城市

【描述】演出地点所属的城市

【示例值】杭州市

string[1,64]  
ticket_link 票据链接

【描述】票据链接,跳转到票核销链接的地址

【示例值】

alipays://platformapi/startApp?appId=xxx&page=xxx

string[1,512]  
event_end_time 结束时间

【描述】场次结束时间

匹配格式yyyy-MM-dd HH:mm:ss的date类型

【示例值】2021-11-23 22:30:00

data  
performance_seats

演出座位

【描述】演出座位号

【示例值】A区3排5座

string[1,32]  

1-1-5)activity_info的明细字段

字段ID 字段名称 取值 可空 类型 备注
activity_id 活动ID

【描述】活动编码ID,活动的唯一标识

【示例值】

20240222123058114335

string[1,32]  
activity_name 活动名称

【描述】活动名称

【示例值】团建轰趴套餐

string[1,64]  
location_name 地点

【描述】活动地点

【示例值】万达广场

string[1,64]  
city 演出城市

【描述】活动所在的城市名

【示例值】杭州市

string[1,64]  
start_time 开始时间

【描述】活动开始时间

匹配格式yyyy-MM-dd HH:mm:ss的date类型

【示例值】

2021-11-23 20:30:00

date  
end_time 结束时间

【描述】活动结束时间

匹配格式yyyy-MM-dd HH:mm:ss的date类型

【示例值】

2021/11/23 22:30

date  
link

活动票链

【描述】活动票链接

[示例值

]alipays://platformapi/startApp?appId=xxx&page=xxx

string[1,512]  

1-2)price_info的明细字段

字段ID 字段名称 取值 可空 类型 备注
order_price 订单金额

【描述】订单总价

单位:元

精确到小数点后两位

【示例值】88.88

string[1,11]  
freight 运费

【描述】运费

单位:元

精确到小数点后两位

【示例值】100

string[1,9]  
discounted_price 商家优惠金额

【描述】商家优惠金额

单位:元

精确到小数点后两位

【示例值】88.88

string[1,11]  
merchant_value_price 商家储值金额

【描述】商家侧储蓄卡金额

单位为元

精确到小数点后两位

【示例值】100.00

price[0,999999999)  

1-3)pay_info的明细字段

字段ID 字段名称 取值
payment_biz_type 支付渠道

【描述】订单支付渠道,空值默认为支付宝支付

【枚举值】

免费订单: FREE

【示例值】FREE

payment_method 支付方式

【描述】支付方式,到付等特殊场景下传入

【枚举值】

到付: COUNTER

【示例值】COUNTER

2.shop_info的详细字段

字段ID 字段名称 取值 可空 类型 备注
name 门店名称

【描述】门店名称

【示例值】门店名称

string[0,1024]  
address 门店地址

【描述】门店地址

【示例值】门店地址

string[0,2048]  
merchant_shop_id 商家侧门店id

【描述】商家侧门店id

【示例值】1000

string[0,255]  
alipay_shop_id 蚂蚁侧门店id

【描述】蚂蚁侧门店id

【示例值】

2018011900502000000005124744

string[0,255]  

3.credit_info的详细字段

字段ID 字段名称 取值 可空 类型 备注
zm_service_id 信用服务ID

【描述】传smid在芝麻侧生成的信用服务id

使用芝麻先享能力必传

【示例值】

2015042321001004720200028594

string[1,128]  
out_agreement_no 商户外部协议号

【描述】商户外部协议号

不同的支付宝用户需要传递不同的外部单号

使用芝麻先享能力必传

【示例值】

6823789339978248

string[1,32]  

4.stage_pay_plans的详细字段

字段ID 字段名称 取值 可空 类型 备注
stage_no 阶段编码

【描述】阶段付款计划阶段编号

标识当前计划处于第几阶段,起始值为1

多阶段需保证阶段编号递增

【示例值】1

number[1,36]  
stage_pay_plan_infos 计划信息列表 【描述】阶段付款计划详情列表 object[stage_pay_plan_infos]  

4-1)stage_pay_plan_infos的详细字段

字段ID 字段名称 取值 可空 类型 备注
plan_pay_no 计划付款编号

【描述】阶段计划付款编号

标识第几次或第几期付款

起始值为1,多个计划需保证编号递增

【示例值】1

number[1,36]  
plan_pay_price 计划付款金额

【描述】阶段付款计划付款金额

单位:元,精确到小数点后两位

【示例值】100.00

price[0,10000000]  
plan_pay_time 计划付款时间

【描述】阶段付款计划付款时间

多个计划需保证付款时间递增

匹配格式yyyy-MM-dd HH:mm:ss的date类型

【示例值】2024-04-10 12:00:00

date  

5.contact_info联系人信息的详细字段

字段ID 字段名称 取值 可空 类型 备注
phone_number 手机号

【描述】联系人手机号

【示例值】132********

string[1,64]  
contact_name

联系人姓

【描述】联系人姓名

【示例值】张三

string[1,64]  
encryption_content

联系人信

息加密内

【描述】加密内容

创单时由团购插件上传

内容为手机号加密内容

string(512)  
phone_number 手机号

【描述】联系人手机号

【示例值】132********

     
contact_name

联系人姓

【描述】联系人姓名

【示例值】张三

     
encryption_content

联系人信

息加密内

【描述】加密内容,

创单时由团购插件上传,内容为手机号加密内容

     

6.address_info订单收货人地址的详细字段

字段ID 字段名称 取值 可空 类型 备注
receiver_name 收货人

【描述】收货人姓名

【注意事项】仅实物类电商订单需要回传收货信

【示例值】张三

string[1,64]  
detailed_address 收货地址

【描述】收货地址信息

【注意事项】仅实物类电商订单需要回传收货信

【示例值】中国浙江省杭州市西湖区xx小区xx号

string[1,1024]  
tel_number 联系方式

【描述】收货人手机号

【注意事项】仅实物类电商订单需要回传收货信

【示例值】132********

string[1,64]  
receiver_zip 收货邮编地址

【描述】收货邮编地址

【示例值】310006

string[1,64]  
receiver_division_code 标准城市域码

【描述】标准城市域码

【示例值】310006

string[1,64]  

7.promo_detail_info订单优惠信息的详细字段

字段ID 字段名称 取值 可空 类型 备注
activity_consult_id 优惠活动咨询ID

【描述】优惠前置咨询组件返回的优惠活动咨询ID

【示例值】c2d081e6ba4e485db41cbd55244031cb

string[1,256]  

8.ext_info订单扩展字段的详细字段

字段ID 字段名称 取值 可空 类型 备注
door_time

预约上门

取件时间

【描述】预约上门取件的时间,格式为 yyyy-MM-dd HH:mm:ss

匹配格式yyyy-MM-dd HH:mm:ss的date类型

【示例值】2024-12-16 15:00:00

date  
order_str

芝麻租赁

授权签名

【描述】芝麻免押冻结资金签名串

调用 alipay.fund.auth.order.app.freeze生成

用于租赁场景冻结授权资金

【必选条件】使用芝麻免押的租赁业务必传

string[1,1024]  
order_trade_type

订单交易

类型

【描述】订单的交易类型用于区分担保交易或者普通JSAPI支付

创支付单会对该类型进行校验

如果参入错误,创支付单会失败

【枚举值】

担保交易: ESCROW_TRADE

【必选条件】担保交易类型该字段必填

【示例值】ESCROW_TRADE

string[1,16]  
trade_no 交易号

【描述】支付单交易号,用于信用下单不成功转普通支付。

【必选条件】间联实物代扣场景该字段必填

【示例值】2023122801600000112348****190031

string[1,32]  
addition_rebate_base_price

订单附加

返佣金额

基数

【描述】二方接入交易组件用于返佣计算的特殊参数,单位为元

【示例值】100.00

price[0,99999999]  
deduct_sign_scene

代扣协议

签约场景

【描述】代扣协议签约场景值

商户可根据代扣产品常见场景值选择符合自身的行业场景

必须和合约中配置的一致。

【示例值】INDUSTRY|CARRENTAL

string[1,128]  

credit_code

企业的统一社会信用代码

【描述】企业的统一社会信用代码,营业执照上有该信息,企业租赁业务需要传递该参数

string[1,18]

 

alipay_account

企业支付宝账号

【描述】商家登录支付宝的邮箱账号或手机号,企业租赁业务传递该参数。

string[1,128]

 

9.delivery_detail物流信息的详细字段

字段ID 字段名称 取值 可空 类型 备注
delivery_type 物流类型

【描述】物流类型

【枚举值】

平邮: POST

快递: EXPRESS

虚拟物品: VIRTUAL

EMS: EMS

自提: SELFPICK

【示例值】VIRTUAL

string[1,64]  
delivery_time 配送时间

【描述】配送时间,格式为 yyyy-MM-dd HH:mm:ss

匹配格式yyyy-MM-dd HH:mm:ss的date类型

【示例值】2023-06-01 23:23:22

 

date  

10.default_receiving_address默认退货地址的详细字段

字段ID 字段名称 取值 可空 类型 备注
receiver_name 收货人

【描述】收货人姓名

【注意事项】仅实物类电商订单需要回传收货信

【示例值】张三

string[1,64]  
detailed_address 收货地址

【描述】收货地址信息

【注意事项】仅实物类电商订单需要回传收货信

【示例值】中国浙江省杭州市西湖区xx小区xx号

string[1,1024]  
tel_number 联系方式

【描述】收货人手机号

【注意事项】仅实物类电商订单需要回传收货信

【示例值】132********

string[1,64]  
receiver_zip 收货邮编地址

【描述】收货邮编地址

【示例值】310006

string[1,64]  
receiver_division_code 标准城市域码

【描述】标准城市域码

【示例值】310006

string[1,64]  

请求报文样例:
{"path":"pages/payResult/payResult","credit_info":{"out_agreement_no
":"agree2088102318125883"},"out_order_id":"oid1721181456516","merchant_biz_type":"INDIRECT_CHARGE_WITHHOLD","source_id":"MjA4ODEwMjMxODEyNTg4M3wyMDIxMDAxMTA0NjE1NTIxfDE3MjExODEzNzk4MjR8Zm
Fsc2V8VE9LRU5fSVNfTlVMTA==","title":"充电宝","order_detail":{"price_info":{"order_price":"10"},"item_infos":[{"goods_name":"商品名称1","sale_real_price":"10","out_item_id":"out001","item_
cnt":"1","goods_id":"good001","item_installment_info":{"period_num":1,"period_max_price":"10"},"sale_price":"10"}]},"buyer_id":"2088102318125883","ext_info":{"door_time":"2024-07-17 09:57
:36","deduct_sign_scene":"INDUSTRY|CHANGE_DIANDONGCHE_YADI"}}

返回报文样例:
{"appid":"00007751","bizcode":"10000","bizdata":"{"order_id":"2024071701502300000008830039515021","out_order_id":"oid1721181456516"}","bizmsg":"Success","cusid":"990603054996018","randomstr":"217154448897","retcode":"SUCCESS","sign":"E7EFE3B33E686BBDEEFCF28E8CB859B2","trancode":"alipay.open.mini.order.create"}


yinjr 2024年8月27日 16:55 收藏文档