开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
开始使用
ampe
ampe 介绍
ampe 入驻
产品管理
硬件接入
开发指南
运营能力接入
api 列表
常见问题
多端开发
鸿蒙
插件
安全
openid 开发指南
扩展能力
开发 > 指南 > ampe > 租车(rent_car)
收藏
订阅更新
我的文档
设置
商家需通过 alipay.merchant.order.sync(订单数据同步接口) 订单扩展字段 ext_info#merchant_order_status 参数更新订单状态,租车专用状态如下。
订单状态流转说明
订单状态流转图
说明:左侧表示起始状态,右侧表示允许的后置状态。
租车.png

入参规则说明
支持跨状态传递,如:create(下单成功)可直接跳转至 finished(订单完成)。
不要求首次同步订单状态必须为 create(下单成功)。
当前场景定义的订单状态(中文和英文名)如下:
注意:不同订单状态,仅是 否发送服务消息 时,用户才能在 消息列表(支付宝凯发k8官方网娱乐官方首页服务提醒入口进入或凯发k8官方网娱乐官方首页底部消息 tab 进入)查看服务订单消息提醒。
状态中文名
状态英文名
是否发送服务消息
下单成功
create

取车前已支付
paid_before_use

已取消
cancelled

待取车
to_take_car

用车中
car_occupying

部分待结算
partial_to_be_paid

部分结算支付成功
partial_paid

已还车
car_returned

待结算
to_be_paid

用车后已支付
paid_after_use

已退款
refunded

订单完成
finished

不同状态参数使用说明
下单成功 (create)
本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-下单成功 (create)时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。  
注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id
string



支付宝用户 uid。2088 开头的数字。
order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time较晚的同步会被最终存储,order_modified_time相同的两次同步会被幂等处理。
source_app
string



订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其它来源枚举值定义联系支付宝订单中心添加。
ext_info
orderextinfo



订单扩展字段。详情可查看下文 订单扩展字段
item_order_list
itemorderinfo



商品信息列表。详情可查看下文 商品信息列表
trade_no
string



支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。
amount
price
选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)


订单总金额。精确到小数点后两位,单位为
pay_amount
price
选填,建议传入该参数


实际支付金额。精确到小数点后两位。单位为
discount_amount
price



优惠金额。传入 discount_info_list  时必填。单位为
订单扩展字段
开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
l ext_key
string



订单状态 key。固定为 merchant_order_status
l ext_value
string



订单状态, 例: create
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为: rent_car
l ext_key
string



订单详情地址 key。固定为merchant_order_link_page。
l ext_value
string



商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数
业务信息参数
业务信息参数(business_info) 的各项入参详情如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
price_per_min
string



字段名称:时长单价 字段说明:for 实时:时长单价
bill_payment_limited
string



字段名称:待支付金额上限 字段说明:for 实时:待支付金额上限
length_of_reservation
string



字段名称:可免费取消时长 字段说明:for 实时:可免费取消时长
car_type
string



-厢数
transmission
string



手动/自动
order_end_time
string



字段名称:租借预计结束时间 字段说明:for 预约:租借预计结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
actual_end_time
string



字段名称:租借实际结束时间 字段说明:for 预约:租借实际结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
actual_start_time
string



字段名称:租借实际开始时间 字段说明:for 预约:租借实际开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。
car_class
string



汽车分级
order_type
string



字段名称:订单类型 字段说明:回传取值:时租hour_rent; 套餐package_rent; 日租day_rent;
package_mileage
string



字段名称:套餐包含里程 字段说明:for 实时:套餐包含里程
package_duration
string



字段名称:套餐包含时长 字段说明:for 实时:套餐包含时长
car_model
string



汽车型号
car_taken_time
string



字段名称:取车时间 字段说明:取车时间,时间格式为 yyyy-mm-dd hh:mm:ss。
order_start_time
string



字段名称:订单租借开始时间(预计取车时间) 字段说明:for 预约:订单租借开始时间(预计取车时间),时间格式为 yyyy-mm-dd hh:mm:ss。
sub_service_type
string



字段名称:子服务类型 字段说明:子服务类型;实时/预约,必传
driving_duration
string



字段名称:已行驶时长 字段说明:for 实时:已行驶时长
price_per_km
string



字段名称:里程单价 字段说明:for 实时:里程单价
billable_start_time
string



字段名称:计费开始时间 字段说明:for 实时:计费开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。
car_capacity
string



排量
driving_mileage
string



字段名称:已行驶里程 字段说明:for 实时:已行驶里程
payment_type
string



付费类型
colour
string



颜色
shopid_car_taken
string



字段名称:取车门店id 字段说明:取车门店id;预约单必填
package_name
string



字段名称:套餐名称 字段说明:for 实时:套餐名称
plate_number
string



车牌号
shopid_car_return
string



字段名称:还车门店id 字段说明:还车门店id;预约单必填
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件
获取的 material_id。
取车前已支付 (paid_before_use)
本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-取车前已支付 (paid_before_use)时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。  
注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id
string



支付宝用户 uid。2088 开头的数字。
order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time较晚的同步会被最终存储,order_modified_time相同的两次同步会被幂等处理。
source_app
string



订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其它来源枚举值定义联系支付宝订单中心添加。
ext_info
orderextinfo



订单扩展字段。详情可查看下文 订单扩展字段
item_order_list
itemorderinfo



