餐饮外卖（take-凯发app官方网站

支付产品

私域产品

小程序产品

小程序产品介绍

集成说明

权限集列表

搜索关键词

搜索直达

消息

小程序码

小程序服务

订单中心

接入指南

各行业订单同步/查询详情

餐饮

点餐后付（p_qr_food_order）

排队订单（line_up）

餐厅预订（food_order）

零售批发

商业生活

交通出行

车主生活

教育培训

医疗卫生

酒旅景区

生活缴费

公共管理和社会组织

休闲娱乐

物流运输

网络通讯

api 列表

相关资料

常见问题

更新日志

小程序开发管理

生物核身

交易组件

小程序商品

更新日志

支付有礼

商家粉丝群

营销产品

资金产品

会员产品

信用产品

广告产品

更新时间：2025-03-07 16:42:18

订阅更新

我的文档

设置

接入检测（

即可查看检测结果）

若有未通过的接入检测项，接口将无法调通

商家需通过 alipay.merchant.order.sync(订单数据同步接口) 订单扩展字段 ext_info#merchant_order_status 参数更新订单状态，具体状态说明如下。

订单状态流转说明

订单状态说明

●

支持跨状态传递，例如：create (下单成功) 可直接跳转至 delivered_d (送达取餐点) 。

●

不要求首次同步订单状态必须为 create (下单成功) 。

●

订单状态发生变更后，需要及时同步最新状态。

●

当前场景定义的订单状态(中文和英文名)如下：

状态中文名	状态英文名	是否为有效订单核心状态	是否发送服务消息	是否发送push
下单成功	create	是	是	否
待支付	wait_pay	否	是	否
待接单	pending	否	否	否
已接单	order_taken	是	是	是
待配送	to_be_delivered	否	否	否
配送中	in_delivery	是	是	是
已送达	delivered	是	是	是
已取消	closed	否	是	是
送达取餐点	delivered_d	否	是	是

注意

：不同订单状态，仅

是否发送服务消息

为

是

时，用户才能在消息列表（支付宝凯发k8官方网娱乐官方首页服务提醒入口进入或凯发k8官方网娱乐官方首页底部消息tab进入）查看服务订单消息提醒。

状态机流转

订单状态机流转如下(左侧表示起始状态，右侧表示允许的后置状态)

当前状态	允许的后置状态
create(下单成功)	in_delivery/配送中、 create/下单成功、 delivered/已送达、 pending/待接单、 delivered_d/送达取餐点、 to_be_delivered/待配送、 closed/已取消、 order_taken/已接单、 wait_pay/待支付
wait_pay(待支付)	in_delivery/配送中、 delivered/已送达、 pending/待接单、 delivered_d/送达取餐点、 to_be_delivered/待配送、 closed/已取消、 order_taken/已接单、 wait_pay/待支付
pending(待接单)	in_delivery/配送中、 delivered/已送达、 pending/待接单、 delivered_d/送达取餐点、 to_be_delivered/待配送、 closed/已取消、 order_taken/已接单
order_taken(已接单)	in_delivery/配送中、 delivered/已送达、 delivered_d/送达取餐点、 to_be_delivered/待配送、 closed/已取消、 order_taken/已接单
to_be_delivered(待配送)	in_delivery/配送中、 delivered/已送达、 delivered_d/送达取餐点、 to_be_delivered/待配送、 closed/已取消
in_delivery(配送中)	in_delivery/配送中、 delivered/已送达、 delivered_d/送达取餐点、 closed/已取消
delivered(已送达)	delivered/已送达
closed(已取消)	closed/已取消
delivered_d(送达取餐点)	delivered_d/送达取餐点

不同状态参数使用说明

下单成功 (create)

本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-下单成功 (create)时需传入的商品信息及扩展字段参数信息。

接口参数 bizcontent 示例

