遇到问题?让我来为你解答~去咨询
开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
支付产品
私域产品
小程序产品
权限集列表
搜索关键词
搜索直达
收藏
消息
小程序码
小程序服务
订单中心
接入指南
各行业订单同步/查询详情
餐饮
零售批发
商业生活
交通出行
车主生活
教育培训
医疗卫生
酒旅景区
生活缴费
公共管理和社会组织
休闲娱乐
物流运输
网络通讯
api 列表
相关资料
小程序开发管理
生物核身
交易组件
小程序商品
支付有礼
商家粉丝群
营销产品
资金产品
会员产品
信用产品
广告产品
开发 > 服务端 > 私域产品 > 小程序产品 > 权限集列表 > 订单中心 >  >  >  > 顺风车(hitchhiking)
收藏
订阅更新
我的文档
设置
接入检测
即可查看检测结果)
若有未通过的接入检测项,接口将无法调通
商家需通过 alipay.merchant.order.sync(订单数据同步接口) 订单扩展字段 ext_info#merchant_order_status 参数更新订单状态,具体状态说明如下。
订单状态流转说明
顺风车最新1.jpeg

订单状态说明
支持跨状态传递,如:pending (待接单) 可直接跳转至 starting_soon (行程即将开始) 。
不要求首次同步订单状态必须为 pending (待接单) 。
订单状态发生变更后,需要及时同步最新状态。
当前场景定义的订单状态(中文和英文名)如下:
状态中文名
状态英文名
是否为有效订单核心状态
是否发送服务消息
是否发送push
待接单
pending



待用户确认
wait_to_buyer_confirm



商户确认
confirmed



车主已出发
driver_departured



司机确认到达
driver_confirm_arrival



行程中
serving



行程结束
service_ended



待支付
wait_pay



已完成
finished



已取消
closed



已退款
refunded



待上车
to_board



行程即将开始
starting_soon



注意:不同订单状态,仅 是否发送服务消息 时,用户才能在消息列表(支付宝凯发k8官方网娱乐官方首页服务提醒入口进入或凯发k8官方网娱乐官方首页底部消息tab进入)查看服务订单消息提醒。
状态机流转
订单状态机流转如下(左侧表示起始状态,右侧表示允许的后置状态)
当前状态
允许的后置状态
pending(待接单)
pending/待接单、 serving/行程中、 driver_departured/车主已出发、 closed/已取消、 driver_confirm_arrival/司机确认到达、 wait_pay/待支付、 wait_to_buyer_confirm/待用户确认、 to_board/待上车、 service_ended/行程结束、 finished/已完成、 refunded/已退款、 confirmed/商户确认、 starting_soon/行程即将开始
wait_to_buyer_confirm(待用户确认)
pending/待接单、 serving/行程中、 driver_departured/车主已出发、 closed/已取消、 driver_confirm_arrival/司机确认到达、 wait_pay/待支付、 wait_to_buyer_confirm/待用户确认、 to_board/待上车、 service_ended/行程结束、 finished/已完成、 refunded/已退款、 confirmed/商户确认、 starting_soon/行程即将开始
confirmed(商户确认)
to_board/待上车、 serving/行程中、 service_ended/行程结束、 driver_departured/车主已出发、 finished/已完成、 refunded/已退款、 closed/已取消、 driver_confirm_arrival/司机确认到达、 confirmed/商户确认、 starting_soon/行程即将开始、 wait_pay/待支付
driver_departured(车主已出发)
to_board/待上车、 serving/行程中、 service_ended/行程结束、 driver_departured/车主已出发、 finished/已完成、 refunded/已退款、 closed/已取消、 driver_confirm_arrival/司机确认到达、 wait_pay/待支付
driver_confirm_arrival(司机确认到达)
to_board/待上车、 serving/行程中、 service_ended/行程结束、 finished/已完成、 refunded/已退款、 closed/已取消、 driver_confirm_arrival/司机确认到达、 wait_pay/待支付
serving(行程中)
serving/行程中、 service_ended/行程结束、 finished/已完成、 refunded/已退款、 closed/已取消、 driver_confirm_arrival/司机确认到达、 wait_pay/待支付
service_ended(行程结束)
service_ended/行程结束、 finished/已完成、 refunded/已退款、 closed/已取消、 driver_confirm_arrival/司机确认到达、 wait_pay/待支付
wait_pay(待支付)
finished/已完成、 refunded/已退款、 closed/已取消、 wait_pay/待支付
finished(已完成)
finished/已完成、 refunded/已退款
closed(已取消)
refunded/已退款、 closed/已取消
refunded(已退款)
refunded/已退款
to_board(待上车)
to_board/待上车、 serving/行程中、 service_ended/行程结束、 driver_departured/车主已出发、 finished/已完成、 refunded/已退款、 closed/已取消、 driver_confirm_arrival/司机确认到达、 wait_pay/待支付
starting_soon(行程即将开始)
to_board/待上车、 serving/行程中、 service_ended/行程结束、 driver_departured/车主已出发、 finished/已完成、 refunded/已退款、 closed/已取消、 driver_confirm_arrival/司机确认到达、 starting_soon/行程即将开始、 wait_pay/待支付
不同状态参数使用说明
待接单 (pending)
本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-待接单 (pending)时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



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