商品信息列表。详情可查看下文 商品信息列表
trade_no
string



支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。
amount
price
选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)


订单总金额。精确到小数点后两位,单位为
pay_amount
price
选填,建议传入该参数


实际支付金额。精确到小数点后两位。单位为
discount_amount
price



优惠金额。传入 discount_info_list  时必填。单位为
订单扩展字段
开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
l ext_key
string



订单状态 key。固定为 merchant_order_status
l ext_value
string



订单状态,例:paid_before_use
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为:rent_car
l ext_key
string



订单详情地址 key。固定为merchant_order_link_page。
l ext_value
string



商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数
业务信息参数
业务信息参数(business_info) 的各项入参详情如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
price_per_min
string



字段名称:时长单价 字段说明:for 实时:时长单价
bill_payment_limited
string



字段名称:待支付金额上限 字段说明:for 实时:待支付金额上限
seats
string



座位数
length_of_reservation
string



字段名称:可免费取消时长 字段说明:for 实时:可免费取消时长
car_type
string



-厢数
transmission
string



手动/自动
order_end_time
string



字段名称:租借预计结束时间 字段说明:for预约:租借预计结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
actual_end_time
string



字段名称:租借实际结束时间 字段说明:for 预约:租借实际结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
actual_start_time
string



字段名称:租借实际开始时间 字段说明:for 预约:租借实际开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。
car_class
string



汽车分级
order_type
string



字段名称:订单类型 字段说明:回传取值:时租hour_rent; 套餐package_rent; 日租day_rent;
package_mileage
string



字段名称:套餐包含里程 字段说明:for 实时:套餐包含里程
package_duration
string



字段名称:套餐包含时长 字段说明:for 实时:套餐包含时长
car_model
string



汽车型号
car_taken_time
string



字段名称:取车时间 字段说明:取车时间,时间格式为 yyyy-mm-dd hh:mm:ss。
order_start_time
string



字段名称:订单租借开始时间(预计取车时间) 字段说明:for 预约:订单租借开始时间(预计取车时间),时间格式为 yyyy-mm-dd hh:mm:ss。
sub_service_type
string



字段名称:子服务类型 字段说明:子服务类型;实时/预约,必传
driving_duration
string



字段名称:已行驶时长 字段说明:for 实时:已行驶时长
price_per_km
string



字段名称:里程单价 字段说明:for 实时:里程单价
billable_start_time
string



字段名称:计费开始时间 字段说明:for 实时:计费开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。
car_capacity
string



排量
driving_mileage
string



字段名称:已行驶里程 字段说明:for 实时:已行驶里程
payment_type
string



付费类型
colour
string



颜色
shopid_car_taken
string



字段名称:取车门店id 字段说明:取车门店id;预约单必填
package_name
string



字段名称:套餐名称 字段说明:for 实时:套餐名称
plate_number
string



车牌号
shopid_car_return
string



字段名称:还车门店id 字段说明:还车门店id;预约单必填
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件
获取的 material_id。
已取消 (cancelled)
本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-已取消 (cancelled)时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。  
注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id
string



支付宝用户 uid。2088 开头的数字。
order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time较晚的同步会被最终存储,order_modified_time相同的两次同步会被幂等处理。
source_app
string



订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其它来源枚举值定义联系支付宝订单中心添加。
ext_info
orderextinfo



订单扩展字段。详情可查看下文 订单扩展字段
item_order_list
itemorderinfo



商品信息列表。详情可查看下文 商品信息列表
trade_no
string



支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。
amount
price
选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)


订单总金额。精确到小数点后两位,单位为
pay_amount
price
选填,建议传入该参数


实际支付金额。精确到小数点后两位。单位为
discount_amount
price



优惠金额。传入 discount_info_list  时必填。单位为
订单扩展字段
开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
l ext_key
string



订单状态 key。固定为 merchant_order_status
l ext_value
string



订单状态, 例: cancelled
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为: rent_car
l ext_key
string



订单详情地址 key。固定为merchant_order_link_page。
l ext_value
string



商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数
业务信息参数
业务信息参数(business_info) 的各项入参详情如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
price_per_min
string



字段名称:时长单价 字段说明:for 实时:时长单价
bill_payment_limited
string



字段名称:待支付金额上限 字段说明:for 实时:待支付金额上限
seats
string



座位数
length_of_reservation
string



字段名称:可免费取消时长 字段说明:for 实时:可免费取消时长
car_type
string



-厢数
transmission
string



手动/自动
order_end_time
string



字段名称:租借预计结束时间 字段说明:for预约:租借预计结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
actual_end_time
string



字段名称:租借实际结束时间 字段说明:for预约:租借实际结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
actual_start_time
string



字段名称:租借实际开始时间 字段说明:for预约:租借实际开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。
car_class
string



汽车分级
order_type
string



字段名称:订单类型 字段说明:回传取值:时租hour_rent; 套餐package_rent; 日租day_rent;
package_mileage
string



字段名称:套餐包含里程 字段说明:for 实时:套餐包含里程
package_duration
string



字段名称:套餐包含时长 字段说明:for 实时:套餐包含时长
car_model
string



汽车型号
car_taken_time
string



字段名称:取车时间 字段说明:取车时间,时间格式为 yyyy-mm-dd hh:mm:ss。
order_start_time
string