参数说明

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
out_biz_no	string	是	否	是	外部订单号。由商家自定义。注意：同一笔订单更新状态时，需与首次同步入参一致。
buyer_id（buyer_open_id）	string	是	否	否	支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认应用-开发配置-openid配置管理已启用。无该配置项，可查看 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:c000003266
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或discount_amount已回传时必传，且amount=pay_amount discount_amount)	是	否	订单总金额：某笔交易订单优惠前的总金额，单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
pay_amount	price	选填，建议传入该参数	否	否	用户应付金额：用户最终结算时需要支付金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
discount_amount	price	否	否	否	商户总计优惠金额：代表商户侧给予用户的总计优惠金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】。
shop_info	ordershopinfo	否	否	否	门店信息。详见下文：门店信息
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	是	是	否	订单状态, 例: create
l ext_key	string	是	否	否	订单类型 key。固定为 merchant_biz_type。
l ext_value	string	是	否	否	订单类型 value。本业务场景为: take_out
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）的各项入参详情如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
distributor_information	string	否	否	否	配送商信息
store_address	string	否	否	否	字段名称：发货地址字段说明：发货门店的所在位置
delivery_clerk	string	否	否	否	配送员电话
come_again	string	否	否	否	字段名称：再来一单字段说明：商家或服务商回流的再来一单链接
store_name	string	否	否	否	字段名称：发货门店字段说明：外卖的发货门店
rebate_pid	string	否	否	否	字段名称：服务商pid 字段说明：特殊必填】餐饮服务商pid
take_out_order_type	string	否	否	否	字段名称：订单类型字段说明：订单类型；枚举值：实时单=instant 预约单=reservation；【出订单卡片的商户必填】
invoice	string	否	否	否	字段名称：开发票字段说明：商家或服务商回流的开票链接

商品信息列表

开发者需通过商品信息列表字段（item_order_list）传入商品图片、商品详情页等信息。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
item_name	string	是	否	是	商品名称。建议商品名称格式为：{商家名称} {商品名称}
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	需传入上传商品文件获取的 material_id。
l ext_key	string	否	否	否	商品描述 key。固定为 goodsdesc。
l ext_value	string	否	否	否	商品描述 value。

门店信息

若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
merchant_shop_id	string	否	否	否	商家侧门店 id
address	string	否	否	否	门店地址
shop_url	string	否	否	否	字段名称：门店url 字段说明：门店的小程序链接
alipay_shop_id	string	否	否	否	蚂蚁侧门店 id
name	string	否	否	否	门店名称
shop_phone	string	否	否	否	字段名称：门店凯发k8官方网娱乐官方的联系方式字段说明：门店的凯发k8官方网娱乐官方的联系方式

待支付 (wait_pay)

本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-待支付 (wait_pay)时需传入的商品信息及扩展字段参数信息。

接口参数 bizcontent 示例

参数说明

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
out_biz_no	string	是	否	否	外部订单号。由商家自定义。注意：同一笔订单更新状态时，需与首次同步入参一致。
buyer_id（buyer_open_id）	string	是	否	否	支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认应用-开发配置-openid配置管理已启用。无该配置项，可查看 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:c000003266
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或discount_amount已回传时必传，且amount=pay_amount discount_amount)	是	否	订单总金额：某笔交易订单优惠前的总金额，单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
pay_amount	price	选填，建议传入该参数	否	否	用户应付金额：用户最终结算时需要支付金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
discount_amount	price	否	否	否	商户总计优惠金额：代表商户侧给予用户的总计优惠金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】。
shop_info	ordershopinfo	否	否	否	门店信息。详见下文：门店信息
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_pay
l ext_key	string	是	否	否	订单类型 key。固定为 merchant_biz_type。
l ext_value	string	是	否	否	订单类型 value。本业务场景为: take_out
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）的各项入参详情如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
distributor_information	string	否	否	否	配送商信息
store_address	string	否	否	否	字段名称：发货地址字段说明：发货门店的所在位置
delivery_clerk	string	否	否	否	配送员电话
come_again	string	否	否	否	字段名称：再来一单字段说明：商家或服务商回流的再来一单链接
store_name	string	否	否	否	字段名称：发货门店字段说明：外卖的发货门店
rebate_pid	string	否	否	否	字段名称：服务商pid 字段说明：特殊必填】餐饮服务商pid
take_out_order_type	string	否	否	否	字段名称：订单类型字段说明：订单类型；枚举值：实时单=instant 预约单=reservation；【出订单卡片的商户必填】
invoice	string	否	否	否	字段名称：开发票字段说明：商家或服务商回流的开票链接

商品信息列表

开发者需通过商品信息列表字段（item_order_list）传入商品图片、商品详情页等信息。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
item_name	string	是	否	是	商品名称。建议商品名称格式为：{商家名称} {商品名称}
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	需传入上传商品文件获取的 material_id。
l ext_key	string	否	否	否	商品描述 key。固定为 goodsdesc。
l ext_value	string	否	否	否	商品描述 value。