支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 

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相同的两次同步会被幂等处理。
category_id
string



支付宝标准服务类目code,本模板支持类目code:c000003321
service_code
string



服务code:传入小程序后台提报的服务id,将订单与服务关联。service_code 通过 alipay.open.app.service.apply(服务提报申请)接口提报服务后获取。
source_app
string



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



支付宝交易号。注意:若该状态传递了trade_no,则同步该订单的后续状态时都需要传递trade_no。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。
amount
price
选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)


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


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



优惠金额。传入 discount_info_list  时必填。单位为元
item_order_list
itemorderinfo



商品信息列表。详见下文: 商品信息列表
ext_info
orderextinfo



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



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



订单状态, 例: pending
l ext_key
string



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



订单类型 value。本业务场景为: hitchhiking
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) 的各项入参详情如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
departure_address
string



出发地
merchant_display_name
string



商户展示名称
driver_board_duration
string



车-上车地点时间
ride_price_type
string



计价方式
driver_board_distance
string



车-上车地点距离
auto_model
string



车型号
destination_address
string



目的地
ride_hailing_type
string



字段名称:打车方式
字段说明:枚举值:
instantride:实时单
reservationride:预约单
pickupride:接机单
dropoffride:送机单
is_prepay
string



字段名称:是否预付 字段说明:true/false
ride_dest_duration
string



车-预计下车时间
mobile
string



字段名称:乘客手机号 字段说明:乘客的手机号码,展示虚拟号
auto_color
string



汽车颜色
reservation_time
string



字段名称:预约出行时间 字段说明:顺风车预约的出行时间点,时间格式为 yyyy-mm-dd hh:mm:ss。
service_start_time
string



字段名称:开始时间 字段说明:开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。
ride_realtime_cost
string



实时计费
ride_dest_distance
string



车-下车地点距离
latest_board_time
string



字段名称:用户最晚上车时间 字段说明:用户最晚上车时间,时间格式为 yyyy-mm-dd hh:mm:ss。
has_paid
string



字段名称:是否已支付 字段说明:true/false,没有默认false
license_plate
string



车牌号
is_reassignment
string



是否改派
driver_contact
string



字段名称:司机手机号 字段说明:司机手机号,虚拟号
estimated_cost
string



预估车费
service_take_order_time
string



字段名称:车主接单时间 字段说明:车主接单的时间点,时间格式为 yyyy-mm-dd hh:mm:ss。
warm_reminder
string



字段名称:温馨提示 字段说明:订单补充说明
service_end_time
string



字段名称:结束时间 字段说明:结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



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



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



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



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



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



支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 

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相同的两次同步会被幂等处理。
category_id
string



支付宝标准服务类目code,本模板支持类目code:c000003321
service_code
string



服务code:传入小程序后台提报的服务id,将订单与服务关联。service_code 通过 alipay.open.app.service.apply(服务提报申请)接口提报服务后获取。
source_app
string



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