字段名称:订单租借开始时间(预计取车时间) 字段说明:for预约:订单租借开始时间(预计取车时间),时间格式为 yyyy-mm-dd hh:mm:ss。
sub_service_type
string



字段名称:子服务类型 字段说明:子服务类型;实时/预约,必传
driving_duration
string



字段名称:已行驶时长 字段说明:for 实时:已行驶时长
price_per_km
string



字段名称:里程单价 字段说明:for 实时:里程单价
billable_start_time
string



字段名称:计费开始时间 字段说明:for 实时:计费开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。
car_capacity
string



排量
driving_mileage
string



字段名称:已行驶里程 字段说明:for 实时:已行驶里程
payment_type
string



付费类型
colour
string



颜色
shopid_car_taken
string



字段名称:取车门店id 字段说明:取车门店id;预约单必填
package_name
string



字段名称:套餐名称 字段说明:for 实时:套餐名称
plate_number
string



车牌号
shopid_car_return
string



字段名称:还车门店id 字段说明:还车门店id;预约单必填
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件
获取的 material_id。
待取车 (to_take_car)
本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-待取车 (to_take_car)时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。  
注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id
string



支付宝用户 uid。2088 开头的数字。
order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time较晚的同步会被最终存储,order_modified_time相同的两次同步会被幂等处理。
source_app
string



订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其它来源枚举值定义联系支付宝订单中心添加。
ext_info
orderextinfo



订单扩展字段。详情可查看下文 订单扩展字段
item_order_list
itemorderinfo



商品信息列表。详情可查看下文 商品信息列表
trade_no
string



支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。
amount
price
选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)


订单总金额。精确到小数点后两位,单位为
pay_amount
price
选填,建议传入该参数


实际支付金额。精确到小数点后两位。单位为
discount_amount
price



优惠金额。传入 discount_info_list  时必填。单位为
订单扩展字段
开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
l ext_key
string



订单状态 key。固定为 merchant_order_status。
l ext_value
string



订单状态,例:to_take_car
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为: rent_car
l ext_key
string



订单详情地址 key。固定为merchant_order_link_page。
l ext_value
string



商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数
业务信息参数
业务信息参数(business_info) 的各项入参详情如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
price_per_min
string



字段名称:时长单价 字段说明:for 实时:时长单价
bill_payment_limited
string



字段名称:待支付金额上限 字段说明:for 实时:待支付金额上限
seats
string



座位数
length_of_reservation
string



字段名称:可免费取消时长 字段说明:for 实时:可免费取消时长
car_type
string



-厢数
transmission
string



手动/自动
order_end_time
string



字段名称:租借预计结束时间 字段说明:for 预约:租借预计结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
actual_end_time
string



字段名称:租借实际结束时间 字段说明:for预约:租借实际结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
actual_start_time
string



字段名称:租借实际开始时间 字段说明:for预约:租借实际开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。
car_class
string



汽车分级
order_type
string



字段名称:订单类型 字段说明:回传取值:时租hour_rent; 套餐package_rent; 日租day_rent;
package_mileage
string



字段名称:套餐包含里程 字段说明:for 实时:套餐包含里程
package_duration
string



字段名称:套餐包含时长 字段说明:for 实时:套餐包含时长
car_model
string



汽车型号
car_taken_time
string



字段名称:取车时间 字段说明:取车时间,时间格式为 yyyy-mm-dd hh:mm:ss。
order_start_time
string



字段名称:订单租借开始时间(预计取车时间) 字段说明:for预约:订单租借开始时间(预计取车时间),时间格式为 yyyy-mm-dd hh:mm:ss。
sub_service_type
string



字段名称:子服务类型 字段说明:子服务类型;实时/预约,必传
driving_duration
string



字段名称:已行驶时长 字段说明:for 实时:已行驶时长
price_per_km
string



字段名称:里程单价 字段说明:for 实时:里程单价
billable_start_time
string



字段名称:计费开始时间 字段说明:for 实时:计费开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。
car_capacity
string



排量
driving_mileage
string



字段名称:已行驶里程 字段说明:for 实时:已行驶里程
payment_type
string



付费类型
colour
string



颜色
shopid_car_taken
string



字段名称:取车门店id 字段说明:取车门店id;预约单必填
package_name
string



字段名称:套餐名称 字段说明:for 实时:套餐名称
plate_number
string



车牌号
shopid_car_return
string



字段名称:还车门店id 字段说明:还车门店id;预约单必填
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件
获取的 material_id
用车中 (car_occupying)
本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-用车中 (car_occupying)时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。  
注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id
string



支付宝用户 uid。2088 开头的数字。
order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time较晚的同步会被最终存储,order_modified_time相同的两次同步会被幂等处理。
source_app
string



订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其它来源枚举值定义联系支付宝订单中心添加。
ext_info
orderextinfo



订单扩展字段。详情可查看下文 订单扩展字段
item_order_list
itemorderinfo



商品信息列表。详情可查看下文 商品信息列表
trade_no
string



支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。
amount
price
选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)


订单总金额。精确到小数点后两位,单位为
pay_amount
price
选填,建议传入该参数


实际支付金额。精确到小数点后两位。单位为
discount_amount
price



优惠金额。传入 discount_info_list  时必填。单位为
订单扩展字段
开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
l ext_key
string



订单状态 key。固定为 merchant_order_status
l ext_value
string