门店信息

若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
merchant_shop_id	string	否	否	否	商家侧门店 id
address	string	否	否	否	门店地址
shop_url	string	否	否	否	字段名称：门店url 字段说明：门店的小程序链接
alipay_shop_id	string	否	否	否	蚂蚁侧门店 id
name	string	否	否	否	门店名称
shop_phone	string	否	否	否	字段名称：门店凯发k8官方网娱乐官方的联系方式字段说明：门店的凯发k8官方网娱乐官方的联系方式

待接单 (pending)

本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-待接单 (pending)时需传入的商品信息及扩展字段参数信息。

接口参数 bizcontent 示例

参数说明

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
out_biz_no	string	是	否	否	外部订单号。由商家自定义。注意：同一笔订单更新状态时，需与首次同步入参一致。
buyer_id（buyer_open_id）	string	是	否	否	支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认应用-开发配置-openid配置管理已启用。无该配置项，可查看 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:c000003266
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或discount_amount已回传时必传，且amount=pay_amount discount_amount))	是	否	订单总金额：某笔交易订单优惠前的总金额，单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
pay_amount	price	选填，建议传入该参数	否	否	用户应付金额：用户最终结算时需要支付金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
discount_amount	price	否	否	否	商户总计优惠金额：代表商户侧给予用户的总计优惠金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】。
shop_info	ordershopinfo	否	否	否	门店信息。详见下文：门店信息
item_order_list	itemorderinfo	是	否	否	商品信息列表。详见下文：商品信息列表
ext_info	orderextinfo	是	是	否	订单扩展字段。详见下文：订单扩展字段。

订单扩展字段

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

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
distributor_information	string	否	否	否	配送商信息
store_address	string	否	否	否	字段名称：发货地址字段说明：发货门店的所在位置
delivery_clerk	string	否	否	否	配送员电话
come_again	string	否	否	否	字段名称：再来一单字段说明：商家或服务商回流的再来一单链接
store_name	string	否	否	否	字段名称：发货门店字段说明：外卖的发货门店
rebate_pid	string	否	否	否	字段名称：服务商pid 字段说明：特殊必填】餐饮服务商pid
take_out_order_type	string	否	否	否	字段名称：订单类型字段说明：订单类型；枚举值：实时单=instant 预约单=reservation；【出订单卡片的商户必填】
invoice	string	否	否	否	字段名称：开发票字段说明：商家或服务商回流的开票链接

商品信息列表

开发者需通过商品信息列表字段（item_order_list）传入商品图片、商品详情页等信息。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
item_name	string	是	否	否	商品名称。建议商品名称格式为：{商家名称} {商品名称}
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	需传入上传商品文件获取的 material_id。
l ext_key	string	否	否	否	商品描述 key。固定为 goodsdesc。
l ext_value	string	否	否	否	商品描述 value。

门店信息

若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
merchant_shop_id	string	否	否	否	商家侧门店 id
address	string	否	否	否	门店地址
shop_url	string	否	否	否	字段名称：门店url 字段说明：门店的小程序链接
alipay_shop_id	string	否	否	否	蚂蚁侧门店 id
name	string	否	否	否	门店名称
shop_phone	string	否	否	否	字段名称：门店凯发k8官方网娱乐官方的联系方式字段说明：门店的凯发k8官方网娱乐官方的联系方式

已接单 (order_taken)

本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-已接单 (order_taken)时需传入的商品信息及扩展字段参数信息。

接口参数 bizcontent 示例

参数说明

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
out_biz_no	string	是	否	是	外部订单号。由商家自定义。注意：同一笔订单更新状态时，需与首次同步入参一致。
buyer_id（buyer_open_id）	string	是	否	否	支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认应用-开发配置-openid配置管理已启用。无该配置项，可查看 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:c000003266
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或discount_amount已回传时必传，且amount=pay_amount discount_amount))	是	否	订单总金额：某笔交易订单优惠前的总金额，单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
pay_amount	price	选填，建议传入该参数	否	否	用户应付金额：用户最终结算时需要支付金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
discount_amount	price	否	否	否	商户总计优惠金额：代表商户侧给予用户的总计优惠金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】。
shop_info	ordershopinfo	否	否	否	门店信息。详见下文：门店信息
item_order_list	itemorderinfo	是	否	否	商品信息列表。详见下文：商品信息列表
ext_info	orderextinfo	是	是	否	订单扩展字段。详见下文：订单扩展字段。