支付宝交易号。注意:若该状态传递了trade_no,则同步该订单的后续状态时都需要传递trade_no。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。
amount
price
选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)


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


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



优惠金额。传入 discount_info_list  时必填。单位为元
item_order_list
itemorderinfo



商品信息列表。详见下文: 商品信息列表
ext_info
orderextinfo



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



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



订单状态, 例: wait_to_buyer_confirm
l ext_key
string



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



订单类型 value。本业务场景为: hitchhiking
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) 的各项入参详情如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
departure_address
string



出发地
merchant_display_name
string



商户展示名称
driver_board_duration
string



车-上车地点时间
ride_price_type
string



计价方式
driver_board_distance
string



车-上车地点距离
auto_model
string



车型号
destination_address
string



目的地
ride_hailing_type
string



字段名称:打车方式
字段说明:枚举值:
instantride:实时单
reservationride:预约单
pickupride:接机单
dropoffride:送机单
ride_dest_duration
string



车-预计下车时间
is_prepay
string



字段名称:是否预付 字段说明:true/false
mobile
string



字段名称:乘客手机号 字段说明:乘客的手机号码,展示虚拟号
auto_color
string



汽车颜色
reservation_time
string



字段名称:预约出行时间 字段说明:顺风车预约的出行时间点,时间格式为 yyyy-mm-dd hh:mm:ss。
service_start_time
string



字段名称:开始时间 字段说明:开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。
ride_realtime_cost
string



实时计费
ride_dest_distance
string



车-下车地点距离
latest_board_time
string



字段名称:用户最晚上车时间 字段说明:用户最晚上车时间,时间格式为 yyyy-mm-dd hh:mm:ss。
has_paid
string



字段名称:是否已支付 字段说明:true/false,没有默认false
license_plate
string



车牌号
is_reassignment
string



是否改派
driver_contact
string



字段名称:司机手机号 字段说明:司机手机号,虚拟号
estimated_cost
string



预估车费
service_take_order_time
string



字段名称:车主接单时间 字段说明:车主接单的时间点,时间格式为 yyyy-mm-dd hh:mm:ss。
service_end_time
string



字段名称:结束时间 字段说明:结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



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



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



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



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



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



支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 

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相同的两次同步会被幂等处理。
category_id
string



支付宝标准服务类目code,本模板支持类目code:c000003321
service_code
string



服务code:传入小程序后台提报的服务id,将订单与服务关联。service_code 通过 alipay.open.app.service.apply(服务提报申请)接口提报服务后获取。
source_app
string



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



支付宝交易号。注意:若该状态传递了trade_no,则同步该订单的后续状态时都需要传递trade_no。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。
amount
price
选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)


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


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



优惠金额。传入 discount_info_list  时必填。单位为元
item_order_list
itemorderinfo



商品信息列表。详见下文: 商品信息列表
ext_info
orderextinfo



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



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



订单状态, 例: confirmed
l ext_key
string



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



订单类型 value。本业务场景为: hitchhiking
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) 的各项入参详情如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
departure_address
string



出发地
merchant_display_name
string



商户展示名称
driver_board_duration
string



车-上车地点时间
ride_price_type
string



计价方式
driver_board_distance
string



车-上车地点距离
auto_model
string



车型号
destination_address
string



目的地
ride_hailing_type
string



字段名称:打车方式
字段说明:枚举值:
instantride:实时单
reservationride:预约单
pickupride:接机单
dropoffride:送机单
ride_dest_duration
string



车-预计下车时间
is_prepay
string



字段名称:是否预付 字段说明:true/false
mobile
string



字段名称:乘客手机号 字段说明:乘客的手机号码,展示虚拟号
auto_color
string



汽车颜色
reservation_time
string



字段名称:预约出行时间 字段说明:顺风车预约的出行时间点,时间格式为 yyyy-mm-dd hh:mm:ss。
service_start_time
string



字段名称:开始时间 字段说明:开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。
ride_realtime_cost
string



实时计费
ride_dest_distance
string



车-下车地点距离
latest_board_time
string