订单状态, 例: car_occupying
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为: rent_car
l ext_key
string



订单详情地址 key。固定为merchant_order_link_page。
l ext_value
string



商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数
业务信息参数
业务信息参数(business_info) 的各项入参详情如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
price_per_min
string



字段名称:时长单价 字段说明:for 实时:时长单价
bill_payment_limited
string



字段名称:待支付金额上限 字段说明:for 实时:待支付金额上限
seats
string



座位数
length_of_reservation
string



字段名称:可免费取消时长 字段说明:for 实时:可免费取消时长
car_type
string



-厢数
transmission
string



手动/自动
order_end_time
string



字段名称:租借预计结束时间 字段说明:for预约:租借预计结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
actual_end_time
string



字段名称:租借实际结束时间 字段说明:for预约:租借实际结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
actual_start_time
string



字段名称:租借实际开始时间 字段说明:for 预约:租借实际开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。
car_class
string



汽车分级
order_type
string



字段名称:订单类型 字段说明:回传取值:时租hour_rent; 套餐package_rent; 日租day_rent;
package_mileage
string



字段名称:套餐包含里程 字段说明:for 实时:套餐包含里程
package_duration
string



字段名称:套餐包含时长 字段说明:for 实时:套餐包含时长
car_model
string



汽车型号
car_taken_time
string



字段名称:取车时间 字段说明:取车时间,时间格式为 yyyy-mm-dd hh:mm:ss。
order_start_time
string



字段名称:订单租借开始时间(预计取车时间) 字段说明:for预约:订单租借开始时间(预计取车时间),时间格式为 yyyy-mm-dd hh:mm:ss。
sub_service_type
string



字段名称:子服务类型 字段说明:子服务类型;实时/预约,必传
driving_duration
string



字段名称:已行驶时长 字段说明:for 实时:已行驶时长
price_per_km
string



字段名称:里程单价 字段说明:for 实时:里程单价
billable_start_time
string



字段名称:计费开始时间 字段说明:for 实时:计费开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。
car_capacity
string



排量
driving_mileage
string



字段名称:已行驶里程 字段说明:for 实时:已行驶里程
payment_type
string



付费类型
colour
string



颜色
shopid_car_taken
string



字段名称:取车门店id 字段说明:取车门店id;预约单必填
package_name
string



字段名称:套餐名称 字段说明:or 实时:套餐名称
plate_number
string



车牌号
shopid_car_return
string



字段名称:还车门店id 字段说明:还车门店id;预约单必填
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件
获取的 material_id。
部分待结算 (partial_to_be_paid)
本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-部分待结算 (partial_to_be_paid)时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。  
注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id
string



支付宝用户 uid。2088 开头的数字。
order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time较晚的同步会被最终存储,order_modified_time相同的两次同步会被幂等处理。
source_app
string



订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其它来源枚举值定义联系支付宝订单中心添加。
ext_info
orderextinfo



订单扩展字段。详情可查看下文 订单扩展字段
item_order_list
itemorderinfo



商品信息列表。详情可查看下文 商品信息列表
trade_no
string



支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。
amount
price
选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)


订单总金额。精确到小数点后两位,单位为
pay_amount
price
选填,建议传入该参数


实际支付金额。精确到小数点后两位。单位为
discount_amount
price



优惠金额。传入 discount_info_list  时必填。单位为
订单扩展字段
开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
l ext_key
string



订单状态 key。固定为 merchant_order_status
l ext_value
string



订单状态, 例: partial_to_be_paid
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为: rent_car
l ext_key
string



订单详情地址 key。固定为merchant_order_link_page。
l ext_value
string



商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数
业务信息参数
业务信息参数(business_info) 的各项入参详情如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
price_per_min
string



字段名称:时长单价 字段说明:for 实时:时长单价
bill_payment_limited
string



字段名称:待支付金额上限 字段说明:for 实时:待支付金额上限
seats
string



座位数
length_of_reservation
string



字段名称:可免费取消时长 字段说明:for 实时:可免费取消时长
car_type
string



-厢数
transmission
string



手动/自动
order_end_time
string



字段名称:租借预计结束时间 字段说明:for 预约:租借预计结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
actual_end_time
string



字段名称:租借实际结束时间 字段说明:for 预约:租借实际结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
actual_start_time
string



字段名称:租借实际开始时间 字段说明:for 预约:租借实际开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。
car_class
string



汽车分级
order_type
string



字段名称:订单类型 字段说明:回传取值:时租hour_rent; 套餐package_rent; 日租day_rent;
package_mileage
string



字段名称:套餐包含里程 字段说明:for 实时:套餐包含里程
package_duration
string



字段名称:套餐包含时长 字段说明::for 实时:套餐包含时长
car_model
string



汽车型号
car_taken_time
string



字段名称:取车时间 字段说明:取车时间,时间格式为 yyyy-mm-dd hh:mm:ss。
order_start_time
string



字段名称:订单租借开始时间(预计取车时间) 字段说明:for 预约:订单租借开始时间(预计取车时间),时间格式为 yyyy-mm-dd hh:mm:ss。
sub_service_type
string



字段名称:子服务类型 字段说明:子服务类型;实时/预约,必传
driving_duration
string



字段名称:已行驶时长 字段说明:for 实时:已行驶时长
price_per_km
string



字段名称:里程单价 字段说明:for 实时:里程单价
billable_start_time
string