订单扩展字段

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
l ext_key	string	是	否	否	订单状态 key。固定为 merchant_order_status
l ext_value	string	是	是	否	订单状态, 例: order_taken
l ext_key	string	是	否	否	订单类型 key。固定为 merchant_biz_type。
l ext_value	string	是	否	否	订单类型 value。本业务场景为: take_out
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）的各项入参详情如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
distributor_information	string	否	否	否	配送商信息
store_address	string	否	否	否	字段名称：发货地址字段说明：发货门店的所在位置
delivery_clerk	string	否	否	否	配送员电话
come_again	string	否	否	否	字段名称：再来一单字段说明：商家或服务商回流的再来一单链接
store_name	string	否	否	否	字段名称：发货门店字段说明：外卖的发货门店
rebate_pid	string	否	否	否	字段名称：服务商pid 字段说明：特殊必填】餐饮服务商pid
take_out_order_type	string	否	否	否	字段名称：订单类型字段说明：订单类型；枚举值：实时单=instant 预约单=reservation；【出订单卡片的商户必填】
invoice	string	否	否	否	字段名称：开发票字段说明：商家或服务商回流的开票链接

商品信息列表

开发者需通过商品信息列表字段（item_order_list）传入商品图片、商品详情页等信息。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
item_name	string	是	否	是	商品名称。建议商品名称格式为：{商家名称} {商品名称}
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	需传入上传商品文件获取的 material_id。
l ext_key	string	否	否	否	商品描述 key。固定为 goodsdesc。
l ext_value	string	否	否	否	商品描述 value。

门店信息

若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
merchant_shop_id	string	否	否	否	商家侧门店id
address	string	否	否	否	门店地址
shop_url	string	否	否	否	字段名称：门店url 字段说明：门店的小程序链接
alipay_shop_id	string	否	否	否	蚂蚁侧门店 id
name	string	否	否	否	门店名称
shop_phone	string	否	否	否	字段名称：门店凯发k8官方网娱乐官方的联系方式字段说明：门店的凯发k8官方网娱乐官方的联系方式

待配送 (to_be_delivered)

本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-待配送 (to_be_delivered)时需传入的商品信息及扩展字段参数信息。

接口参数 bizcontent 示例

参数说明

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
out_biz_no	string	是	否	否	外部订单号。由商家自定义。注意：同一笔订单更新状态时，需与首次同步入参一致。
buyer_id（buyer_open_id）	string	是	否	否	支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认应用-开发配置-openid配置管理已启用。无该配置项，可查看 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:c000003266
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或discount_amount已回传时必传，且amount=pay_amount discount_amount))	是	否	订单总金额：某笔交易订单优惠前的总金额，单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
pay_amount	price	选填，建议传入该参数	否	否	用户应付金额：用户最终结算时需要支付金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
discount_amount	price	否	否	否	商户总计优惠金额：代表商户侧给予用户的总计优惠金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】。
shop_info	ordershopinfo	否	否	否	门店信息。详见下文：门店信息
item_order_list	itemorderinfo	是	否	否	商品信息列表。详见下文：商品信息列表
ext_info	orderextinfo	是	是	否	订单扩展字段。详见下文：订单扩展字段。