字段名称:用户最晚上车时间 字段说明:用户最晚上车时间,时间格式为 yyyy-mm-dd hh:mm:ss。
has_paid
string



字段名称:是否已支付 字段说明:true/false,没有默认false
license_plate
string



车牌号
is_reassignment
string



是否改派
driver_contact
string



字段名称:司机手机号 字段说明:司机手机号,虚拟号
estimated_cost
string



预估车费
service_take_order_time
string



字段名称:车主接单时间 字段说明:车主接单的时间点,时间格式为 yyyy-mm-dd hh:mm:ss。
service_end_time
string



字段名称:结束时间 字段说明:结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



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



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



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



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



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



支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 

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相同的两次同步会被幂等处理。
category_id
string



支付宝标准服务类目code,本模板支持类目code:c000003321
service_code
string



服务code:传入小程序后台提报的服务id,将订单与服务关联。service_code 通过 alipay.open.app.service.apply(服务提报申请)接口提报服务后获取。
source_app
string



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



支付宝交易号。注意:若该状态传递了trade_no,则同步该订单的后续状态时都需要传递trade_no。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。
amount
price
选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)


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


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



优惠金额。传入 discount_info_list  时必填。单位为元
item_order_list
itemorderinfo



商品信息列表。详见下文: 商品信息列表
ext_info
orderextinfo



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



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



订单状态, 例: driver_departured
l ext_key
string



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



订单类型 value。本业务场景为: hitchhiking
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) 的各项入参详情如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
departure_address
string



出发地
merchant_display_name
string



商户展示名称
driver_board_duration
string



车-上车地点时间
ride_price_type
string



计价方式
driver_board_distance
string



车-上车地点距离
auto_model
string



车型号
destination_address
string



目的地
ride_hailing_type
string



字段名称:打车方式
字段说明:枚举值:
instantride:实时单
reservationride:预约单
pickupride:接机单
dropoffride:送机单
ride_dest_duration
string



车-预计下车时间
is_prepay
string



字段名称:是否预付 字段说明:true/false
mobile
string



字段名称:乘客手机号 字段说明:乘客的手机号码,展示虚拟号
auto_color
string



汽车颜色
reservation_time
string



字段名称:预约出行时间 字段说明:顺风车预约的出行时间点,时间格式为 yyyy-mm-dd hh:mm:ss。
service_start_time
string



字段名称:开始时间 字段说明:开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。
ride_realtime_cost
string



实时计费
ride_dest_distance
string



车-下车地点距离
latest_board_time
string



字段名称:用户最晚上车时间 字段说明:用户最晚上车时间,时间格式为 yyyy-mm-dd hh:mm:ss。
has_paid
string



字段名称:是否已支付 字段说明:true/false,没有默认false
license_plate
string



车牌号
is_reassignment
string



是否改派
driver_contact
string



字段名称:司机手机号 字段说明:司机手机号,虚拟号
estimated_cost
string



预估车费
service_take_order_time
string



字段名称:车主接单时间 字段说明:车主接单的时间点,时间格式为 yyyy-mm-dd hh:mm:ss。
service_end_time
string



字段名称:结束时间 字段说明:结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



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



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



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



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



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



支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 

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相同的两次同步会被幂等处理。
category_id
string



支付宝标准服务类目code,本模板支持类目code:c000003321
service_code
string



服务code:传入小程序后台提报的服务id,将订单与服务关联。service_code 通过 alipay.open.app.service.apply(服务提报申请)接口提报服务后获取。
source_app
string



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



支付宝交易号。注意:若该状态传递了trade_no,则同步该订单的后续状态时都需要传递trade_no。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。
amount
price
选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)


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


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



优惠金额。传入 discount_info_list  时必填。单位为元
item_order_list
itemorderinfo



商品信息列表。详见下文: 商品信息列表
ext_info
orderextinfo



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



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



订单状态, 例: driver_confirm_arrival
l ext_key
string



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



订单类型 value。本业务场景为: hitchhiking
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) 的各项入参详情如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
departure_address
string



出发地
merchant_display_name
string



商户展示名称
driver_board_duration
string