字段名称:计费开始时间 字段说明:for 实时:计费开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。
car_capacity
string



排量
driving_mileage
string



字段名称:已行驶里程 字段说明:for 实时:已行驶里程
payment_type
string



付费类型
colour
string



颜色
shopid_car_taken
string



字段名称:取车门店id 字段说明:取车门店id;预约单必填
package_name
string



字段名称:套餐名称 字段说明:for 实时:套餐名称
plate_number
string



车牌号
shopid_car_return
string



字段名称:还车门店id 字段说明:还车门店id;预约单必填
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件
获取的 material_id。
部分结算支付成功 (partial_paid)
本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-部分结算支付成功 (partial_paid)时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
参数说明
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。  
注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id
string



支付宝用户 uid。2088 开头的数字。
order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time较晚的同步会被最终存储,order_modified_time相同的两次同步会被幂等处理。
source_app
string



订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其它来源枚举值定义联系支付宝订单中心添加。
ext_info
orderextinfo



订单扩展字段。详情可查看下文 订单扩展字段
item_order_list
itemorderinfo



商品信息列表。详情可查看下文 商品信息列表
trade_no
string



支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。
amount
price
选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)


订单总金额。精确到小数点后两位,单位为
pay_amount
price
选填,建议传入该参数


实际支付金额。精确到小数点后两位。单位为
discount_amount
price



优惠金额。传入 discount_info_list  时必填。单位为
订单扩展字段
开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
l ext_key
string



订单状态 key。固定为 merchant_order_status。
l ext_value
string



订单状态, 例:partial_paid。
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为: rent_car。
l ext_key
string



订单详情地址 key。固定为merchant_order_link_page。
l ext_value
string



商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数
业务信息参数
业务信息参数(business_info) 的各项入参详情如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
price_per_min
string



字段名称:时长单价 字段说明:for 实时:时长单价
bill_payment_limited
string



字段名称:待支付金额上限 字段说明:for 实时:待支付金额上限
seats
string



座位数
length_of_reservation
string



字段名称:可免费取消时长 字段说明:for 实时:可免费取消时长
car_type
string



-厢数
transmission
string



手动/自动
order_end_time
string



字段名称:租借预计结束时间 字段说明:for 预约:租借预计结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
actual_end_time
string



字段名称:租借实际结束时间 字段说明:for 预约:租借实际结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
actual_start_time
string



字段名称:租借实际开始时间 字段说明:for预约:租借实际开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。
car_class
string



汽车分级
order_type
string



字段名称:订单类型 字段说明:回传取值:时租hour_rent; 套餐package_rent; 日租day_rent;
package_mileage
string



字段名称:套餐包含里程 字段说明:for 实时:套餐包含里程
package_duration
string



字段名称:套餐包含时长 字段说明:for 实时:套餐包含时长
car_model
string



汽车型号
car_taken_time
string



字段名称:取车时间 字段说明:取车时间,时间格式为 yyyy-mm-dd hh:mm:ss。
order_start_time
string



字段名称:订单租借开始时间(预计取车时间) 字段说明:for预约:订单租借开始时间(预计取车时间),时间格式为 yyyy-mm-dd hh:mm:ss。
sub_service_type
string



字段名称:子服务类型 字段说明:子服务类型;实时/预约,必传
driving_duration
string



字段名称:已行驶时长 字段说明:for 实时:已行驶时长
price_per_km
string



字段名称:里程单价 字段说明:for 实时:里程单价
billable_start_time
string



字段名称:计费开始时间 字段说明:for 实时:计费开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。
car_capacity
string



排量
driving_mileage
string



字段名称:已行驶里程 字段说明:for 实时:已行驶里程
payment_type
string



付费类型
colour
string



颜色
shopid_car_taken
string



字段名称:取车门店id 字段说明:取车门店id;预约单必填
package_name
string



字段名称:套餐名称 字段说明:for 实时:套餐名称
plate_number
string



车牌号
shopid_car_return
string



字段名称:还车门店id 字段说明:还车门店id;预约单必填
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件
获取的 material_id。
已还车 (car_returned)
本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-已还车 (car_returned)时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。  
注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id
string



支付宝用户 uid。2088 开头的数字。
order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time较晚的同步会被最终存储,order_modified_time相同的两次同步会被幂等处理。
source_app
string



订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其它来源枚举值定义联系支付宝订单中心添加。
ext_info
orderextinfo



订单扩展字段。详情可查看下文 订单扩展字段
item_order_list
itemorderinfo



商品信息列表。详情可查看下文 商品信息列表
trade_no
string



支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。
amount
price
选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)


订单总金额。精确到小数点后两位,单位为
pay_amount
price
选填,建议传入该参数


实际支付金额。精确到小数点后两位。单位为
discount_amount
price



优惠金额。传入 discount_info_list  时必填。单位为
订单扩展字段
开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
l ext_key
string



订单状态 key。固定为 merchant_order_status
l ext_value
string



订单状态, 例:car_returned
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为:rent_car
l ext_key
string



订单详情地址 key。固定为merchant_order_link_page。
l ext_value
string



商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数
业务信息参数
业务信息参数(business_info) 的各项入参详情如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
price_per_min
string



字段名称:时长单价 字段说明:for 实时:时长单价
bill_payment_limited
string



字段名称:待支付金额上限 字段说明:for 实时:待支付金额上限
seats
string