订单扩展字段

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
l ext_key	string	是	否	否	订单状态 key。固定为 merchant_order_status
l ext_value	string	是	是	否	订单状态, 例: to_be_delivered
l ext_key	string	是	否	否	订单类型 key。固定为 merchant_biz_type。
l ext_value	string	是	否	否	订单类型 value。本业务场景为: take_out
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）的各项入参详情如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
distribution_end_time	string	否	否	否	字段名称：预计配送结束时间字段说明：预计配送结束时间，时间格式为 yyyy-mm-dd hh:mm:ss。
rider_position	string	否	否	否	骑手位置
distributor_information	string	否	否	否	配送商信息
store_address	string	否	否	否	字段名称：发货地址字段说明：发货门店的所在位置
delivery_clerk	string	否	否	否	配送员电话
come_again	string	否	否	否	字段名称：再来一单字段说明：商家或服务商回流的再来一单链接
delivery_start_time	string	否	否	否	字段名称：预计送达开始时间字段说明：预计送达开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。
store_name	string	否	否	否	字段名称：发货门店字段说明：外卖的发货门店
rebate_pid	string	否	否	否	字段名称：服务商pid 字段说明：特殊必填】餐饮服务商pid
delivery_end_time	string	否	否	否	字段名称：预计送达结束时间字段说明：预计送达结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
take_out_order_type	string	否	否	否	字段名称：订单类型字段说明：订单类型；枚举值：实时单=instant 预约单=reservation；【出订单卡片的商户必填】
distribution_start_time	string	否	否	否	字段名称：预计配送开始时间字段说明：预计配送开始时间；当订单类型为预约单，且要出卡片的商户必填。,时间格式为 yyyy-mm-dd hh:mm:ss。
invoice	string	否	否	否	字段名称：开发票字段说明：商家或服务商回流的开票链接

商品信息列表

开发者需通过商品信息列表字段（item_order_list）传入商品图片、商品详情页等信息。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
item_name	string	是	否	否	商品名称。建议商品名称格式为：{商家名称} {商品名称}
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	需传入上传商品文件获取的 material_id。
l ext_key	string	否	否	否	商品描述 key。固定为 goodsdesc。
l ext_value	string	否	否	否	商品描述 value。

门店信息

若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
merchant_shop_id	string	否	否	否	商家侧门店 id
address	string	否	否	否	门店地址
shop_url	string	否	否	否	字段名称：门店url 字段说明：门店的小程序链接
alipay_shop_id	string	否	否	否	蚂蚁侧门店 id
name	string	否	否	否	门店名称
shop_phone	string	否	否	否	字段名称：门店凯发k8官方网娱乐官方的联系方式字段说明：门店的凯发k8官方网娱乐官方的联系方式

配送中 (in_delivery)

本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-配送中 (in_delivery)时需传入的商品信息及扩展字段参数信息。

接口参数 bizcontent 示例

参数说明

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
out_biz_no	string	是	否	是	外部订单号。由商家自定义。注意：同一笔订单更新状态时，需与首次同步入参一致。
buyer_id（buyer_open_id）	string	是	否	否	支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认应用-开发配置-openid配置管理已启用。无该配置项，可查看 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:c000003266
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或discount_amount已回传时必传，且amount=pay_amount discount_amount))	是	否	订单总金额：某笔交易订单优惠前的总金额，单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
pay_amount	price	选填，建议传入该参数	否	否	用户应付金额：用户最终结算时需要支付金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
discount_amount	price	否	否	否	商户总计优惠金额：代表商户侧给予用户的总计优惠金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】。
shop_info	ordershopinfo	否	否	否	门店信息。详见下文：门店信息
item_order_list	itemorderinfo	是	否	否	商品信息列表。详见下文：商品信息列表
ext_info	orderextinfo	是	是	否	订单扩展字段。详见下文：订单扩展字段。

订单扩展字段

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
l ext_key	string	是	否	否	订单状态 key。固定为 merchant_order_status
l ext_value	string	是	是	否	订单状态, 例: in_delivery
l ext_key	string	是	否	否	订单类型 key。固定为 merchant_biz_type。
l ext_value	string	是	否	否	订单类型 value。本业务场景为: take_out
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）的各项入参详情如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
distribution_end_time	string	否	否	否	字段名称:预计配送结束时间字段说明:预计配送结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
rider_position	string	否	否	否	骑手位置
distributor_information	string	否	否	否	配送商信息
store_address	string	否	否	否	字段名称：发货地址字段说明：发货门店的所在位置
delivery_clerk	string	否	否	否	配送员电话
come_again	string	否	否	否	字段名称：再来一单字段说明：商家或服务商回流的再来一单链接
delivery_start_time	string	否	否	否	字段名称：预计送达开始时间字段说明：预计送达开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。
store_name	string	否	否	否	字段名称：发货门店字段说明：外卖的发货门店
rebate_pid	string	否	否	否	字段名称：服务商pid 字段说明：【特殊必填】餐饮服务商pid
delivery_end_time	string	否	否	否	字段名称：预计送达结束时间字段说明：预计送达结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
take_out_order_type	string	否	否	否	字段名称：订单类型字段说明：订单类型；枚举值：实时单=instant 预约单=reservation；【出订单卡片的商户必填】
distribution_start_time	string	否	否	是	字段名称：预计配送开始时间字段说明：预计配送开始时间；当订单类型为预约单，且要出卡片的商户必填。,时间格式为 yyyy-mm-dd hh:mm:ss。
delivery_no	string	否	否	否	字段名称：配送单号字段说明：配送单的单号
invoice	string	否	否	否	字段名称：开发票字段说明：商家或服务商回流的开票链接

