更新时间:2024-10-23 18:09:38配置项检测工具收藏订阅更新我的文档设置接入检测(即可查看检测结果)若有未通过的接入检测项,接口将无法调通去登录返回文档商家需通过 alipay.merchant.order.sync(订单数据同步接口) 订单扩展字段 ext_info#merchant_order_status 参数更新订单状态,打车专用状态如下。订单状态流转说明订单状态流转图说明:左侧表示起始状态,右侧表示允许的后置状态。订单状态说明●支持跨状态传递,如:pending(待接单)可直接跳转至 finished(已完成)。●不要求首次同步订单状态必须为 pending(待接单)。●当前场景定义的订单状态(中文和英文名)如下:注意:不同订单状态,仅是 否发送服务消息 为 是 时,用户才能在 消息列表(支付宝凯发k8官方网娱乐官方首页服务提醒入口进入或凯发k8官方网娱乐官方首页底部消息 tab 进入)查看服务订单消息提醒。状态中文名状态英文名是否发送服务消息待接单pending否改派中to_send是已接单order_taken是待上车to_board是行程中serving否行程结束service_ended是待支付wait_pay是已完成finished否已取消closed是不同状态参数使用说明待接单 (pending)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-待接单 (pending)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否否外部订单号。由商家自定义。注意:同一笔订单更新状态时,需与首次同步入参一致。buyer_id(buyer_open_id)string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请。order_typestring是否否订单类型。固定为service_order(服务订单)。order_create_timestring是否否订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。order_modified_timestring是是否订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。source_appstring否否否订单来源,默认 alipay(支付宝小程序)。枚举支持:dingtalk:钉钉;alipay:支付宝小程序。说明:其它来源枚举值定义可联系支付宝运营人员添加。ext_infoorderextinfo是是否订单扩展字段。详情可查看下文 订单扩展字段。item_order_listitemorderinfo是否否商品信息列表,详情可查看下文 商品信息列表。trade_nostring否否否支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。amountprice选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)是否订单总金额:某笔交易订单优惠前的总金额,单位为【元】注意事项service_order且不涉及金额可不传入该字段,其他场景必传pay_amountprice选填,建议传入该参数否否用户应付金额 :用户最终结算时需要支付金额(不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】注意事项service_order且不涉及金额可不传入该字段,其他场景必传discount_amountprice否否否商户总计优惠金额:代表商户侧给予用户的总计优惠金额 (不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】。订单扩展字段开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_statusl ext_valuestring是是否订单状态,例:pendingl ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为:ride_hailingl ext_keystring是否否订单详情地址 key。固定为 merchant_order_link_page。l ext_valuestring是否否商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185。l ext_keystring是否否商家小程序 appid key。固定为 tiny_app_id。l ext_valuestring是否否商家小程序 appid value。传入订单归属的小程序 appid。l ext_keystring是否否订单业务场景相关的信息 key。固定为 business_info。l ext_valuejsonstring是是否订单业务信息详情 value。入参详情见下文 业务信息参数。业务信息参数业务信息参数(business_info) 的各项入参详情如下:参数类型是否必填能否更新是否消息使用字段参数说明departure_addressstring是否否出发地merchant_display_namestring是否否商家展示名称is_promisedstring是否否是否承诺订单driver_board_durationstring否否否车-上车地点时间is_third_partystring否否否是否三方订单ride_price_typestring否否否计价方式tail_numberstring否否否字段名称:乘客尾号 字段说明:乘客的手机号后四位driver_board_distancestring否否否车-上车地点距离auto_modelstring否否否车型号destination_addressstring是否否目的地ride_hailing_typestring是否否打车方式ride_dest_durationstring否否否车-预计下车时间auto_colorstring否否否汽车颜色reservation_timestring是否否字段名称:预约出行时间 字段说明:预约出行时间,时间格式为 yyyy-mm-dd hh:mm:ss。service_start_timestring否否否字段名称:开始时间 字段说明:开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。ride_realtime_coststring否否否实时计费ride_typestring否否否打车服务类型ride_dest_distancestring否否否车-下车地点距离latest_board_timestring否否否字段名称:用户最晚上车时间 字段说明:用户最晚上车时间,时间格式为 yyyy-mm-dd hh:mm:ss。license_platestring否否否车牌号is_reassignmentstring是否否是否改派driver_contactstring否否否司机手机号estimated_coststring否否否预估车费third_party_namestring否否否三方服务商名称service_end_timestring否否否字段名称:结束时间 字段说明:结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。商品信息列表开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为:{商家名称} {商品名称} ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id。改派中 (to_send)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-改派中 (to_send)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否是外部订单号。由商家自定义。注意:同一笔订单更新状态时,需与首次同步入参一致。buyer_id(buyer_open_id)string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请。order_typestring是否否订单类型。固定为service_order(服务订单)。order_create_timestring是否是订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。order_modified_timestring是是否订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。source_appstring否否否订单来源,默认 alipay(支付宝小程序)。枚举支持:dingtalk:钉钉;alipay:支付宝小程序。说明:其它来源枚举值定义可联系支付宝运营人员添加。ext_infoorderextinfo是是否订单扩展字段。详情可查看下文 订单扩展字段。item_order_listitemorderinfo是否否商品信息列表,详情可查看下文 商品信息列表。trade_nostring否否否支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。amountprice选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)是否订单总金额:某笔交易订单优惠前的总金额,单位为【元】注意事项service_order且不涉及金额可不传入该字段,其他场景必传pay_amountprice选填,建议传入该参数否否用户应付金额 :用户最终结算时需要支付金额(不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】注意事项service_order且不涉及金额可不传入该字段,其他场景必传discount_amountprice否否否商户总计优惠金额:代表商户侧给予用户的总计优惠金额 (不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】。订单扩展字段开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_statusl ext_valuestring是是否订单状态,例:to_sendl ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为:ride_hailingl ext_keystring是否是订单详情地址 key。固定为 merchant_order_link_page。l ext_valuestring是否是商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185。l ext_keystring是否否商家小程序 appid key。固定为 tiny_app_id。l ext_valuestring是否否商家小程序 appid value。传入订单归属的小程序 appid。l ext_keystring是否否订单业务场景相关的信息 key。固定为 business_info。l ext_valuejsonstring是是否订单业务信息详情 value。入参详情见下文 业务信息参数。业务信息参数业务信息参数(business_info) 的各项入参详情如下:参数类型是否必填能否更新是否消息使用字段参数说明departure_addressstring是否是出发地merchant_display_namestring否否否商家展示名称driver_board_durationstring否否否车-上车地点时间is_third_partystring否否否是否三方订单is_promisedstring否否否是否承诺订单ride_price_typestring否否否计价方式tail_numberstring否否否字段名称:乘客尾号 字段说明:乘客的手机号后四位driver_board_distancestring否否否车-上车地点距离auto_modelstring否否否车型号destination_addressstring是否是目的地ride_hailing_typestring否否否打车方式ride_dest_durationstring否否否车-预计下车时间auto_colorstring否否否汽车颜色reservation_timestring是否否字段名称:预约出行时间 字段说明:预约出行时间,时间格式为 yyyy-mm-dd hh:mm:ss。service_start_timestring否否否字段名称:开始时间 字段说明:开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。ride_realtime_coststring否否否实时计费ride_typestring否否否打车服务类型ride_dest_distancestring否否否车-下车地点距离latest_board_timestring否否否字段名称:用户最晚上车时间 字段说明:用户最晚上车时间,时间格式为 yyyy-mm-dd hh:mm:ss。license_platestring否否否车牌号is_reassignmentstring否否否是否改派driver_contactstring否否否司机手机号estimated_coststring否否否预估车费third_party_namestring否否否三方服务商名称service_end_timestring否否否字段名称:结束时间 字段说明:结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。商品信息列表开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为:{商家名称} {商品名称} ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id。已接单 (order_taken)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-已接单 (order_taken)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否是外部订单号。由商家自定义。注意:同一笔订单更新状态时,需与首次同步入参一致。buyer_id(buyer_open_id)string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请。order_typestring是否否订单类型。固定为service_order(服务订单)。order_create_timestring是否否订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。order_modified_timestring是是否订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。source_appstring否否否订单来源,默认 alipay(支付宝小程序)。枚举支持:dingtalk:钉钉;alipay:支付宝小程序。说明:其它来源枚举值定义可联系支付宝运营人员添加。ext_infoorderextinfo是是否订单扩展字段。详情可查看下文 订单扩展字段。item_order_listitemorderinfo是否否商品信息列表,详情可查看下文 商品信息列表。trade_nostring否否否支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。amountprice选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)是否订单总金额:某笔交易订单优惠前的总金额,单位为【元】注意事项service_order且不涉及金额可不传入该字段,其他场景必传pay_amountprice选填,建议传入该参数否否用户应付金额 :用户最终结算时需要支付金额(不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】注意事项service_order且不涉及金额可不传入该字段,其他场景必传discount_amountprice否否否商户总计优惠金额:代表商户侧给予用户的总计优惠金额 (不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】。订单扩展字段开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_statusl ext_valuestring是是否订单状态,例:order_takenl ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为:ride_hailingl ext_keystring是否是订单详情地址 key。固定为 merchant_order_link_page。l ext_valuestring是否是商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185。l ext_keystring是否否商家小程序 appid key。固定为 tiny_app_id。l ext_valuestring是否否商家小程序 appid value。传入订单归属的小程序 appid。l ext_keystring是否否订单业务场景相关的信息 key。固定为 business_info。l ext_valuejsonstring是是否订单业务信息详情 value。入参详情见下文 业务信息参数。业务信息参数业务信息参数(business_info) 的各项入参详情如下:参数类型是否必填能否更新是否消息使用字段参数说明departure_addressstring是否是出发地merchant_display_namestring否否否商家展示名称driver_board_durationstring否否否车-上车地点时间is_third_partystring否否否是否三方订单is_promisedstring否否否是否承诺订单ride_price_typestring否否否计价方式tail_numberstring否否否字段名称:乘客尾号 字段说明:乘客的手机号后四位driver_board_distancestring否否否车-上车地点距离auto_modelstring否否否车型号destination_addressstring是否是目的地ride_hailing_typestring否否否打车方式ride_dest_durationstring否否否车-预计下车时间auto_colorstring否否否汽车颜色reservation_timestring否否否字段名称:预约出行时间 字段说明:预约出行时间,时间格式为 yyyy-mm-dd hh:mm:ss。service_start_timestring否否否字段名称:开始时间 字段说明:开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。ride_realtime_coststring否否否实时计费ride_typestring否否否打车服务类型ride_dest_distancestring否否否车-下车地点距离latest_board_timestring否否否字段名称:用户最晚上车时间 字段说明:用户最晚上车时间,时间格式为 yyyy-mm-dd hh:mm:ss。license_platestring是否是车牌号is_reassignmentstring否否否是否改派driver_contactstring否否否司机手机号estimated_coststring否否否预估车费third_party_namestring否否否三方服务商名称service_end_timestring否否否字段名称:结束时间 字段说明:结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。商品信息列表开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为:{商家名称} {商品名称} ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id。待上车 (to_board)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-待上车 (to_board)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否是外部订单号。由商家自定义。注意:同一笔订单更新状态时,需与首次同步入参一致。buyer_id(buyer_open_id)string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请。order_typestring是否否订单类型。固定为service_order(服务订单)。order_create_timestring是否否订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。order_modified_timestring是是否订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。source_appstring否否否订单来源,默认 alipay(支付宝小程序)。枚举支持:dingtalk:钉钉;alipay:支付宝小程序。说明:其它来源枚举值定义可联系支付宝运营人员添加。ext_infoorderextinfo是是否订单扩展字段。详情可查看下文 订单扩展字段。item_order_listitemorderinfo是否否商品信息列表,详情可查看下文 商品信息列表。trade_nostring否否否支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。amountprice选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)是否订单总金额:某笔交易订单优惠前的总金额,单位为【元】注意事项service_order且不涉及金额可不传入该字段,其他场景必传pay_amountprice选填,建议传入该参数否否用户应付金额 :用户最终结算时需要支付金额(不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】注意事项service_order且不涉及金额可不传入该字段,其他场景必传discount_amountprice否否否商户总计优惠金额:代表商户侧给予用户的总计优惠金额 (不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】。订单扩展字段开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_statusl ext_valuestring是是否订单状态,例:to_boardl ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为:ride_hailingl ext_keystring是否是订单详情地址 key。固定为 merchant_order_link_page。l ext_valuestring是否是商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185。l ext_keystring是否否商家小程序 appid key。固定为 tiny_app_id。l ext_valuestring是否否商家小程序 appid value。传入订单归属的小程序 appid。l ext_keystring是否否订单业务场景相关的信息 key。固定为 business_info。l ext_valuejsonstring是是否订单业务信息详情 value。入参详情见下文 业务信息参数。业务信息参数业务信息参数(business_info) 的各项入参详情如下:参数类型是否必填能否更新是否消息使用字段参数说明departure_addressstring是否是出发地merchant_display_namestring否否否商家展示名称driver_board_durationstring否否否车-上车地点时间is_third_partystring否否否是否三方订单is_promisedstring否否否是否承诺订单ride_price_typestring否否否计价方式tail_numberstring否否否字段名称:乘客尾号 字段说明:乘客的手机号后四位driver_board_distancestring否否否车-上车地点距离auto_modelstring否否否车型号destination_addressstring是否是目的地ride_hailing_typestring否否否打车方式ride_dest_durationstring否否否车-预计下车时间auto_colorstring否否否汽车颜色reservation_timestring否否否字段名称:预约出行时间 字段说明:预约出行时间,时间格式为 yyyy-mm-dd hh:mm:ss。service_start_timestring否否否字段名称:开始时间 字段说明:开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。ride_realtime_coststring否否否实时计费ride_typestring否否否打车服务类型ride_dest_distancestring否否否车-下车地点距离latest_board_timestring否否否字段名称:用户最晚上车时间 字段说明:用户最晚上车时间,时间格式为 yyyy-mm-dd hh:mm:ss。license_platestring是否是车牌号is_reassignmentstring否否否是否改派driver_contactstring否否否司机手机号estimated_coststring否否否预估车费third_party_namestring否否否三方服务商名称service_end_timestring否否否字段名称:结束时间 字段说明:结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。商品信息列表开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为:{商家名称} {商品名称} ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id。行程中 (serving)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-行程中 (serving)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否否外部订单号。由商家自定义。注意:同一笔订单更新状态时,需与首次同步入参一致。buyer_id(buyer_open_id)string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请。order_typestring是否否订单类型。固定为service_order(服务订单)。order_create_timestring是否否订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。order_modified_timestring是是否订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。source_appstring否否否订单来源,默认 alipay(支付宝小程序)。枚举支持:dingtalk:钉钉;alipay:支付宝小程序。说明:其它来源枚举值定义可联系支付宝运营人员添加。ext_infoorderextinfo是是否订单扩展字段。详情可查看下文 订单扩展字段。item_order_listitemorderinfo是否否商品信息列表,详情可查看下文 商品信息列表。trade_nostring否否否支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。amountprice选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)是否订单总金额:某笔交易订单优惠前的总金额,单位为【元】注意事项service_order且不涉及金额可不传入该字段,其他场景必传pay_amountprice选填,建议传入该参数否否用户应付金额 :用户最终结算时需要支付金额(不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】注意事项service_order且不涉及金额可不传入该字段,其他场景必传discount_amountprice否否否商户总计优惠金额:代表商户侧给予用户的总计优惠金额 (不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】。订单扩展字段开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_statusl ext_valuestring是是否订单状态,例:servingl ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为:ride_hailingl ext_keystring是否否订单详情地址 key。固定为 merchant_order_link_page。l ext_valuestring是否否商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185。l ext_keystring是否否商家小程序 appid key。固定为 tiny_app_id。l ext_valuestring是否否商家小程序 appid value。传入订单归属的小程序 appid。l ext_keystring是否否订单业务场景相关的信息 key。固定为 business_info。l ext_valuejsonstring是是否订单业务信息详情 value。入参详情见下文 业务信息参数。业务信息参数业务信息参数(business_info) 的各项入参详情如下:参数类型是否必填能否更新是否消息使用字段参数说明departure_addressstring是否否出发地merchant_display_namestring否否否商家展示名称driver_board_durationstring否否否车-上车地点时间is_third_partystring否否否是否三方订单is_promisedstring否否否是否承诺订单ride_price_typestring否否否计价方式tail_numberstring否否否字段名称:乘客尾号 字段说明:乘客的手机号后四位driver_board_distancestring否否否车-上车地点距离auto_modelstring否否否车型号destination_addressstring是否否目的地ride_hailing_typestring否否否打车方式ride_dest_durationstring否否否车-预计下车时间auto_colorstring否否否汽车颜色reservation_timestring否否否字段名称:预约出行时间 字段说明:预约出行时间,时间格式为 yyyy-mm-dd hh:mm:ss。service_start_timestring否否否字段名称:开始时间 字段说明:开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。ride_realtime_coststring否否否实时计费ride_typestring否否否打车服务类型ride_dest_distancestring否否否车-下车地点距离latest_board_timestring否否否字段名称:用户最晚上车时间 字段说明:用户最晚上车时间,时间格式为 yyyy-mm-dd hh:mm:ss。license_platestring否否否车牌号is_reassignmentstring否否否是否改派driver_contactstring否否否司机手机号estimated_coststring否否否预估车费third_party_namestring否否否三方服务商名称service_end_timestring否否否字段名称:结束时间 字段说明:结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。商品信息列表开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为:{商家名称} {商品名称} ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id。行程结束 (service_ended)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-行程结束 (service_ended)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否是外部订单号。由商家自定义。注意:同一笔订单更新状态时,需与首次同步入参一致。buyer_id(buyer_open_id)string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请。order_typestring是否否订单类型。固定为service_order(服务订单)。order_create_timestring是否否订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。order_modified_timestring是是否订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。source_appstring否否否订单来源,默认 alipay(支付宝小程序)。枚举支持:dingtalk:钉钉;alipay:支付宝小程序。说明:其它来源枚举值定义可联系支付宝运营人员添加。ext_infoorderextinfo是是否订单扩展字段。详情可查看下文 订单扩展字段。item_order_listitemorderinfo是否否商品信息列表,详情可查看下文 商品信息列表。trade_nostring否否否支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。amountprice选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)是否订单总金额:某笔交易订单优惠前的总金额,单位为【元】注意事项service_order且不涉及金额可不传入该字段,其他场景必传pay_amountprice选填,建议传入该参数否否用户应付金额 :用户最终结算时需要支付金额(不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】注意事项service_order且不涉及金额可不传入该字段,其他场景必传discount_amountprice否否否商户总计优惠金额:代表商户侧给予用户的总计优惠金额 (不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】。订单扩展字段开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_statusl ext_valuestring是是否订单状态,例:service_endedl ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为:ride_hailingl ext_keystring是否是订单详情地址 key。固定为 merchant_order_link_page。l ext_valuestring是否是商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185。l ext_keystring是否否商家小程序 appid key。固定为 tiny_app_id。l ext_valuestring是否否商家小程序 appid value。传入订单归属的小程序 appid。l ext_keystring是否否订单业务场景相关的信息 key。固定为 business_info。l ext_valuejsonstring是是否订单业务信息详情 value。入参详情见下文 业务信息参数。业务信息参数业务信息参数(business_info) 的各项入参详情如下:参数类型是否必填能否更新是否消息使用字段参数说明departure_addressstring是否是出发地merchant_display_namestring否否否商家展示名称driver_board_durationstring否否否车-上车地点时间is_third_partystring否否否是否三方订单is_promisedstring否否否是否承诺订单ride_price_typestring否否否计价方式tail_numberstring否否否字段名称:乘客尾号 字段说明:乘客的手机号后四位driver_board_distancestring否否否车-上车地点距离auto_modelstring否否否车型号destination_addressstring是否是目的地ride_hailing_typestring否否否打车方式ride_dest_durationstring否否否车-预计下车时间auto_colorstring否否否汽车颜色reservation_timestring否否否字段名称:预约出行时间 字段说明:预约出行时间,时间格式为 yyyy-mm-dd hh:mm:ss。service_start_timestring否否否字段名称:开始时间 字段说明:开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。ride_realtime_coststring否否否实时计费ride_typestring否否否打车服务类型ride_dest_distancestring否否否车-下车地点距离latest_board_timestring否否否字段名称:用户最晚上车时间 字段说明:用户最晚上车时间,时间格式为 yyyy-mm-dd hh:mm:ss。license_platestring是否是车牌号is_reassignmentstring否否否是否改派driver_contactstring否否否司机手机号estimated_coststring否否否预估车费third_party_namestring否否否三方服务商名称service_end_timestring否否否字段名称:结束时间 字段说明:结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。商品信息列表开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为:{商家名称} {商品名称} ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id。待支付 (wait_pay)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-待支付 (wait_pay)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否是外部订单号。由商家自定义。注意:同一笔订单更新状态时,需与首次同步入参一致。buyer_id(buyer_open_id)string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请。order_typestring是否否订单类型。固定为service_order(服务订单)。order_create_timestring是否是订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。order_modified_timestring是是否订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。source_appstring否否否订单来源,默认 alipay(支付宝小程序)。枚举支持:dingtalk:钉钉;alipay:支付宝小程序。说明:其它来源枚举值定义可联系支付宝运营人员添加。ext_infoorderextinfo是是否订单扩展字段。详情可查看下文 订单扩展字段。item_order_listitemorderinfo是否否商品信息列表,详情可查看下文 商品信息列表。trade_nostring否否否支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。amountprice选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)是否订单总金额:某笔交易订单优惠前的总金额,单位为【元】注意事项service_order且不涉及金额可不传入该字段,其他场景必传pay_amountprice选填,建议传入该参数否否用户应付金额 :用户最终结算时需要支付金额(不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】注意事项service_order且不涉及金额可不传入该字段,其他场景必传discount_amountprice否否否商户总计优惠金额:代表商户侧给予用户的总计优惠金额 (不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】。订单扩展字段开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_statusl ext_valuestring是是否订单状态,例:wait_payl ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为:ride_hailingl ext_keystring是否是订单详情地址 key。固定为 merchant_order_link_page。l ext_valuestring是否是商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185。l ext_keystring是否否商家小程序 appid key。固定为 tiny_app_id。l ext_valuestring是否否商家小程序 appid value。传入订单归属的小程序 appid。l ext_keystring是否否订单业务场景相关的信息 key。固定为 business_info。l ext_valuejsonstring是是否订单业务信息详情 value。入参详情见下文 业务信息参数。业务信息参数业务信息参数(business_info) 的各项入参详情如下:参数类型是否必填能否更新是否消息使用字段参数说明departure_addressstring是否是出发地merchant_display_namestring否否否商家展示名称driver_board_durationstring否否否车-上车地点时间is_third_partystring否否否是否三方订单is_promisedstring否否否是否承诺订单ride_price_typestring否否否计价方式tail_numberstring否否否字段名称:乘客尾号 字段说明:乘客的手机号后四位driver_board_distancestring否否否车-上车地点距离auto_modelstring否否否车型号destination_addressstring是否是目的地ride_hailing_typestring否否否打车方式ride_dest_durationstring否否否车-预计下车时间auto_colorstring否否否汽车颜色reservation_timestring否否否字段名称:预约出行时间 字段说明:预约出行时间,时间格式为 yyyy-mm-dd hh:mm:ss。service_start_timestring否否否字段名称:开始时间 字段说明:开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。ride_realtime_coststring否否否实时计费ride_typestring否否否打车服务类型ride_dest_distancestring否否否车-下车地点距离latest_board_timestring否否否字段名称:用户最晚上车时间 字段说明:用户最晚上车时间,时间格式为 yyyy-mm-dd hh:mm:ss。license_platestring否否否车牌号is_reassignmentstring否否否是否改派driver_contactstring否否否司机手机号estimated_coststring否否否预估车费third_party_namestring否否否三方服务商名称service_end_timestring否否否字段名称:结束时间 字段说明:结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。商品信息列表开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为:{商家名称} {商品名称} ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id。已完成 (finished)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-已完成 (finished)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否否外部订单号。由商家自定义。注意:同一笔订单更新状态时,需与首次同步入参一致。buyer_id(buyer_open_id)string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请。order_typestring是否否订单类型。固定为service_order(服务订单)。order_create_timestring是否否订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。order_modified_timestring是是否订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。source_appstring否否否订单来源,默认 alipay(支付宝小程序)。枚举支持:dingtalk:钉钉;alipay:支付宝小程序。说明:其它来源枚举值定义可联系支付宝运营人员添加。ext_infoorderextinfo是是否订单扩展字段。详情可查看下文 订单扩展字段。item_order_listitemorderinfo是否否商品信息列表,详情可查看下文 商品信息列表。trade_nostring否否否支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。amountprice选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)是否订单总金额:某笔交易订单优惠前的总金额,单位为【元】注意事项service_order且不涉及金额可不传入该字段,其他场景必传pay_amountprice选填,建议传入该参数否否用户应付金额 :用户最终结算时需要支付金额(不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】注意事项service_order且不涉及金额可不传入该字段,其他场景必传discount_amountprice否否否商户总计优惠金额:代表商户侧给予用户的总计优惠金额 (不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】。订单扩展字段开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_statusl ext_valuestring是是否订单状态,例:finishedl ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为:ride_hailingl ext_keystring是否否订单详情地址 key。固定为 merchant_order_link_page。l ext_valuestring是否否商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185。l ext_keystring是否否商家小程序 appid key。固定为 tiny_app_id。l ext_valuestring是否否商家小程序 appid value。传入订单归属的小程序 appid。l ext_keystring是否否订单业务场景相关的信息 key。固定为 business_info。l ext_valuejsonstring是是否订单业务信息详情 value。入参详情见下文 业务信息参数。业务信息参数业务信息参数(business_info) 的各项入参详情如下:参数类型是否必填能否更新是否消息使用字段参数说明departure_addressstring是否否出发地merchant_display_namestring否否否商家展示名称driver_board_durationstring否否否车-上车地点时间is_third_partystring否否否是否三方订单is_promisedstring否否否是否承诺订单ride_price_typestring否否否计价方式tail_numberstring否否否字段名称:乘客尾号 字段说明:乘客的手机号后四位driver_board_distancestring否否否车-上车地点距离auto_modelstring否否否车型号destination_addressstring是否否目的地ride_hailing_typestring否否否打车方式ride_dest_durationstring否否否车-预计下车时间auto_colorstring否否否汽车颜色reservation_timestring否否否字段名称:预约出行时间 字段说明:预约出行时间,时间格式为 yyyy-mm-dd hh:mm:ss。service_start_timestring否否否字段名称:开始时间 字段说明:开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。ride_realtime_coststring否否否实时计费ride_typestring否否否打车服务类型ride_dest_distancestring否否否车-下车地点距离latest_board_timestring否否否字段名称:用户最晚上车时间 字段说明:用户最晚上车时间,时间格式为 yyyy-mm-dd hh:mm:ss。license_platestring否否否车牌号is_reassignmentstring否否否是否改派driver_contactstring否否否司机手机号estimated_coststring否否否预估车费third_party_namestring否否否三方服务商名称service_end_timestring否否否字段名称:结束时间 字段说明:结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。商品信息列表开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为:{商家名称} {商品名称} ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id。已取消 (closed)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-已取消 (closed)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否是外部订单号。由商家自定义。注意:同一笔订单更新状态时,需与首次同步入参一致。buyer_id(buyer_open_id)string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请。order_typestring是否否订单类型。固定为service_order(服务订单)。order_create_timestring是否是订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。order_modified_timestring是是否订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。source_appstring否否否订单来源,默认 alipay(支付宝小程序)。枚举支持:dingtalk:钉钉;alipay:支付宝小程序。说明:其它来源枚举值定义可联系支付宝运营人员添加。ext_infoorderextinfo是是否订单扩展字段。详情可查看下文 订单扩展字段。item_order_listitemorderinfo是否否商品信息列表,详情可查看下文 商品信息列表。trade_nostring否否否支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。amountprice选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)是否订单总金额:某笔交易订单优惠前的总金额,单位为【元】注意事项service_order且不涉及金额可不传入该字段,其他场景必传pay_amountprice选填,建议传入该参数否否用户应付金额 :用户最终结算时需要支付金额(不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】注意事项service_order且不涉及金额可不传入该字段,其他场景必传discount_amountprice否否否商户总计优惠金额:代表商户侧给予用户的总计优惠金额 (不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】。订单扩展字段开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_statusl ext_valuestring是是否订单状态,例:closedl ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为:ride_hailingl ext_keystring是否是订单详情地址 key。固定为 merchant_order_link_page。l ext_valuestring是否是商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185。l ext_keystring是否否商家小程序 appid key。固定为 tiny_app_id。l ext_valuestring是否否商家小程序 appid value。传入订单归属的小程序 appid。l ext_keystring是否否订单业务场景相关的信息 key。固定为 business_info。l ext_valuejsonstring是是否订单业务信息详情 value。入参详情见下文 业务信息参数。业务信息参数业务信息参数(business_info) 的各项入参详情如下:参数类型是否必填能否更新是否消息使用字段参数说明departure_addressstring是否是出发地merchant_display_namestring否否否商家展示名称driver_board_durationstring否否否车-上车地点时间is_third_partystring否否否是否三方订单is_promisedstring否否否是否承诺订单ride_price_typestring否否否计价方式tail_numberstring否否否字段名称:乘客尾号 字段说明:乘客的手机号后四位driver_board_distancestring否否否车-上车地点距离auto_modelstring否否否车型号destination_addressstring是否是目的地ride_hailing_typestring否否否打车方式ride_dest_durationstring否否否车-预计下车时间auto_colorstring否否否汽车颜色reservation_timestring否否否字段名称:预约出行时间 字段说明:预约出行时间,时间格式为 yyyy-mm-dd hh:mm:ss。service_start_timestring否否否字段名称:开始时间 字段说明:开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。ride_realtime_coststring否否否实时计费ride_typestring否否否打车服务类型ride_dest_distancestring否否否车-下车地点距离latest_board_timestring否否否字段名称:用户最晚上车时间 字段说明:用户最晚上车时间,时间格式为 yyyy-mm-dd hh:mm:ss。license_platestring否否否车牌号is_reassignmentstring否否否是否改派driver_contactstring否否否司机手机号estimated_coststring否否否预估车费third_party_namestring否否否三方服务商名称service_end_timestring否否否字段名称:结束时间 字段说明:结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。商品信息列表开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为:{商家名称} {商品名称} ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id。实现订单实时信息查询接口详情 商家同步订单到订单中心,在 c 端场景需要透传订单相关的实时信息时,需实现,支付宝会调用此接口查询商家侧对应订单实时信息(例如:司机距离、位置等)展示给用户。●接入指南:●接口详情:post支付宝请求字段支付宝将在请求 body 中传递如下字段给商家。参数类型是否必填最大长度描述示例值merchant_order_nostring特殊可选128外部订单号:商家自己系统内的订单 id,需与商家同步支付宝订单中心入参的商户订单 id 相同。单笔查询必须传入该字段。7695428890423merchant_order_nosstring特殊可选2000逗号分隔的外部订单号:商家自己系统内的订单 id,需与商家同步支付宝订单中心入参的商户订单 id 相同。一般会控制在20个之内,如果需要支持批量查询能力该字段必传。7695428890423,7695428890424,7695428890425约定返回字段公共响应字段参数类型是否必填最大长度描述示例值successstring必填10是否成功查询到数据,值为true/falsetrueresultstring选填30000可查看下方表格业务字段{\"driver_board_duration\":\"2020-07-01 16:50:05\",\"driver_board_distance\":\"400\",\"ride_realtime_cost\":\"16.8\"}error_codestring选填128商家自定义的错误码,当 success 为 false 时必填,便于排查问题,可查看文档示例的错误码来定义。biz_error(固定值)error_descstring选填128商家自定义错误码对应的描述,当 success 为 false 时必填,便于排查问题。当前订单不在进行中状态业务响应字段已接单(order_taken)状态涉及动态字段如下:参数类型是否必填能否更新参数说明driver_board_distancestring否是车-上车地点距离,单位为 米。-1 代表字段值无效。driver_board_durationstring否是车-上车地点时间,时间格式为 yyyy-mm-dd hh:mm:ss。ride_realtime_coststring否是实时计费,单位为 元,如:12.8。-1代表字段值无效,出租车没有实时计价。待上车(to_board)状态,涉及动态字段如下参数类型是否必填能否更新参数说明latest_board_timestring否是用户最晚上车时间,时间格式为 yyyy-mm-dd hh:mm:ss。ride_dest_distancestring否是车-下车地点距离,单位为 米。-1 代表字段值无效。ride_dest_durationstring否是车-预计下车时间,时间格式为 yyyy-mm-dd hh:mm:ss。行程中(serving)状态,涉及动态字段如下:参数类型是否必填能否更新参数说明ride_dest_distancestring否是车-下车地点距离,单位为 米。-1 代表字段值无效。ride_dest_durationstring否是车-预计下车时间,时间格式为 yyyy-mm-dd hh:mm:ss。ride_realtime_coststring否是实时计费,单位为 元,如:12.8。-1代表字段值无效,出租车没有实时计价。响应示例已接单(order_taken)状态若对应订单状态等情况正常,可按如下规范响应。待上车(to_board)状态行程中(serving)状态订单状态异常若对应订单状态异常,如:当前订单不在进行中状态等情况,可按如下规范响应。 商家业务异常若商家业务系统没有当前订单或者验签失败时可按如下规范响应。