座位数
length_of_reservation
string



字段名称:可免费取消时长 字段说明:for 实时:可免费取消时长
car_type
string



-厢数
transmission
string



手动/自动
order_end_time
string



字段名称:租借预计结束时间 字段说明:for 预约:租借预计结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
actual_end_time
string



字段名称:租借实际结束时间 字段说明:for预约:租借实际结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
actual_start_time
string



字段名称:租借实际开始时间 字段说明:for预约:租借实际开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。
car_class
string



汽车分级
order_type
string



字段名称:订单类型 字段说明:回传取值:时租hour_rent; 套餐package_rent; 日租day_rent;
package_mileage
string



字段名称:套餐包含里程 字段说明:for 实时:套餐包含里程
package_duration
string



字段名称:套餐包含时长 字段说明:for 实时:套餐包含时长
car_model
string



汽车型号
car_taken_time
string



字段名称:取车时间 字段说明:取车时间,时间格式为 yyyy-mm-dd hh:mm:ss。
order_start_time
string



字段名称:订单租借开始时间(预计取车时间) 字段说明:for 预约:订单租借开始时间(预计取车时间),时间格式为 yyyy-mm-dd hh:mm:ss。
sub_service_type
string



字段名称:子服务类型 字段说明:子服务类型;实时/预约,必传
driving_duration
string



字段名称:已行驶时长 字段说明:for 实时:已行驶时长
price_per_km
string



字段名称:里程单价 字段说明:for 实时:里程单价
billable_start_time
string



字段名称:计费开始时间 字段说明:for 实时:计费开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。
car_capacity
string



排量
driving_mileage
string



字段名称:已行驶里程 字段说明:for 实时:已行驶里程
payment_type
string



付费类型
colour
string



颜色
shopid_car_taken
string



字段名称:取车门店id 字段说明:取车门店id;预约单必填
package_name
string



字段名称:套餐名称 字段说明:for 实时:套餐名称
plate_number
string



车牌号
shopid_car_return
string



字段名称:还车门店id 字段说明:还车门店id;预约单必填
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件
获取的 material_id。
待结算 (to_be_paid)
本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-待结算 (to_be_paid)时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。  
注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id
string



支付宝用户 uid。2088 开头的数字。
order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time较晚的同步会被最终存储,order_modified_time相同的两次同步会被幂等处理。
source_app
string



订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其它来源枚举值定义联系支付宝订单中心添加。
ext_info
orderextinfo



订单扩展字段。详情可查看下文 订单扩展字段
item_order_list
itemorderinfo



商品信息列表。详情可查看下文 商品信息列表
trade_no
string



支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。
amount
price
选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)


订单总金额。精确到小数点后两位,单位为
pay_amount
price
选填,建议传入该参数


实际支付金额。精确到小数点后两位。单位为
discount_amount
price



优惠金额。传入 discount_info_list  时必填。单位为
订单扩展字段
开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
l ext_key
string



订单状态 key。固定为 merchant_order_status
l ext_value
string



订单状态, 例: to_be_paid
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为: rent_car
l ext_key
string



订单详情地址 key。固定为merchant_order_link_page。
l ext_value
string



商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数
业务信息参数
业务信息参数(business_info) 的各项入参详情如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
price_per_min
string



字段名称:时长单价 字段说明:for 实时:时长单价
bill_payment_limited
string



字段名称:待支付金额上限 字段说明:for 实时:待支付金额上限
seats
string



座位数
length_of_reservation
string



字段名称:可免费取消时长 字段说明:for 实时:可免费取消时长
car_type
string



-厢数
transmission
string



手动/自动
order_end_time
string



字段名称:租借预计结束时间 字段说明:for 预约:租借预计结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
actual_end_time
string



字段名称:租借实际结束时间 字段说明:for 预约:租借实际结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
actual_start_time
string



字段名称:租借实际开始时间 字段说明:for 预约:租借实际开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。
car_class
string



汽车分级
order_type
string



字段名称:订单类型 字段说明:回传取值:时租hour_rent; 套餐package_rent; 日租day_rent;
package_mileage
string



字段名称:套餐包含里程 字段说明:for 实时:套餐包含里程
package_duration
string



字段名称:套餐包含时长 字段说明:for 实时:套餐包含时长
car_model
string



汽车型号
car_taken_time
string



字段名称:取车时间 字段说明:取车时间,时间格式为 yyyy-mm-dd hh:mm:ss。
order_start_time
string



字段名称:订单租借开始时间(预计取车时间) 字段说明:for预约:订单租借开始时间(预计取车时间),时间格式为 yyyy-mm-dd hh:mm:ss。
sub_service_type
string



字段名称:子服务类型 字段说明:子服务类型;实时/预约,必传
driving_duration
string



字段名称:已行驶时长 字段说明:for 实时:已行驶时长
price_per_km
string



字段名称:里程单价 字段说明:for 实时:里程单价
billable_start_time
string



字段名称:计费开始时间 字段说明:for 实时:计费开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。
car_capacity
string



排量
driving_mileage
string



字段名称:已行驶里程 字段说明::for 实时:已行驶里程
payment_type
string



付费类型
colour
string



颜色
shopid_car_taken
string



字段名称:取车门店 id 字段说明:取车门店 id;预约单必填
package_name
string