商品信息列表

开发者需通过商品信息列表字段（item_order_list）传入商品图片、商品详情页等信息。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
item_name	string	是	否	是	商品名称。建议商品名称格式为：{商家名称} {商品名称}
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	需传入上传商品文件获取的 material_id。
l ext_key	string	否	否	否	商品描述 key。固定为 goodsdesc。
l ext_value	string	否	否	否	商品描述 value。

门店信息

若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
merchant_shop_id	string	否	否	否	商家侧门店 id
address	string	否	否	否	门店地址
shop_url	string	否	否	否	字段名称:门店url 字段说明:门店的小程序链接
alipay_shop_id	string	否	否	否	蚂蚁侧门店 id
name	string	否	否	否	门店名称
shop_phone	string	否	否	否	字段名称：门店凯发k8官方网娱乐官方的联系方式字段说明：门店的凯发k8官方网娱乐官方的联系方式

已送达 (delivered)

本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-已送达 (delivered)时需传入的商品信息及扩展字段参数信息。

接口参数 bizcontent 示例

参数说明

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
out_biz_no	string	是	否	是	外部订单号。由商家自定义。注意：同一笔订单更新状态时，需与首次同步入参一致。
buyer_id（buyer_open_id）	string	是	否	否	支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认应用-开发配置-openid配置管理已启用。无该配置项，可查看 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:c000003266
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或discount_amount已回传时必传，且amount=pay_amount discount_amount))	是	否	订单总金额：某笔交易订单优惠前的总金额，单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
pay_amount	price	选填，建议传入该参数	否	否	用户应付金额：用户最终结算时需要支付金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
discount_amount	price	否	否	否	商户总计优惠金额：代表商户侧给予用户的总计优惠金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】。
shop_info	ordershopinfo	否	否	否	门店信息。详见下文：门店信息
item_order_list	itemorderinfo	是	否	否	商品信息列表。详见下文：商品信息列表
ext_info	orderextinfo	是	是	否	订单扩展字段。详见下文：订单扩展字段。

订单扩展字段

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
l ext_key	string	是	否	否	订单状态 key。固定为 merchant_order_status
l ext_value	string	是	是	否	订单状态, 例: delivered
l ext_key	string	是	否	否	订单类型 key。固定为 merchant_biz_type。
l ext_value	string	是	否	否	订单类型 value。本业务场景为: take_out
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）的各项入参详情如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
distribution_end_time	string	否	否	否	字段名称：预计配送结束时间字段说明：预计配送结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
rider_position	string	否	否	否	骑手位置
distributor_information	string	否	否	否	配送商信息
store_address	string	否	否	否	字段名称：发货地址字段说明：发货门店的所在位置
delivery_clerk	string	否	否	否	配送员电话
come_again	string	否	否	否	字段名称：再来一单字段说明：商家或服务商回流的再来一单链接
delivery_start_time	string	否	否	否	字段名称：预计送达开始时间字段说明：预计送达开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。
store_name	string	否	否	否	字段名称：发货门店字段说明：外卖的发货门店
rebate_pid	string	否	否	否	字段名称：服务商pid 字段说明：【特殊必填】餐饮服务商pid
delivery_end_time	string	否	否	否	字段名称：预计送达结束时间字段说明：预计送达结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
take_out_order_type	string	否	否	否	字段名称：订单类型字段说明：订单类型；枚举值：实时单=instant 预约单=reservation；【出订单卡片的商户必填】
distribution_start_time	string	否	否	否	字段名称：预计配送开始时间字段说明：预计配送开始时间；当订单类型为预约单，且要出卡片的商户必填。,时间格式为 yyyy-mm-dd hh:mm:ss。
delivery_no	string	否	否	否	字段名称：配送单号字段说明：配送单的单号
invoice	string	否	否	否	字段名称：开发票字段说明：商家或服务商回流的开票链接