车-上车地点时间
ride_price_type
string



计价方式
driver_board_distance
string



车-上车地点距离
auto_model
string



车型号
destination_address
string



目的地
ride_hailing_type
string



字段名称:打车方式
字段说明:枚举值:
instantride:实时单
reservationride:预约单
pickupride:接机单
dropoffride:送机单
ride_dest_duration
string



车-预计下车时间
is_prepay
string



字段名称:是否预付 字段说明:true/false
mobile
string



字段名称:乘客手机号 字段说明:乘客的手机号码,展示虚拟号
auto_color
string



汽车颜色
reservation_time
string



字段名称:预约出行时间 字段说明:顺风车预约的出行时间点,时间格式为 yyyy-mm-dd hh:mm:ss。
service_start_time
string



字段名称:开始时间 字段说明:开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。
ride_realtime_cost
string



实时计费
ride_dest_distance
string



车-下车地点距离
latest_board_time
string



字段名称:用户最晚上车时间 字段说明:用户最晚上车时间,时间格式为 yyyy-mm-dd hh:mm:ss。
has_paid
string



字段名称:是否已支付 字段说明:true/false,没有默认false
license_plate
string



车牌号
is_reassignment
string



是否改派
driver_contact
string



字段名称:司机手机号 字段说明:司机手机号,虚拟号
estimated_cost
string



预估车费
service_take_order_time
string



字段名称:车主接单时间 字段说明:车主接单的时间点,时间格式为 yyyy-mm-dd hh:mm:ss。
service_end_time
string



字段名称:结束时间 字段说明:结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



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



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



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



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



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



支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 

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相同的两次同步会被幂等处理。
category_id
string



支付宝标准服务类目code,本模板支持类目code:c000003321
service_code
string



服务code:传入小程序后台提报的服务id,将订单与服务关联。service_code 通过 alipay.open.app.service.apply(服务提报申请)接口提报服务后获取。
source_app
string



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



支付宝交易号。注意:若该状态传递了trade_no,则同步该订单的后续状态时都需要传递trade_no。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。
amount
price
选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)


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


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



优惠金额。传入 discount_info_list  时必填。单位为元
item_order_list
itemorderinfo



商品信息列表。详见下文: 商品信息列表
ext_info
orderextinfo



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



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



订单状态, 例: serving
l ext_key
string



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



订单类型 value。本业务场景为: hitchhiking
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) 的各项入参详情如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
departure_address
string



出发地
merchant_display_name
string



商户展示名称
driver_board_duration
string



车-上车地点时间
ride_price_type
string



计价方式
driver_board_distance
string



车-上车地点距离
auto_model
string



车型号
destination_address
string



目的地
ride_hailing_type
string



字段名称:打车方式
字段说明:枚举值:
instantride:实时单
reservationride:预约单
pickupride:接机单
dropoffride:送机单
ride_dest_duration
string



车-预计下车时间
is_prepay
string



字段名称:是否预付 字段说明:true/false
mobile
string



字段名称:乘客手机号 字段说明:乘客的手机号码,展示虚拟号
auto_color
string



汽车颜色
reservation_time
string



字段名称:预约出行时间 字段说明:顺风车预约的出行时间点,时间格式为 yyyy-mm-dd hh:mm:ss。
service_start_time
string



字段名称:开始时间 字段说明:开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。
ride_realtime_cost
string



实时计费
ride_dest_distance
string



车-下车地点距离
latest_board_time
string



字段名称:用户最晚上车时间 字段说明:用户最晚上车时间,时间格式为 yyyy-mm-dd hh:mm:ss。
has_paid
string



字段名称:是否已支付 字段说明:true/false,没有默认false
license_plate
string



车牌号
is_reassignment
string



是否改派
driver_contact
string



字段名称:司机手机号 字段说明:司机手机号,虚拟号
estimated_cost
string



预估车费
service_take_order_time
string



字段名称:车主接单时间 字段说明:车主接单的时间点,时间格式为 yyyy-mm-dd hh:mm:ss。
service_end_time
string



字段名称:结束时间 字段说明:结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



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



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



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