字段名称:套餐名称 字段说明:for 实时:套餐名称
plate_number
string



车牌号
shopid_car_return
string



字段名称:还车门店 id 字段说明:还车门店 id;预约单必填
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件
获取的 material_id。
用车后已支付 (paid_after_use)
本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-用车后已支付 (paid_after_use)时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。  
注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id
string



支付宝用户 uid。2088 开头的数字。
order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time较晚的同步会被最终存储,order_modified_time相同的两次同步会被幂等处理。
source_app
string



订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其它来源枚举值定义联系支付宝订单中心添加。
ext_info
orderextinfo



订单扩展字段。详情可查看下文 订单扩展字段
item_order_list
itemorderinfo



商品信息列表。详情可查看下文 商品信息列表
trade_no
string



支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。
amount
price
选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)


订单总金额。精确到小数点后两位,单位为
pay_amount
price
选填,建议传入该参数


实际支付金额。精确到小数点后两位。单位为
discount_amount
price



优惠金额。传入 discount_info_list  时必填。单位为
订单扩展字段
开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
l ext_key
string



订单状态 key。固定为 merchant_order_status
l ext_value
string



订单状态,例:paid_after_use
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为:rent_car
l ext_key
string



订单详情地址 key。固定为merchant_order_link_page。
l ext_value
string



商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数
业务信息参数
业务信息参数(business_info) 的各项入参详情如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
price_per_min
string



字段名称:时长单价 字段说明:for 实时:时长单价
bill_payment_limited
string



字段名称:待支付金额上限 字段说明:for 实时:待支付金额上限
seats
string



座位数
length_of_reservation
string



字段名称:可免费取消时长 字段说明:for 实时:可免费取消时长
car_type
string



-厢数
transmission
string



手动/自动
order_end_time
string



字段名称:租借预计结束时间 字段说明:for预约:租借预计结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
actual_end_time
string



字段名称:租借实际结束时间 字段说明:for预约:租借实际结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
actual_start_time
string



字段名称:租借实际开始时间 字段说明:for预约:租借实际开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。
car_class
string



汽车分级
order_type
string



字段名称:订单类型 字段说明:回传取值:时租hour_rent; 套餐package_rent; 日租day_rent;
package_mileage
string



字段名称:套餐包含里程 字段说明:for 实时:套餐包含里程
package_duration
string



字段名称:套餐包含时长 字段说明:for 实时:套餐包含时长
car_model
string



汽车型号
car_taken_time
string



字段名称:取车时间 字段说明:取车时间,时间格式为 yyyy-mm-dd hh:mm:ss。
order_start_time
string



字段名称:订单租借开始时间(预计取车时间) 字段说明:for 预约:订单租借开始时间(预计取车时间),时间格式为 yyyy-mm-dd hh:mm:ss。
sub_service_type
string



字段名称:子服务类型 字段说明:子服务类型;实时/预约,必传
driving_duration
string



字段名称:已行驶时长 字段说明:for 实时:已行驶时长
price_per_km
string



字段名称:里程单价 字段说明:for 实时:里程单价
billable_start_time
string



字段名称:计费开始时间 字段说明:for 实时:计费开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。
car_capacity
string



排量
driving_mileage
string



字段名称:已行驶里程 字段说明:for 实时:已行驶里程
payment_type
string



付费类型
colour
string



颜色
shopid_car_taken
string



字段名称:取车门店id 字段说明:取车门店id;预约单必填
package_name
string



字段名称:套餐名称 字段说明:for 实时:套餐名称
plate_number
string



车牌号
shopid_car_return
string



字段名称:还车门店 id 字段说明:还车门店id;预约单必填
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件
获取的 material_id。
已退款 (refunded)
本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-已退款 (refunded)时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。  
注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id
string



支付宝用户 uid。2088 开头的数字。
order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time较晚的同步会被最终存储,order_modified_time相同的两次同步会被幂等处理。
source_app
string



订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其它来源枚举值定义联系支付宝订单中心添加。
ext_info
orderextinfo



订单扩展字段。详情可查看下文 订单扩展字段
item_order_list
itemorderinfo



商品信息列表。详情可查看下文 商品信息列表
trade_no
string



支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。
amount
price
选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)


订单总金额。精确到小数点后两位,单位为
pay_amount
price
选填,建议传入该参数


实际支付金额。精确到小数点后两位。单位为
discount_amount
price



优惠金额。传入 discount_info_list  时必填。单位为
订单扩展字段
开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
l ext_key
string



订单状态 key。固定为 merchant_order_status
l ext_value
string



订单状态, 例: refunded
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为: rent_car
l ext_key
string



订单详情地址 key。固定为merchant_order_link_page。
l ext_value
string



商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数
业务信息参数
业务信息参数(business_info) 的各项入参详情如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
price_per_min
string



字段名称:时长单价 字段说明:for 实时:时长单价
bill_payment_limited
string



字段名称:待支付金额上限 字段说明:for 实时:待支付金额上限
seats
string



座位数
length_of_reservation
string



字段名称:可免费取消时长 字段说明:for 实时:可免费取消时长
car_type
string



-厢数
transmission
string



手动/自动
order_end_time
string



字段名称:租借预计结束时间 字段说明:for预约:租借预计结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
actual_end_time
string



字段名称:租借实际结束时间 字段说明:for预约:租借实际结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
actual_start_time
string