商品信息列表

开发者需通过商品信息列表字段（item_order_list）传入商品图片、商品详情页等信息。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
item_name	string	是	否	是	商品名称。建议商品名称格式为：{商家名称} {商品名称}
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	需传入上传商品文件获取的 material_id。
l ext_key	string	否	否	否	商品描述 key。固定为 goodsdesc。
l ext_value	string	否	否	否	商品描述 value。

门店信息

若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
merchant_shop_id	string	否	否	否	商家侧门店 id
address	string	否	否	否	门店地址
shop_url	string	否	否	否	字段名称：门店url 字段说明：门店的小程序链接
alipay_shop_id	string	否	否	否	蚂蚁侧门店 id
name	string	否	否	否	门店名称
shop_phone	string	否	否	否	字段名称：门店凯发k8官方网娱乐官方的联系方式字段说明：门店的凯发k8官方网娱乐官方的联系方式

已取消 (closed)

本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-已取消 (closed)时需传入的商品信息及扩展字段参数信息。

接口参数 bizcontent 示例

参数说明

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
out_biz_no	string	是	否	是	外部订单号。由商家自定义。注意：同一笔订单更新状态时，需与首次同步入参一致。
buyer_id（buyer_open_id）	string	是	否	否	支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认应用-开发配置-openid配置管理已启用。无该配置项，可查看 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:c000003266
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或discount_amount已回传时必传，且amount=pay_amount discount_amount))	是	否	订单总金额：某笔交易订单优惠前的总金额，单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
pay_amount	price	选填，建议传入该参数	否	否	用户应付金额：用户最终结算时需要支付金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
discount_amount	price	否	否	否	商户总计优惠金额：代表商户侧给予用户的总计优惠金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】。
shop_info	ordershopinfo	否	否	否	门店信息。详见下文：门店信息
item_order_list	itemorderinfo	是	否	否	商品信息列表。详见下文：商品信息列表
ext_info	orderextinfo	是	是	否	订单扩展字段。详见下文：订单扩展字段。

订单扩展字段

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
l ext_key	string	是	否	否	订单状态 key。固定为 merchant_order_status
l ext_value	string	是	是	否	订单状态, 例: closed
l ext_key	string	是	否	否	订单类型 key。固定为 merchant_biz_type。
l ext_value	string	是	否	否	订单类型 value。本业务场景为: take_out
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）的各项入参详情如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
distribution_end_time	string	否	否	否	字段名称：预计配送结束时间字段说明：预计配送结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
rider_position	string	否	否	否	骑手位置
distributor_information	string	否	否	否	配送商信息
store_address	string	否	否	否	字段名称：发货地址字段说明：发货门店的所在位置
delivery_clerk	string	否	否	否	配送员电话
come_again	string	否	否	否	字段名称：再来一单字段说明：商家或服务商回流的再来一单链接
delivery_start_time	string	否	否	否	字段名称：预计送达开始时间字段说明：预计送达开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。
store_name	string	否	否	否	字段名称：发货门店字段说明：外卖的发货门店
rebate_pid	string	否	否	否	字段名称：服务商pid 字段说明：【特殊必填】餐饮服务商pid
delivery_end_time	string	否	否	否	字段名称：预计送达结束时间字段说明：预计送达结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
take_out_order_type	string	否	否	否	字段名称：订单类型字段说明：订单类型；枚举值：实时单=instant 预约单=reservation；【出订单卡片的商户必填】
distribution_start_time	string	否	否	否	字段名称：预计配送开始时间字段说明：预计配送开始时间；当订单类型为预约单，且要出卡片的商户必填。,时间格式为 yyyy-mm-dd hh:mm:ss。
invoice	string	否	否	否	字段名称：开发票字段说明：商家或服务商回流的开票链接

商品信息列表

开发者需通过商品信息列表字段（item_order_list）传入商品图片、商品详情页等信息。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
item_name	string	是	否	是	商品名称。建议商品名称格式为：{商家名称} {商品名称}
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	需传入上传商品文件获取的 material_id。
l ext_key	string	否	否	否	商品描述 key。固定为 goodsdesc。
l ext_value	string	否	否	否	商品描述 value。

门店信息

