更新时间:2024-12-13 09:52:31配置项检测工具收藏订阅更新我的文档设置接入检测(即可查看检测结果)若有未通过的接入检测项,接口将无法调通去登录返回文档商家需通过 alipay.merchant.order.sync(订单数据同步接口) 订单扩展字段 ext_info#merchant_order_status 参数更新订单状态,具体状态说明如下。订单状态流转说明订单状态说明●支持跨状态传递,如:create (已下单) 可直接跳转至 received (已揽收) 。●不要求首次同步订单状态必须为 create (已下单) 。●订单状态发生变更后,需要及时同步最新状态。●当前场景定义的订单状态(中文和英文名)如下:状态中文名状态英文名是否为有效订单核心状态是否发送服务消息是否发送push已下单create是是否待支付wait_pay否是是寄件待揽收to_take是否否支付完成paid否否否寄件开始运输in_delivery是否否已取消cancelled否是是已退款refunded否是是已签收signed否是是已揽收received是否否注意:不同订单状态,仅 是否发送服务消息 为 是 时,用户才能在消息列表(支付宝凯发k8官方网娱乐官方首页服务提醒入口进入或凯发k8官方网娱乐官方首页底部消息tab进入)查看服务订单消息提醒。状态机流转订单状态机流转如下(左侧表示起始状态,右侧表示允许的后置状态)当前状态允许的后置状态create(已下单)create/已下单、 to_take/寄件待揽收、 cancelled/已取消、 refunded/已退款、 paid/支付完成、 signed/已签收、 in_delivery/寄件开始运输、 received/已揽收、 wait_pay/待支付wait_pay(待支付)create/已下单、 to_take/寄件待揽收、 cancelled/已取消、 refunded/已退款、 paid/支付完成、 signed/已签收、 in_delivery/寄件开始运输、 received/已揽收、 wait_pay/待支付to_take(寄件待揽收)to_take/寄件待揽收、 cancelled/已取消、 refunded/已退款、 paid/支付完成、 signed/已签收、 in_delivery/寄件开始运输、 received/已揽收、 wait_pay/待支付paid(支付完成)cancelled/已取消、 refunded/已退款、 paid/支付完成、 signed/已签收、 in_delivery/寄件开始运输、 received/已揽收in_delivery(寄件开始运输)refunded/已退款、 paid/支付完成、 signed/已签收、 in_delivery/寄件开始运输、 received/已揽收、 wait_pay/待支付cancelled(已取消)cancelled/已取消、 refunded/已退款refunded(已退款)refunded/已退款signed(已签收)paid/支付完成、 signed/已签收、 wait_pay/待支付received(已揽收)cancelled/已取消、 refunded/已退款、 paid/支付完成、 signed/已签收、 in_delivery/寄件开始运输、 received/已揽收、 wait_pay/待支付不同状态参数使用说明已下单 (create)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-已下单 (create)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否是外部订单号。由商家自定义。 注意:同一笔订单更新状态时,需与首次同步入参一致。buyer_idstring是否否支付宝用户 uid。2088 开头的数字。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相同的两次同步会被幂等处理。category_idstring否否否支付宝标准服务类目code,本模板支持类目code:c000003527service_codestring否否否服务code:传入小程序后台提报的服务id,将订单与服务关联。service_code 通过 alipay.open.app.service.apply(服务提报申请)接口提报服务后获取。source_appstring否否否订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其他来源枚举值定义联系支付宝订单中心添加。trade_nostring否否否支付宝交易号。注意:若该状态传递了trade_no,则同步该订单的后续状态时都需要传递trade_no。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。amountprice选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)是否订单总金额:某笔交易订单优惠前的总金额,单位为【元】注意事项service_order且不涉及金额可不传入该字段,其他场景必传pay_amountprice选填,建议传入该参数否否用户应付金额 :用户最终结算时需要支付金额(不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】注意事项service_order且不涉及金额可不传入该字段,其他场景必传discount_amountprice否否否商户总计优惠金额:代表商户侧给予用户的总计优惠金额 (不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】。logistics_info_liststring否否否item_order_listitemorderinfo是否否商品信息列表。详见下文: 商品信息列表ext_infoorderextinfo是是否订单扩展字段。详见下文 订单扩展字段。订单扩展字段开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:参数参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_statusl ext_valuestring是是否订单状态, 例: createl ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: order_sendl ext_keystring是否是订单详情地址 key。固定为merchant_order_link_page,一笔订单同步过程中需要保持一致。l ext_valuestring是否是商户小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。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) 的各项入参详情如下:参数参数类型是否必填能否更新是否消息使用字段参数说明signed_timestring否否否字段名称:签收时间字段说明:签收的时间点,时间格式为 yyyy-mm-dd hh:mm:ss。send_addressstring否否否字段名称:寄件地址字段说明:寄件地址,企业码专用open_timestring否否否字段名称:驿站营业开始时间 字段说明:【驿站寄件】类型必填,时间格式为 yyyy-mm-dd hh:mm:ss。order_timestring否否否字段名称:下单时间字段说明:下单的时间点,企业码专用,时间格式为 yyyy-mm-dd hh:mm:ss。express_companystring否否否快递公司名send_phonestring否否否字段名称:寄件人电话字段说明:寄件人的电话号码,企业码专用send_codestring否否是寄件码take_namestring否否否字段名称:收件人姓名字段说明:收件人的姓名;企业码专用closing_timestring否否否字段名称:驿站营业关门时间 字段说明:【驿站寄件】类型必填,时间格式为 yyyy-mm-dd hh:mm:ss。take_phonestring否否否字段名称:收件人电话字段说明:收件人的电话号码,企业码专用take_timestring否否否字段名称:揽件时间字段说明:揽件的时间点,企业码专用,时间格式为 yyyy-mm-dd hh:mm:ss。door_start_timestring否否否字段名称:预计上门开始时间 字段说明:【上门取件】类型必填,时间格式为 yyyy-mm-dd hh:mm:ss。talke_addressstring否否否字段名称:收件地址字段说明:收件地址,企业码专用door_end_timestring否否否字段名称:预计上门结束时间 字段说明:【上门取件】类型必填,时间格式为 yyyy-mm-dd hh:mm:ss。phonestring否否否字段名称:快递员电话字段说明:虚拟号send_namestring否否否字段名称:寄件人姓名字段说明:寄件人的姓名,企业码专用商品信息列表开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:参数参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为:{商家名称} {商品名称} ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id物流信息若商家想在订单中展示物流信息,可通过物流信息(logistics_info_list)同步。参数说明如下:参数参数类型是否必填能否更新是否消息使用字段参数说明logistics_codestring否否否字段名称:物流公司字段说明:物流公司编码:tracking_nostring否否否物流单号待支付 (wait_pay)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-待支付 (wait_pay)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否否外部订单号。由商家自定义。 注意:同一笔订单更新状态时,需与首次同步入参一致。buyer_idstring是否否支付宝用户 uid。2088 开头的数字。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相同的两次同步会被幂等处理。category_idstring否否否支付宝标准服务类目code,本模板支持类目code:c000003527service_codestring否否否服务code:传入小程序后台提报的服务id,将订单与服务关联。service_code 通过 alipay.open.app.service.apply(服务提报申请)接口提报服务后获取。source_appstring否否否订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其他来源枚举值定义联系支付宝订单中心添加。trade_nostring否否否支付宝交易号。注意:若该状态传递了trade_no,则同步该订单的后续状态时都需要传递trade_no。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。amountprice选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)是否订单总金额:某笔交易订单优惠前的总金额,单位为【元】注意事项service_order且不涉及金额可不传入该字段,其他场景必传pay_amountprice选填,建议传入该参数否否用户应付金额 :用户最终结算时需要支付金额(不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】注意事项service_order且不涉及金额可不传入该字段,其他场景必传discount_amountprice否否否商户总计优惠金额:代表商户侧给予用户的总计优惠金额 (不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】。logistics_info_liststring否否否item_order_listitemorderinfo是否否商品信息列表。详见下文: 商品信息列表ext_infoorderextinfo是是否订单扩展字段。详见下文 订单扩展字段。订单扩展字段开发者需通过订单扩展字段(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。本业务场景为: order_sendl ext_keystring是否是订单详情地址 key。固定为merchant_order_link_page,一笔订单同步过程中需要保持一致。l ext_valuestring是否是商户小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。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) 的各项入参详情如下:参数参数类型是否必填能否更新是否消息使用字段参数说明signed_timestring否否否字段名称:签收时间字段说明:签收的时间点,时间格式为 yyyy-mm-dd hh:mm:ss。send_addressstring否否否字段名称:寄件地址字段说明:寄件地址,企业码专用open_timestring否否否字段名称:驿站营业开始时间 字段说明:【驿站寄件】类型必填,时间格式为 yyyy-mm-dd hh:mm:ss。order_timestring否否否字段名称:下单时间字段说明:下单的时间点,企业码专用,时间格式为 yyyy-mm-dd hh:mm:ss。express_companystring否否是快递公司名send_phonestring否否否字段名称:寄件人电话字段说明:寄件人的电话号码,企业码专用send_codestring否否是寄件码take_namestring否否否字段名称:收件人姓名字段说明:收件人的姓名;企业码专用closing_timestring否否否字段名称:驿站营业关门时间 字段说明:【驿站寄件】类型必填,时间格式为 yyyy-mm-dd hh:mm:ss。take_phonestring否否否字段名称:收件人电话字段说明:收件人的电话号码,企业码专用take_timestring否否否字段名称:揽件时间字段说明:揽件的时间点,企业码专用,时间格式为 yyyy-mm-dd hh:mm:ss。door_start_timestring否否否字段名称:预计上门开始时间 字段说明:【上门取件】类型必填,时间格式为 yyyy-mm-dd hh:mm:ss。talke_addressstring否否否字段名称:收件地址字段说明:收件地址,企业码专用door_end_timestring否否否字段名称:预计上门结束时间 字段说明:【上门取件】类型必填,时间格式为 yyyy-mm-dd hh:mm:ss。phonestring否否否字段名称:快递员电话字段说明:虚拟号send_namestring否否否字段名称:寄件人姓名字段说明:寄件人的姓名,企业码专用商品信息列表开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:参数参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为:{商家名称} {商品名称} ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id物流信息若商家想在订单中展示物流信息,可通过物流信息(logistics_info_list)同步。参数说明如下:参数参数类型是否必填能否更新是否消息使用字段参数说明logistics_codestring否否否字段名称:物流公司字段说明:物流公司编码:tracking_nostring否否否物流单号寄件待揽收 (to_take)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-寄件待揽收 (to_take)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否否外部订单号。由商家自定义。 注意:同一笔订单更新状态时,需与首次同步入参一致。buyer_idstring是否否支付宝用户 uid。2088 开头的数字。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相同的两次同步会被幂等处理。category_idstring否否否支付宝标准服务类目code,本模板支持类目code:c000003527service_codestring否否否服务code:传入小程序后台提报的服务id,将订单与服务关联。service_code 通过 alipay.open.app.service.apply(服务提报申请)接口提报服务后获取。source_appstring否否否订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其他来源枚举值定义联系支付宝订单中心添加。trade_nostring否否否支付宝交易号。注意:若该状态传递了trade_no,则同步该订单的后续状态时都需要传递trade_no。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。amountprice选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)是否订单总金额:某笔交易订单优惠前的总金额,单位为【元】注意事项service_order且不涉及金额可不传入该字段,其他场景必传pay_amountprice选填,建议传入该参数否否用户应付金额 :用户最终结算时需要支付金额(不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】注意事项service_order且不涉及金额可不传入该字段,其他场景必传discount_amountprice否否否商户总计优惠金额:代表商户侧给予用户的总计优惠金额 (不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】。logistics_info_liststring否否否item_order_listitemorderinfo是否否商品信息列表。详见下文: 商品信息列表ext_infoorderextinfo是是否订单扩展字段。详见下文 订单扩展字段。订单扩展字段开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:参数参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_statusl ext_valuestring是是否订单状态, 例: to_takel ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: order_sendl ext_keystring是否否订单详情地址 key。固定为merchant_order_link_page,一笔订单同步过程中需要保持一致。l ext_valuestring是否否商户小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。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) 的各项入参详情如下:参数参数类型是否必填能否更新是否消息使用字段参数说明signed_timestring否否否字段名称:签收时间字段说明:签收的时间点,时间格式为 yyyy-mm-dd hh:mm:ss。send_addressstring否否否字段名称:寄件地址字段说明:寄件地址,企业码专用open_timestring否否否字段名称:驿站营业开始时间 字段说明:【驿站寄件】类型必填,时间格式为 yyyy-mm-dd hh:mm:ss。order_timestring否否否字段名称:下单时间字段说明:下单的时间点,企业码专用,时间格式为 yyyy-mm-dd hh:mm:ss。express_companystring否否否快递公司名send_phonestring否否否字段名称:寄件人电话字段说明:寄件人的电话号码,企业码专用send_codestring否否否寄件码take_namestring否否否字段名称:收件人姓名字段说明:收件人的姓名;企业码专用closing_timestring否否否字段名称:驿站营业关门时间 字段说明:【驿站寄件】类型必填,时间格式为 yyyy-mm-dd hh:mm:ss。take_phonestring否否否字段名称:收件人电话字段说明:收件人的电话号码,企业码专用take_timestring否否否字段名称:揽件时间字段说明:揽件的时间点,企业码专用,时间格式为 yyyy-mm-dd hh:mm:ss。door_start_timestring否否否字段名称:预计上门开始时间 字段说明:【上门取件】类型必填,时间格式为 yyyy-mm-dd hh:mm:ss。talke_addressstring否否否字段名称:收件地址字段说明:收件地址,企业码专用door_end_timestring否否否字段名称:预计上门结束时间 字段说明:【上门取件】类型必填,时间格式为 yyyy-mm-dd hh:mm:ss。phonestring否否否字段名称:快递员电话字段说明:虚拟号send_namestring否否否字段名称:寄件人姓名字段说明:寄件人的姓名,企业码专用商品信息列表开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:参数参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为:{商家名称} {商品名称} ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id物流信息若商家想在订单中展示物流信息,可通过物流信息(logistics_info_list)同步。参数说明如下:参数参数类型是否必填能否更新是否消息使用字段参数说明logistics_codestring否否否字段名称:物流公司字段说明:物流公司编码:tracking_nostring否否否物流单号支付完成 (paid)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-支付完成 (paid)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否否外部订单号。由商家自定义。 注意:同一笔订单更新状态时,需与首次同步入参一致。buyer_idstring是否否支付宝用户 uid。2088 开头的数字。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相同的两次同步会被幂等处理。category_idstring否否否支付宝标准服务类目code,本模板支持类目code:c000003527service_codestring否否否服务code:传入小程序后台提报的服务id,将订单与服务关联。service_code 通过 alipay.open.app.service.apply(服务提报申请)接口提报服务后获取。source_appstring否否否订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其他来源枚举值定义联系支付宝订单中心添加。trade_nostring否否否支付宝交易号。注意:若该状态传递了trade_no,则同步该订单的后续状态时都需要传递trade_no。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。amountprice选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)是否订单总金额:某笔交易订单优惠前的总金额,单位为【元】注意事项service_order且不涉及金额可不传入该字段,其他场景必传pay_amountprice选填,建议传入该参数否否用户应付金额 :用户最终结算时需要支付金额(不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】注意事项service_order且不涉及金额可不传入该字段,其他场景必传discount_amountprice否否否商户总计优惠金额:代表商户侧给予用户的总计优惠金额 (不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】。logistics_info_liststring否否否item_order_listitemorderinfo是否否商品信息列表。详见下文: 商品信息列表ext_infoorderextinfo是是否订单扩展字段。详见下文 订单扩展字段。订单扩展字段开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:参数参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_statusl ext_valuestring是是否订单状态, 例: paidl ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: order_sendl ext_keystring是否否订单详情地址 key。固定为merchant_order_link_page,一笔订单同步过程中需要保持一致。l ext_valuestring是否否商户小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。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) 的各项入参详情如下:参数参数类型是否必填能否更新是否消息使用字段参数说明signed_timestring否否否字段名称:签收时间字段说明:签收的时间点,时间格式为 yyyy-mm-dd hh:mm:ss。send_addressstring否否否字段名称:寄件地址字段说明:寄件地址,企业码专用open_timestring否否否字段名称:驿站营业开始时间 字段说明:【驿站寄件】类型必填,时间格式为 yyyy-mm-dd hh:mm:ss。order_timestring否否否字段名称:下单时间字段说明:下单的时间点,企业码专用,时间格式为 yyyy-mm-dd hh:mm:ss。express_companystring否否否快递公司名send_phonestring否否否字段名称:寄件人电话字段说明:寄件人的电话号码,企业码专用send_codestring否否否寄件码take_namestring否否否字段名称:收件人姓名字段说明:收件人的姓名;企业码专用closing_timestring否否否字段名称:驿站营业关门时间 字段说明:【驿站寄件】类型必填,时间格式为 yyyy-mm-dd hh:mm:ss。take_phonestring否否否字段名称:收件人电话字段说明:收件人的电话号码,企业码专用take_timestring否否否字段名称:揽件时间字段说明:揽件的时间点,企业码专用,时间格式为 yyyy-mm-dd hh:mm:ss。door_start_timestring否否否字段名称:预计上门开始时间 字段说明:【上门取件】类型必填,时间格式为 yyyy-mm-dd hh:mm:ss。talke_addressstring否否否字段名称:收件地址字段说明:收件地址,企业码专用door_end_timestring否否否字段名称:预计上门结束时间 字段说明:【上门取件】类型必填,时间格式为 yyyy-mm-dd hh:mm:ss。phonestring否否否字段名称:快递员电话字段说明:虚拟号send_namestring否否否字段名称:寄件人姓名字段说明:寄件人的姓名,企业码专用商品信息列表开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:参数参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为:{商家名称} {商品名称} ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id物流信息若商家想在订单中展示物流信息,可通过物流信息(logistics_info_list)同步。参数说明如下:参数参数类型是否必填能否更新是否消息使用字段参数说明logistics_codestring否否否字段名称:物流公司字段说明:物流公司编码:tracking_nostring否否否物流单号寄件开始运输 (in_delivery)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-寄件开始运输 (in_delivery)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否否外部订单号。由商家自定义。 注意:同一笔订单更新状态时,需与首次同步入参一致。buyer_idstring是否否支付宝用户 uid。2088 开头的数字。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相同的两次同步会被幂等处理。category_idstring否否否支付宝标准服务类目code,本模板支持类目code:c000003527service_codestring否否否服务code:传入小程序后台提报的服务id,将订单与服务关联。service_code 通过 alipay.open.app.service.apply(服务提报申请)接口提报服务后获取。source_appstring否否否订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其他来源枚举值定义联系支付宝订单中心添加。trade_nostring否否否支付宝交易号。注意:若该状态传递了trade_no,则同步该订单的后续状态时都需要传递trade_no。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。amountprice选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)是否订单总金额:某笔交易订单优惠前的总金额,单位为【元】注意事项service_order且不涉及金额可不传入该字段,其他场景必传pay_amountprice选填,建议传入该参数否否用户应付金额 :用户最终结算时需要支付金额(不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】注意事项service_order且不涉及金额可不传入该字段,其他场景必传discount_amountprice否否否商户总计优惠金额:代表商户侧给予用户的总计优惠金额 (不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】。logistics_info_liststring否否否item_order_listitemorderinfo是否否商品信息列表。详见下文: 商品信息列表ext_infoorderextinfo是是否订单扩展字段。详见下文 订单扩展字段。订单扩展字段开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:参数参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_statusl ext_valuestring是是否订单状态, 例: in_deliveryl ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: order_sendl ext_keystring是否否订单详情地址 key。固定为merchant_order_link_page,一笔订单同步过程中需要保持一致。l ext_valuestring是否否商户小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。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) 的各项入参详情如下:参数参数类型是否必填能否更新是否消息使用字段参数说明signed_timestring否否否字段名称:签收时间字段说明:签收的时间点,时间格式为 yyyy-mm-dd hh:mm:ss。send_addressstring否否否字段名称:寄件地址字段说明:寄件地址,企业码专用open_timestring否否否字段名称:驿站营业开始时间 字段说明:【驿站寄件】类型必填,时间格式为 yyyy-mm-dd hh:mm:ss。order_timestring否否否字段名称:下单时间字段说明:下单的时间点,企业码专用,时间格式为 yyyy-mm-dd hh:mm:ss。express_companystring否否否快递公司名send_phonestring否否否字段名称:寄件人电话字段说明:寄件人的电话号码,企业码专用send_codestring否否否寄件码take_namestring否否否字段名称:收件人姓名字段说明:收件人的姓名;企业码专用closing_timestring否否否字段名称:驿站营业关门时间 字段说明:【驿站寄件】类型必填,时间格式为 yyyy-mm-dd hh:mm:ss。take_phonestring否否否字段名称:收件人电话字段说明:收件人的电话号码,企业码专用take_timestring否否否字段名称:揽件时间字段说明:揽件的时间点,企业码专用,时间格式为 yyyy-mm-dd hh:mm:ss。door_start_timestring否否否字段名称:预计上门开始时间 字段说明:【上门取件】类型必填,时间格式为 yyyy-mm-dd hh:mm:ss。talke_addressstring否否否字段名称:收件地址字段说明:收件地址,企业码专用door_end_timestring否否否字段名称:预计上门结束时间 字段说明:【上门取件】类型必填,时间格式为 yyyy-mm-dd hh:mm:ss。phonestring否否否字段名称:快递员电话字段说明:虚拟号send_namestring否否否字段名称:寄件人姓名字段说明:寄件人的姓名,企业码专用商品信息列表开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:参数参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为:{商家名称} {商品名称} ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id物流信息若商家想在订单中展示物流信息,可通过物流信息(logistics_info_list)同步。参数说明如下:参数参数类型是否必填能否更新是否消息使用字段参数说明logistics_codestring否否否字段名称:物流公司字段说明:物流公司编码:tracking_nostring否否否物流单号已取消 (cancelled)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-已取消 (cancelled)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否是外部订单号。由商家自定义。 注意:同一笔订单更新状态时,需与首次同步入参一致。buyer_idstring是否否支付宝用户 uid。2088 开头的数字。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相同的两次同步会被幂等处理。category_idstring否否否支付宝标准服务类目code,本模板支持类目code:c000003527service_codestring否否否服务code:传入小程序后台提报的服务id,将订单与服务关联。service_code 通过 alipay.open.app.service.apply(服务提报申请)接口提报服务后获取。source_appstring否否否订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其他来源枚举值定义联系支付宝订单中心添加。trade_nostring否否否支付宝交易号。注意:若该状态传递了trade_no,则同步该订单的后续状态时都需要传递trade_no。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。amountprice选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)是否订单总金额:某笔交易订单优惠前的总金额,单位为【元】注意事项service_order且不涉及金额可不传入该字段,其他场景必传pay_amountprice选填,建议传入该参数否否用户应付金额 :用户最终结算时需要支付金额(不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】注意事项service_order且不涉及金额可不传入该字段,其他场景必传discount_amountprice否否否商户总计优惠金额:代表商户侧给予用户的总计优惠金额 (不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】。logistics_info_liststring否否否item_order_listitemorderinfo是否否商品信息列表。详见下文: 商品信息列表ext_infoorderextinfo是是否订单扩展字段。详见下文 订单扩展字段。订单扩展字段开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:参数参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_statusl ext_valuestring是是否订单状态, 例: cancelledl ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: order_sendl ext_keystring是否是订单详情地址 key。固定为merchant_order_link_page,一笔订单同步过程中需要保持一致。l ext_valuestring是否是商户小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。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) 的各项入参详情如下:参数参数类型是否必填能否更新是否消息使用字段参数说明signed_timestring否否否字段名称:签收时间字段说明:签收的时间点,时间格式为 yyyy-mm-dd hh:mm:ss。send_addressstring否否否字段名称:寄件地址字段说明:寄件地址,企业码专用open_timestring否否否字段名称:驿站营业开始时间 字段说明:【驿站寄件】类型必填,时间格式为 yyyy-mm-dd hh:mm:ss。order_timestring否否否字段名称:下单时间字段说明:下单的时间点,企业码专用,时间格式为 yyyy-mm-dd hh:mm:ss。express_companystring否否否快递公司名send_phonestring否否否字段名称:寄件人电话字段说明:寄件人的电话号码,企业码专用send_codestring否否否寄件码take_namestring否否否字段名称:收件人姓名字段说明:收件人的姓名;企业码专用closing_timestring否否否字段名称:驿站营业关门时间 字段说明:【驿站寄件】类型必填,时间格式为 yyyy-mm-dd hh:mm:ss。take_phonestring否否否字段名称:收件人电话字段说明:收件人的电话号码,企业码专用take_timestring否否否字段名称:揽件时间字段说明:揽件的时间点,企业码专用,时间格式为 yyyy-mm-dd hh:mm:ss。door_start_timestring否否否字段名称:预计上门开始时间 字段说明:【上门取件】类型必填,时间格式为 yyyy-mm-dd hh:mm:ss。talke_addressstring否否否字段名称:收件地址字段说明:收件地址,企业码专用door_end_timestring否否否字段名称:预计上门结束时间 字段说明:【上门取件】类型必填,时间格式为 yyyy-mm-dd hh:mm:ss。phonestring否否否字段名称:快递员电话字段说明:虚拟号send_namestring否否否字段名称:寄件人姓名字段说明:寄件人的姓名,企业码专用商品信息列表开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:参数参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为:{商家名称} {商品名称} ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id物流信息若商家想在订单中展示物流信息,可通过物流信息(logistics_info_list)同步。参数说明如下:参数参数类型是否必填能否更新是否消息使用字段参数说明logistics_codestring否否否字段名称:物流公司字段说明:物流公司编码:tracking_nostring否否否物流单号已退款 (refunded)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-已退款 (refunded)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否否外部订单号。由商家自定义。 注意:同一笔订单更新状态时,需与首次同步入参一致。buyer_idstring是否否支付宝用户 uid。2088 开头的数字。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相同的两次同步会被幂等处理。category_idstring否否否支付宝标准服务类目code,本模板支持类目code:c000003527service_codestring否否否服务code:传入小程序后台提报的服务id,将订单与服务关联。service_code 通过 alipay.open.app.service.apply(服务提报申请)接口提报服务后获取。source_appstring否否否订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其他来源枚举值定义联系支付宝订单中心添加。trade_nostring否否否支付宝交易号。注意:若该状态传递了trade_no,则同步该订单的后续状态时都需要传递trade_no。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。amountprice选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)是否订单总金额:某笔交易订单优惠前的总金额,单位为【元】注意事项service_order且不涉及金额可不传入该字段,其他场景必传pay_amountprice选填,建议传入该参数否否用户应付金额 :用户最终结算时需要支付金额(不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】注意事项service_order且不涉及金额可不传入该字段,其他场景必传discount_amountprice否否否商户总计优惠金额:代表商户侧给予用户的总计优惠金额 (不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】。logistics_info_liststring否否否item_order_listitemorderinfo是否否商品信息列表。详见下文: 商品信息列表ext_infoorderextinfo是是否订单扩展字段。详见下文 订单扩展字段。订单扩展字段开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:参数参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_statusl ext_valuestring是是否订单状态, 例: refundedl ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: order_sendl ext_keystring是否是订单详情地址 key。固定为merchant_order_link_page,一笔订单同步过程中需要保持一致。l ext_valuestring是否是商户小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。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) 的各项入参详情如下:参数参数类型是否必填能否更新是否消息使用字段参数说明signed_timestring否否否字段名称:签收时间字段说明:签收的时间点,时间格式为 yyyy-mm-dd hh:mm:ss。send_addressstring否否否字段名称:寄件地址字段说明:寄件地址,企业码专用open_timestring否否否字段名称:驿站营业开始时间 字段说明:【驿站寄件】类型必填,时间格式为 yyyy-mm-dd hh:mm:ss。order_timestring否否否字段名称:下单时间字段说明:下单的时间点,企业码专用,时间格式为 yyyy-mm-dd hh:mm:ss。express_companystring否否是快递公司名send_phonestring否否否字段名称:寄件人电话字段说明:寄件人的电话号码,企业码专用send_codestring否否是寄件码take_namestring否否否字段名称:收件人姓名字段说明:收件人的姓名;企业码专用closing_timestring否否否字段名称:驿站营业关门时间 字段说明:【驿站寄件】类型必填,时间格式为 yyyy-mm-dd hh:mm:ss。take_phonestring否否否字段名称:收件人电话字段说明:收件人的电话号码,企业码专用take_timestring否否否字段名称:揽件时间字段说明:揽件的时间点,企业码专用,时间格式为 yyyy-mm-dd hh:mm:ss。door_start_timestring否否否字段名称:预计上门开始时间 字段说明:【上门取件】类型必填,时间格式为 yyyy-mm-dd hh:mm:ss。talke_addressstring否否否字段名称:收件地址字段说明:收件地址,企业码专用door_end_timestring否否否字段名称:预计上门结束时间 字段说明:【上门取件】类型必填,时间格式为 yyyy-mm-dd hh:mm:ss。phonestring否否否字段名称:快递员电话字段说明:虚拟号send_namestring否否否字段名称:寄件人姓名字段说明:寄件人的姓名,企业码专用商品信息列表开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:参数参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为:{商家名称} {商品名称} ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id物流信息若商家想在订单中展示物流信息,可通过物流信息(logistics_info_list)同步。参数说明如下:参数参数类型是否必填能否更新是否消息使用字段参数说明logistics_codestring否否否字段名称:物流公司字段说明:物流公司编码:tracking_nostring否否否物流单号已签收 (signed)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-已签收 (signed)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否否外部订单号。由商家自定义。 注意:同一笔订单更新状态时,需与首次同步入参一致。buyer_idstring是否否支付宝用户 uid。2088 开头的数字。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相同的两次同步会被幂等处理。category_idstring否否否支付宝标准服务类目code,本模板支持类目code:c000003527service_codestring否否否服务code:传入小程序后台提报的服务id,将订单与服务关联。service_code 通过 alipay.open.app.service.apply(服务提报申请)接口提报服务后获取。source_appstring否否否订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其他来源枚举值定义联系支付宝订单中心添加。trade_nostring否否否支付宝交易号。注意:若该状态传递了trade_no,则同步该订单的后续状态时都需要传递trade_no。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。amountprice选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)是否订单总金额:某笔交易订单优惠前的总金额,单位为【元】注意事项service_order且不涉及金额可不传入该字段,其他场景必传pay_amountprice选填,建议传入该参数否否用户应付金额 :用户最终结算时需要支付金额(不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】注意事项service_order且不涉及金额可不传入该字段,其他场景必传discount_amountprice否否否商户总计优惠金额:代表商户侧给予用户的总计优惠金额 (不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】。logistics_info_liststring否否否item_order_listitemorderinfo是否否商品信息列表。详见下文: 商品信息列表ext_infoorderextinfo是是否订单扩展字段。详见下文 订单扩展字段。订单扩展字段开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:参数参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_statusl ext_valuestring是是否订单状态, 例: signedl ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: order_sendl ext_keystring是否是订单详情地址 key。固定为merchant_order_link_page,一笔订单同步过程中需要保持一致。l ext_valuestring是否是商户小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。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) 的各项入参详情如下:参数参数类型是否必填能否更新是否消息使用字段参数说明signed_timestring否否否字段名称:签收时间字段说明:签收的时间点,时间格式为 yyyy-mm-dd hh:mm:ss。send_addressstring否否否字段名称:寄件地址字段说明:寄件地址,企业码专用open_timestring否否否字段名称:驿站营业开始时间 字段说明:【驿站寄件】类型必填,时间格式为 yyyy-mm-dd hh:mm:ss。order_timestring否否否字段名称:下单时间字段说明:下单的时间点,企业码专用,时间格式为 yyyy-mm-dd hh:mm:ss。express_companystring否否是快递公司名send_phonestring否否否字段名称:寄件人电话字段说明:寄件人的电话号码,企业码专用send_codestring否否否寄件码take_namestring否否否字段名称:收件人姓名字段说明:收件人的姓名;企业码专用closing_timestring否否否字段名称:驿站营业关门时间 字段说明:【驿站寄件】类型必填,时间格式为 yyyy-mm-dd hh:mm:ss。take_phonestring否否否字段名称:收件人电话字段说明:收件人的电话号码,企业码专用take_timestring否否否字段名称:揽件时间字段说明:揽件的时间点,企业码专用,时间格式为 yyyy-mm-dd hh:mm:ss。door_start_timestring否否否字段名称:预计上门开始时间 字段说明:【上门取件】类型必填,时间格式为 yyyy-mm-dd hh:mm:ss。talke_addressstring否否否字段名称:收件地址字段说明:收件地址,企业码专用door_end_timestring否否否字段名称:预计上门结束时间 字段说明:【上门取件】类型必填,时间格式为 yyyy-mm-dd hh:mm:ss。phonestring否否否字段名称:快递员电话字段说明:虚拟号send_namestring否否否字段名称:寄件人姓名字段说明:寄件人的姓名,企业码专用商品信息列表开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:参数参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为:{商家名称} {商品名称} ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id物流信息若商家想在订单中展示物流信息,可通过物流信息(logistics_info_list)同步。参数说明如下:参数参数类型是否必填能否更新是否消息使用字段参数说明logistics_codestring否否否字段名称:物流公司字段说明:物流公司编码:tracking_nostring否否是物流单号已揽收 (received)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-已揽收 (received)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否否外部订单号。由商家自定义。 注意:同一笔订单更新状态时,需与首次同步入参一致。buyer_idstring是否否支付宝用户 uid。2088 开头的数字。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相同的两次同步会被幂等处理。category_idstring否否否支付宝标准服务类目code,本模板支持类目code:c000003527service_codestring否否否服务code:传入小程序后台提报的服务id,将订单与服务关联。service_code 通过 alipay.open.app.service.apply(服务提报申请)接口提报服务后获取。source_appstring否否否订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其他来源枚举值定义联系支付宝订单中心添加。trade_nostring否否否支付宝交易号。注意:若该状态传递了trade_no,则同步该订单的后续状态时都需要传递trade_no。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。amountprice选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)是否订单总金额:某笔交易订单优惠前的总金额,单位为【元】注意事项service_order且不涉及金额可不传入该字段,其他场景必传pay_amountprice选填,建议传入该参数否否用户应付金额 :用户最终结算时需要支付金额(不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】注意事项service_order且不涉及金额可不传入该字段,其他场景必传discount_amountprice否否否商户总计优惠金额:代表商户侧给予用户的总计优惠金额 (不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】。logistics_info_liststring否否否item_order_listitemorderinfo是否否商品信息列表。详见下文: 商品信息列表ext_infoorderextinfo是是否订单扩展字段。详见下文 订单扩展字段。订单扩展字段开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:参数参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_statusl ext_valuestring是是否订单状态, 例: receivedl ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: order_sendl ext_keystring是否否订单详情地址 key。固定为merchant_order_link_page,一笔订单同步过程中需要保持一致。l ext_valuestring是否否商户小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。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) 的各项入参详情如下:参数参数类型是否必填能否更新是否消息使用字段参数说明signed_timestring否否否字段名称:签收时间字段说明:签收的时间点,时间格式为 yyyy-mm-dd hh:mm:ss。send_addressstring否否否字段名称:寄件地址字段说明:寄件地址,企业码专用open_timestring否否否字段名称:驿站营业开始时间 字段说明:【驿站寄件】类型必填,时间格式为 yyyy-mm-dd hh:mm:ss。order_timestring否否否字段名称:下单时间字段说明:下单的时间点,企业码专用,时间格式为 yyyy-mm-dd hh:mm:ss。express_companystring否否否快递公司名send_phonestring否否否字段名称:寄件人电话字段说明:寄件人的电话号码,企业码专用send_codestring否否否寄件码take_namestring否否否字段名称:收件人姓名字段说明:收件人的姓名;企业码专用closing_timestring否否否字段名称:驿站营业关门时间 字段说明:【驿站寄件】类型必填,时间格式为 yyyy-mm-dd hh:mm:ss。take_phonestring否否否字段名称:收件人电话字段说明:收件人的电话号码,企业码专用take_timestring否否否字段名称:揽件时间字段说明:揽件的时间点,企业码专用,时间格式为 yyyy-mm-dd hh:mm:ss。door_start_timestring否否否字段名称:预计上门开始时间 字段说明:【上门取件】类型必填,时间格式为 yyyy-mm-dd hh:mm:ss。talke_addressstring否否否字段名称:收件地址字段说明:收件地址,企业码专用door_end_timestring否否否字段名称:预计上门结束时间 字段说明:【上门取件】类型必填,时间格式为 yyyy-mm-dd hh:mm:ss。phonestring否否否字段名称:快递员电话字段说明:虚拟号send_namestring否否否字段名称:寄件人姓名字段说明:寄件人的姓名,企业码专用商品信息列表开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:参数参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为:{商家名称} {商品名称} ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id物流信息若商家想在订单中展示物流信息,可通过物流信息(logistics_info_list)同步。参数说明如下:参数参数类型是否必填能否更新是否消息使用字段参数说明logistics_codestring否否否字段名称:物流公司字段说明:物流公司编码:tracking_nostring否否否物流单号