字段名称:租借实际开始时间 字段说明:for预约:租借实际开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。
car_class
string



汽车分级
order_type
string



字段名称:订单类型 字段说明:回传取值:时租hour_rent; 套餐package_rent; 日租day_rent;
package_mileage
string



字段名称:套餐包含里程 字段说明:for 实时:套餐包含里程
package_duration
string



字段名称:套餐包含时长 字段说明:for 实时:套餐包含时长
car_model
string



汽车型号
car_taken_time
string



字段名称:取车时间 字段说明:取车时间,时间格式为 yyyy-mm-dd hh:mm:ss。
order_start_time
string



字段名称:订单租借开始时间(预计取车时间) 字段说明:for 预约:订单租借开始时间(预计取车时间),时间格式为 yyyy-mm-dd hh:mm:ss。
sub_service_type
string



字段名称:子服务类型 字段说明:子服务类型;实时/预约,必传
driving_duration
string



字段名称:已行驶时长 字段说明:for 实时:已行驶时长
price_per_km
string



字段名称:里程单价 字段说明:for 实时:里程单价
billable_start_time
string



字段名称:计费开始时间 字段说明:for 实时:计费开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。
car_capacity
string



排量
driving_mileage
string



字段名称:已行驶里程 字段说明:for 实时:已行驶里程
payment_type
string



付费类型
colour
string



颜色
shopid_car_taken
string



字段名称:取车门店 id 字段说明:取车门店 id;预约单必填
package_name
string



字段名称:套餐名称 字段说明:for 实时:套餐名称
plate_number
string



车牌号
shopid_car_return
string



字段名称:还车门店 id 字段说明:还车门店 id;预约单必填
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件
获取的 material_id
订单完成 (finished)
本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-订单完成 (finished)时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。  
注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id
string



支付宝用户 uid。2088 开头的数字。
order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time较晚的同步会被最终存储,order_modified_time相同的两次同步会被幂等处理。
source_app
string



订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其它来源枚举值定义联系支付宝订单中心添加。
ext_info
orderextinfo



订单扩展字段。详情可查看下文 订单扩展字段
item_order_list
itemorderinfo



商品信息列表。详情可查看下文 商品信息列表
trade_no
string



支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。
amount
price
选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)


订单总金额。精确到小数点后两位,单位为
pay_amount
price
选填,建议传入该参数


实际支付金额。精确到小数点后两位。单位为
discount_amount
price



优惠金额。传入 discount_info_list  时必填。单位为
订单扩展字段
开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
l ext_key
string



订单状态 key。固定为 merchant_order_status
l ext_value
string



订单状态, 例: finished
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为:rent_car
l ext_key
string



订单详情地址 key。固定为merchant_order_link_page。
l ext_value
string



商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数
业务信息参数
业务信息参数(business_info) 的各项入参详情如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
price_per_min
string



字段名称:时长单价 字段说明:for 实时:时长单价
bill_payment_limited
string



字段名称:待支付金额上限 字段说明:for 实时:待支付金额上限
seats
string



座位数
length_of_reservation
string



字段名称:可免费取消时长 字段说明:for 实时:可免费取消时长
car_type
string



-厢数
transmission
string



手动/自动
order_end_time
string



字段名称:租借预计结束时间 字段说明:for 预约:租借预计结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
actual_end_time
string



字段名称:租借实际结束时间 字段说明:for 预约:租借实际结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
actual_start_time
string



字段名称:租借实际开始时间 字段说明:for 预约:租借实际开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。
car_class
string



汽车分级
order_type
string



字段名称:订单类型 字段说明:回传取值:时租hour_rent; 套餐package_rent; 日租day_rent;
package_mileage
string



字段名称:套餐包含里程 字段说明:for 实时:套餐包含里程
package_duration
string



字段名称:套餐包含时长 字段说明:for 实时:套餐包含时长
car_model
string



汽车型号
car_taken_time
string



字段名称:取车时间 字段说明:取车时间,时间格式为 yyyy-mm-dd hh:mm:ss。
order_start_time
string



字段名称:订单租借开始时间(预计取车时间) 字段说明:for 预约:订单租借开始时间(预计取车时间),时间格式为 yyyy-mm-dd hh:mm:ss。
sub_service_type
string



字段名称:子服务类型 字段说明:子服务类型;实时/预约,必传
driving_duration
string



字段名称:已行驶时长 字段说明:for 实时:已行驶时长
price_per_km
string



字段名称:里程单价 字段说明:for 实时:里程单价
billable_start_time
string



字段名称:计费开始时间 字段说明:for 实时:计费开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。
car_capacity
string



排量
driving_mileage
string



字段名称:已行驶里程 字段说明:for 实时:已行驶里程
payment_type
string



付费类型
colour
string



颜色
shopid_car_taken
string



字段名称:取车门店 id 字段说明:取车门店 id;预约单必填
package_name
string



字段名称:套餐名称 字段说明:for 实时:套餐名称
plate_number
string



车牌号
shopid_car_return
string



字段名称:还车门店 id 字段说明:还车门店id;预约单必填
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件
获取的 material_id。
内容没有解决您的问题?您还可以前往 或 寻求帮助
凯发k8官方网娱乐官方 copyright © 支付宝(杭州)信息技术有限公司  | icp证浙b2-20160559
该文档对你是否有帮助?
当前页面目录
网站地图