若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
merchant_shop_id	string	否	否	否	商家侧门店 id
address	string	否	否	否	门店地址
shop_url	string	否	否	否	字段名称:门店url 字段说明:门店的小程序链接
alipay_shop_id	string	否	否	否	蚂蚁侧门店 id
name	string	否	否	否	门店名称
shop_phone	string	否	否	否	字段名称：门店凯发k8官方网娱乐官方的联系方式字段说明：门店的凯发k8官方网娱乐官方的联系方式

送达取餐点 (delivered_d)

本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-送达取餐点 (delivered_d)时需传入的商品信息及扩展字段参数信息。

接口参数 bizcontent 示例

参数说明

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
out_biz_no	string	是	否	否	外部订单号。由商家自定义。注意：同一笔订单更新状态时，需与首次同步入参一致。
buyer_id（buyer_open_id）	string	是	否	否	支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认应用-开发配置-openid配置管理已启用。无该配置项，可查看 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:c000003266
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或discount_amount已回传时必传，且amount=pay_amount discount_amount))	是	否	订单总金额：某笔交易订单优惠前的总金额，单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
pay_amount	price	选填，建议传入该参数	否	否	用户应付金额：用户最终结算时需要支付金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
discount_amount	price	否	否	否	商户总计优惠金额：代表商户侧给予用户的总计优惠金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】。
shop_info	ordershopinfo	否	否	否	门店信息。详见下文：门店信息
item_order_list	itemorderinfo	是	否	否	商品信息列表。详见下文：商品信息列表
ext_info	orderextinfo	是	是	否	订单扩展字段。详见下文：订单扩展字段。

订单扩展字段

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
l ext_key	string	是	否	否	订单状态 key。固定为 merchant_order_status
l ext_value	string	是	是	否	订单状态, 例: delivered_d
l ext_key	string	是	否	否	订单类型 key。固定为 merchant_biz_type。
l ext_value	string	是	否	否	订单类型 value。本业务场景为: take_out
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）的各项入参详情如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
distribution_end_time	string	否	否	否	字段名称：预计配送结束时间字段说明：预计配送结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
rider_position	string	否	否	否	骑手位置
distributor_information	string	否	否	否	配送商信息
store_address	string	否	否	否	字段名称：发货地址字段说明：发货门店的所在位置
delivery_clerk	string	否	否	否	配送员电话
come_again	string	否	否	否	字段名称：再来一单字段说明：商家或服务商回流的再来一单链接
delivery_start_time	string	否	否	否	字段名称：预计送达开始时间字段说明：预计送达开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。
store_name	string	否	否	否	字段名称：发货门店字段说明：外卖的发货门店
rebate_pid	string	否	否	否	字段名称：服务商pid 字段说明：【特殊必填】餐饮服务商pid
delivery_end_time	string	否	否	否	字段名称：预计送达结束时间字段说明：预计送达结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
take_out_order_type	string	否	否	否	字段名称：订单类型字段说明：订单类型；枚举值：实时单=instant 预约单=reservation；【出订单卡片的商户必填】
distribution_start_time	string	否	否	否	字段名称：预计配送开始时间字段说明：预计配送开始时间；当订单类型为预约单，且要出卡片的商户必填。,时间格式为 yyyy-mm-dd hh:mm:ss。
information	string	否	否	是	字段名称：取餐信息字段说明：【送达取餐点时需传参】，为给消费者展示的取餐点或取餐码等信息
invoice	string	否	否	否	字段名称：开发票字段说明：商家或服务商回流的开票链接

商品信息列表

开发者需通过商品信息列表字段（item_order_list）传入商品图片、商品详情页等信息。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
item_name	string	是	否	是	商品名称。建议商品名称格式为：{商家名称} {商品名称}
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	需传入上传商品文件获取的 material_id。
l ext_key	string	否	否	否	商品描述 key。固定为 goodsdesc。
l ext_value	string	否	否	否	商品描述 value。

门店信息

若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
merchant_shop_id	string	否	否	否	商家侧门店 id
address	string	否	否	否	门店地址
shop_url	string	否	否	否	字段名称:门店url 字段说明:门店的小程序链接
alipay_shop_id	string	否	否	否	蚂蚁侧门店 id
name	string	否	否	否	门店名称
shop_phone	string	否	否	否	字段名称：门店凯发k8官方网娱乐官方的联系方式字段说明：门店的凯发k8官方网娱乐官方的联系方式

相关问题