更新时间：2024-11-27 15:57:56配置项检测工具收藏订阅更新我的文档设置接入检测（即可查看检测结果）若有未通过的接入检测项，接口将无法调通去登录返回文档本模板适用于餐饮行业，用户点单后需要到柜台前自行取餐的业务场景。商家需通过 alipay.merchant.order.sync(订单数据同步接口) 订单扩展字段 ext_info#merchant_order_status 参数更新订单状态，具体状态说明如下。订单状态流转说明订单状态说明●支持跨状态传递，例如：create (下单成功) 可直接跳转至 arrival_time (预约临期) 。●不要求首次同步订单状态必须为 create (下单成功) 。●订单状态发生变更后，需要及时同步最新状态。●当前场景定义的订单状态(中文和英文名)如下：状态中文名状态英文名是否为有效订单核心状态是否发送服务消息是否发送push下单成功create是是否待支付wait_pay否是否已支付paid否否否待接单pending否否否已接单order_taken否是是等待自取to_pick_up是是是已完成finished是是否已取消closed否是是已退单refunded否是是预约成功book_successfully否是否预约变更order_change否是是预约临期arrival_time否是是注意：不同订单状态，仅 是否发送服务消息 为 是 时，用户才能在消息列表（支付宝凯发k8官方网娱乐官方首页服务提醒入口进入或凯发k8官方网娱乐官方首页底部消息tab进入）查看服务订单消息提醒。状态机流转订单状态机流转如下(左侧表示起始状态，右侧表示允许的后置状态)当前状态允许的后置状态create(下单成功)create/下单成功、 pending/待接单、 arrival_time/预约临期、 finished/已完成、 closed/已取消、 order_taken/已接单、 book_successfully/预约成功、 order_change/预约变更、 paid/已支付、 to_pick_up/等待自取、 refunded/已退单、 wait_pay/待支付wait_pay(待支付)pending/待接单、 arrival_time/预约临期、 finished/已完成、 closed/已取消、 order_taken/已接单、 book_successfully/预约成功、 order_change/预约变更、 paid/已支付、 to_pick_up/等待自取、 refunded/已退单、 wait_pay/待支付paid(已支付)pending/待接单、 arrival_time/预约临期、 finished/已完成、 closed/已取消、 order_taken/已接单、 book_successfully/预约成功、 order_change/预约变更、 paid/已支付、 to_pick_up/等待自取、 refunded/已退单pending(待接单)pending/待接单、 arrival_time/预约临期、 finished/已完成、 closed/已取消、 order_taken/已接单、 book_successfully/预约成功、 order_change/预约变更、 to_pick_up/等待自取、 refunded/已退单order_taken(已接单)arrival_time/预约临期、 finished/已完成、 closed/已取消、 order_taken/已接单、 book_successfully/预约成功、 order_change/预约变更、 to_pick_up/等待自取、 refunded/已退单to_pick_up(等待自取)finished/已完成、 closed/已取消、 to_pick_up/等待自取、 refunded/已退单finished(已完成)finished/已完成、 refunded/已退单closed(已取消)closed/已取消refunded(已退单)refunded/已退单book_successfully(预约成功)pending/待接单、 arrival_time/预约临期、 finished/已完成、 closed/已取消、 order_taken/已接单、 book_successfully/预约成功、 order_change/预约变更、 paid/已支付、 to_pick_up/等待自取、 refunded/已退单、 wait_pay/待支付order_change(预约变更)pending/待接单、 arrival_time/预约临期、 finished/已完成、 closed/已取消、 order_taken/已接单、 order_change/预约变更、 to_pick_up/等待自取、 refunded/已退单arrival_time(预约临期)arrival_time/预约临期、 finished/已完成、 closed/已取消、 order_change/预约变更、 to_pick_up/等待自取、 refunded/已退单不同状态参数使用说明下单成功 (create)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-下单成功 (create)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例参数说明参数参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否是外部订单号。由商家自定义。 注意：同一笔订单更新状态时，需与首次同步入参一致。buyer_id（buyer_open_id）string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认 应用-开发配置-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相同的两次同步会被幂等处理。category_idstring否否否支付宝标准服务类目code,本模板支持类目code:c000003265service_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 或 discount_amount 已回传时必传，且 amount=pay_amount discount_amount)是否订单总金额。精确到小数点后两位，单位为元pay_amountprice选填，建议传入该参数否否实际支付金额。精确到小数点后两位。单位为元discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为元shop_infoordershopinfo否否否门店信息。详见下文：门店信息item_order_listitemorderinfo是否否商品信息列表。详见下文：商品信息列表ticket_infoticketinfo是否否凭证信息。如取件码等信息在此传递。详见下文：凭证信息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。本业务场景为: self_pickl 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） 的各项入参详情如下：参数参数类型是否必填能否更新是否消息使用字段参数说明come_againstring否否否字段名称：再来一单 字段说明：商家或服务商回流的再来一单小程序完整链接rebate_pidstring否否否字段名称：服务商pid 字段说明：【特殊必填】餐饮返佣所需服务商pidinvoicestring否否否字段名称：开发票 字段说明：商家或服务商的开票链接商品信息列表开发者需通过商品信息列表字段（item_order_list）传入商品图片、商品详情页等信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否是商品名称。建议商品名称格式为：{商家名称} {商品名称} ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件获取的 material_id凭证信息若商家想在订单中展示取货码/取餐码凭证信息，可通过凭证信息（ticket_info）参数同步。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明shopstring否否否字段名称：提货门店 字段说明：提货门店可能与售卖门店不一行，因此必传resv_typestring是否否字段名称：自提订单类型 字段说明：自提订单类型：实时单(instant)/预约单(reservation)typestring否否否取单凭证名end_timestring否否否字段名称：预计提货结束时间 字段说明：预计提货结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。addressstring否否否字段名称：提货地址 字段说明：提货地址可能与门店地址不一样，因此必传timestring否否否字段名称：预计提货开始时间 字段说明：预计提货开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。ticket_nostring否否否取货码门店信息若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明merchant_shop_idstring否否否商家侧门店idaddressstring否否否门店地址namestring否否否门店名称待支付 (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配置管理 已启用。无该配置项，可查看 。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:c000003265service_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或discount_amount已回传时必传，且amount=pay_amount discount_amount)是否订单总金额。精确到小数点后两位，单位为元pay_amountprice选填，建议传入该参数否否实际支付金额。精确到小数点后两位。单位为元discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为元shop_infoordershopinfo否否否门店信息。详见下文 门店信息item_order_listitemorderinfo是否否商品信息列表。详见下文 商品信息列表ticket_infoticketinfo是否否凭证信息。如取件码等信息在此传递。详见下文凭证信息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。本业务场景为: self_pickl 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） 的各项入参详情如下：参数参数类型是否必填能否更新是否消息使用字段参数说明come_againstring否否否字段名称：再来一单 字段说明：商家或服务商回流的再来一单小程序完整链接rebate_pidstring否否否字段名称：服务商 pid 字段说明:【特殊必填】餐饮返佣所需服务商pidinvoicestring否否否字段名称：开发票 字段说明：商家或服务商的开票链接商品信息列表开发者需通过商品信息列表字段（item_order_list）传入商品图片、商品详情页等信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否是商品名称。建议商品名称格式为：{商家名称} {商品名称} ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件获取的 material_id凭证信息若商家想在订单中展示取货码/取餐码凭证信息，可通过凭证信息（ticket_info）参数同步。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明shopstring否否否字段名称：提货门店 字段说明：提货门店可能与售卖门店不一行，因此必传resv_typestring是否否字段名称：自提订单类型 字段说明：自提订单类型：实时单(instant)/预约单(reservation)typestring否否否取单凭证名end_timestring否否否字段名称：预计提货结束时间 字段说明：预计提货结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。addressstring否否否字段名称：提货地址 字段说明：提货地址可能与门店地址不一样，因此必传timestring否否否字段名称：预计提货开始时间 字段说明：预计提货开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。ticket_nostring否否否取货码门店信息若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明merchant_shop_idstring否否否商家侧门店idaddressstring否否否门店地址namestring否否否门店名称已支付 (paid)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-已支付 (paid)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否否外部订单号。由商家自定义。 注意：同一笔订单更新状态时，需与首次同步入参一致。buyer_id（buyer_open_id）string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认 应用-开发配置-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相同的两次同步会被幂等处理。category_idstring否否否支付宝标准服务类目code,本模板支持类目code:c000003265service_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 或 discount_amount 已回传时必传，且 amount=pay_amount discount_amount)是否订单总金额。精确到小数点后两位，单位为元pay_amountprice选填，建议传入该参数否否实际支付金额。精确到小数点后两位。单位为元discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为元shop_infoordershopinfo否否否门店信息。详见下文 门店信息item_order_listitemorderinfo是否否商品信息列表。详见下文 商品信息列表ticket_infoticketinfo否否否凭证信息。如取件码等信息在此传递。详见下文 凭证信息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。本业务场景为: self_pickl 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） 的各项入参详情如下：参数参数类型是否必填能否更新是否消息使用字段参数说明come_againstring否否否字段名称：再来一单 字段说明：商家或服务商回流的再来一单小程序完整链接rebate_pidstring否否否字段名称：服务商pid 字段说明:【特殊必填】餐饮返佣所需服务商pidinvoicestring否否否字段名称：开发票 字段说明：商家或服务商的开票链接商品信息列表开发者需通过商品信息列表字段（item_order_list）传入商品图片、商品详情页等信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为：{商家名称} {商品名称} ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件获取的 material_id凭证信息若商家想在订单中展示取货码/取餐码凭证信息，可通过凭证信息（ticket_info）参数同步。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明shopstring否否否字段名称：提货门店 字段说明：提货门店可能与售卖门店不一行，因此必传resv_typestring否否否字段名称：自提订单类型 字段说明：自提订单类型：实时单(instant)/预约单(reservation)typestring否否否取单凭证名end_timestring否否否字段名称：预计提货结束时间 字段说明：预计提货结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。addressstring否否否字段名称：提货地址 字段说明：提货地址可能与门店地址不一样，因此必传timestring否否否字段名称：预计提货开始时间 字段说明：预计提货开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。ticket_nostring否否否取货码门店信息若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明merchant_shop_idstring否否否商家侧门店idaddressstring否否否门店地址namestring否否否门店名称待接单 (pending)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-待接单 (pending)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例参数说明参数参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否否外部订单号。由商家自定义。 注意：同一笔订单更新状态时，需与首次同步入参一致。buyer_id（buyer_open_id）string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认 应用-开发配置-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相同的两次同步会被幂等处理。category_idstring否否否支付宝标准服务类目code,本模板支持类目code:c000003265service_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或discount_amount已回传时必传，且amount=pay_amount discount_amount)是否订单总金额。精确到小数点后两位，单位为元pay_amountprice选填，建议传入该参数否否实际支付金额。精确到小数点后两位。单位为元discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为元shop_infoordershopinfo否否否门店信息。详见下文 门店信息item_order_listitemorderinfo是否否商品信息列表。详见下文 商品信息列表ticket_infoticketinfo是否否凭证信息。如取件码等信息在此传递。详见下文 凭证信息ext_infoorderextinfo是是否订单扩展字段。详见下文 订单扩展字段。订单扩展字段开发者需通过订单扩展字段（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。本业务场景为: self_pickl 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） 的各项入参详情如下：参数参数类型是否必填能否更新是否消息使用字段参数说明come_againstring否否否字段名称：再来一单 字段说明：商家或服务商回流的再来一单小程序完整链接rebate_pidstring否否否字段名称：服务商pid 字段说明:【特殊必填】餐饮返佣所需服务商pidinvoicestring否否否字段名称：开发票 字段说明：商家或服务商的开票链接商品信息列表开发者需通过商品信息列表字段（item_order_list）传入商品图片、商品详情页等信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为：{商家名称} {商品名称} ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件获取的 material_id凭证信息若商家想在订单中展示取货码/取餐码凭证信息，可通过凭证信息（ticket_info）参数同步。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明shopstring否否否字段名称：提货门店 字段说明：提货门店可能与售卖门店不一行，因此必传resv_typestring是否否字段名称：自提订单类型 字段说明：自提订单类型：实时单(instant)/预约单(reservation)typestring否否否取单凭证名end_timestring否否否字段名称：预计提货结束时间 字段说明：预计提货结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。addressstring否否否字段名称：提货地址 字段说明：提货地址可能与门店地址不一样，因此必传timestring否否否字段名称：预计提货开始时间 字段说明：预计提货开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。ticket_nostring否否否取货码门店信息若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明merchant_shop_idstring否否否商家侧门店idaddressstring否否否门店地址namestring否否否门店名称已接单 (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配置管理 已启用。无该配置项，可查看 。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:c000003265service_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或discount_amount已回传时必传，且amount=pay_amount discount_amount)是否订单总金额。精确到小数点后两位，单位为元pay_amountprice选填，建议传入该参数否否实际支付金额。精确到小数点后两位。单位为元discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为元shop_infoordershopinfo否否否门店信息。详见下文 门店信息item_order_listitemorderinfo是否否商品信息列表。详见下文 商品信息列表ticket_infoticketinfo是否否凭证信息。如取件码等信息在此传递。详见下文 凭证信息ext_infoorderextinfo是是否订单扩展字段。详见下文 订单扩展字段。订单扩展字段开发者需通过订单扩展字段（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。本业务场景为: self_pickl 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） 的各项入参详情如下：参数参数类型是否必填能否更新是否消息使用字段参数说明come_againstring否否否字段名称：再来一单 字段说明：商家或服务商回流的再来一单小程序完整链接rebate_pidstring否否否字段名称：服务商pid 字段说明:【特殊必填】餐饮返佣所需服务商pidinvoicestring否否否字段名称：开发票 字段说明：商家或服务商的开票链接商品信息列表开发者需通过商品信息列表字段（item_order_list）传入商品图片、商品详情页等信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否是商品名称。建议商品名称格式为：{商家名称} {商品名称} ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件获取的 material_id凭证信息若商家想在订单中展示取货码/取餐码凭证信息，可通过凭证信息（ticket_info）参数同步。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明shopstring否否否字段名称：提货门店 字段说明：提货门店可能与售卖门店不一行，因此必传resv_typestring是否否字段名称：自提订单类型 字段说明：自提订单类型：实时单(instant)/预约单(reservation)typestring否否否取单凭证名end_timestring否否否字段名称：预计提货结束时间 字段说明：预计提货结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。addressstring否否否字段名称：提货地址 字段说明：提货地址可能与门店地址不一样，因此必传timestring否否否字段名称：预计提货开始时间 字段说明：预计提货开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。ticket_nostring否否否取货码门店信息若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明merchant_shop_idstring否否否商家侧门店idaddressstring否否否门店地址namestring否否是门店名称等待自取 (to_pick_up)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-等待自取 (to_pick_up)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例参数说明参数参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否是外部订单号。由商家自定义。 注意：同一笔订单更新状态时，需与首次同步入参一致。buyer_id（buyer_open_id）string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认 应用-开发配置-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相同的两次同步会被幂等处理。category_idstring否否否支付宝标准服务类目code,本模板支持类目code:c000003265service_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或discount_amount已回传时必传，且amount=pay_amount discount_amount)是否订单总金额。精确到小数点后两位，单位为元pay_amountprice选填，建议传入该参数否否实际支付金额。精确到小数点后两位。单位为元discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为元shop_infoordershopinfo否否否门店信息。详见下文 门店信息item_order_listitemorderinfo是否否商品信息列表。详见下文 商品信息列表ticket_infoticketinfo是否否凭证信息。如取件码等信息在此传递。详见下文 凭证信息ext_infoorderextinfo是是否订单扩展字段。详见下文 订单扩展字段。订单扩展字段开发者需通过订单扩展字段（ext_info）更新订单状态，订单业务信息，订单类型等数据，入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_statusl ext_valuestring是是否订单状态, 例: to_pick_upl ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: self_pickl 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） 的各项入参详情如下：参数参数类型是否必填能否更新是否消息使用字段参数说明come_againstring否否否字段名称：再来一单 字段说明：商家或服务商回流的再来一单小程序完整链接rebate_pidstring否否否字段名称：服务商pid 字段说明:【特殊必填】餐饮返佣所需服务商pidinvoicestring否否否字段名称：开发票 字段说明：商家或服务商的开票链接商品信息列表开发者需通过商品信息列表字段（item_order_list）传入商品图片、商品详情页等信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否是商品名称。建议商品名称格式为：{商家名称} {商品名称} ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件获取的 material_id凭证信息若商家想在订单中展示取货码/取餐码凭证信息，可通过凭证信息（ticket_info）参数同步。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明shopstring否否否字段名称：提货门店 字段说明：提货门店可能与售卖门店不一行，因此必传resv_typestring是否否字段名称：自提订单类型 字段说明：自提订单类型：实时单(instant)/预约单(reservation)typestring是否否取单凭证名end_timestring否否否字段名称：预计提货结束时间 字段说明：预计提货结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。addressstring否否否字段名称：提货地址 字段说明：提货地址可能与门店地址不一样，因此必传timestring否否否字段名称：预计提货开始时间 字段说明：预计提货开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。ticket_nostring否否是取货码门店信息若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明merchant_shop_idstring否否否商家侧门店idaddressstring否否否门店地址namestring否否是门店名称已完成 (finished)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-已完成 (finished)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否是外部订单号。由商家自定义。 注意：同一笔订单更新状态时，需与首次同步入参一致。buyer_id（buyer_open_id）string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认 应用-开发配置-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相同的两次同步会被幂等处理。category_idstring否否否支付宝标准服务类目code,本模板支持类目code:c000003265service_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或discount_amount已回传时必传，且amount=pay_amount discount_amount)是否订单总金额。精确到小数点后两位，单位为元pay_amountprice选填，建议传入该参数否否实际支付金额。精确到小数点后两位。单位为元discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为元shop_infoordershopinfo否否否门店信息。详见下文 门店信息item_order_listitemorderinfo是否否商品信息列表。详见下文 商品信息列表ticket_infoticketinfo是否否凭证信息。如取件码等信息在此传递。详见下文 凭证信息ext_infoorderextinfo是是否订单扩展字段。详见下文 订单扩展字段。订单扩展字段开发者需通过订单扩展字段（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。本业务场景为: self_pickl 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） 的各项入参详情如下：参数参数类型是否必填能否更新是否消息使用字段参数说明come_againstring否否否字段名称：再来一单 字段说明：商家或服务商回流的再来一单小程序完整链接rebate_pidstring否否否字段名称：服务商pid 字段说明:【特殊必填】餐饮返佣所需服务商pidinvoicestring否否否字段名称：开发票 字段说明：商家或服务商的开票链接商品信息列表开发者需通过商品信息列表字段（item_order_list）传入商品图片、商品详情页等信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否是商品名称。建议商品名称格式为：{商家名称} {商品名称} ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件获取的 material_id凭证信息若商家想在订单中展示取货码/取餐码凭证信息，可通过凭证信息（ticket_info）参数同步。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明shopstring否否否字段名称：提货门店 字段说明：提货门店可能与售卖门店不一行，因此必传resv_typestring是否否字段名称：自提订单类型 字段说明：自提订单类型：实时单(instant)/预约单(reservation)typestring否否否取单凭证名end_timestring否否否字段名称：预计提货结束时间 字段说明：预计提货结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。addressstring否否否字段名称：提货地址 字段说明：提货地址可能与门店地址不一样，因此必传timestring否否否字段名称：预计提货开始时间 字段说明：预计提货开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。ticket_nostring否否否取货码门店信息若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明merchant_shop_idstring否否否商家侧门店idaddressstring否否否门店地址namestring否否是门店名称已取消 (closed)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-已取消 (closed)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例参数说明参数参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否是外部订单号。由商家自定义。 注意：同一笔订单更新状态时，需与首次同步入参一致。buyer_id（buyer_open_id）string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认 应用-开发配置-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相同的两次同步会被幂等处理。category_idstring否否否支付宝标准服务类目code,本模板支持类目code:c000003265service_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或discount_amount已回传时必传，且amount=pay_amount discount_amount)是否订单总金额。精确到小数点后两位，单位为元pay_amountprice选填，建议传入该参数否否实际支付金额。精确到小数点后两位。单位为元discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为元shop_infoordershopinfo否否否门店信息。详见下文 门店信息item_order_listitemorderinfo是否否商品信息列表。详见下文 商品信息列表ticket_infoticketinfo是否否凭证信息。如取件码等信息在此传递。详见下文 凭证信息ext_infoorderextinfo是是否订单扩展字段。详见下文 订单扩展字段。订单扩展字段开发者需通过订单扩展字段（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。本业务场景为: self_pickl 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） 的各项入参详情如下：参数参数类型是否必填能否更新是否消息使用字段参数说明come_againstring否否否字段名称：再来一单 字段说明：商家或服务商回流的再来一单小程序完整链接rebate_pidstring否否否字段名称：服务商pid 字段说明:【特殊必填】餐饮返佣所需服务商pidinvoicestring否否否字段名称：开发票 字段说明：商家或服务商的开票链接商品信息列表开发者需通过商品信息列表字段（item_order_list）传入商品图片、商品详情页等信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否是商品名称。建议商品名称格式为：{商家名称} {商品名称} ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件获取的 material_id凭证信息若商家想在订单中展示取货码/取餐码凭证信息，可通过凭证信息（ticket_info）参数同步。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明shopstring否否否字段名称：提货门店 字段说明：提货门店可能与售卖门店不一行，因此必传resv_typestring是否否字段名称：自提订单类型 字段说明：自提订单类型：实时单(instant)/预约单(reservation)typestring否否否取单凭证名end_timestring否否否字段名称：预计提货结束时间 字段说明：预计提货结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。addressstring否否否字段名称：提货地址 字段说明：提货地址可能与门店地址不一样，因此必传timestring否否否字段名称：预计提货开始时间 字段说明：预计提货开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。ticket_nostring否否否取货码门店信息若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明merchant_shop_idstring否否否商家侧门店idaddressstring否否否门店地址namestring否否否门店名称已退单 (refunded)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-已退单 (refunded)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否否外部订单号。由商家自定义。 注意：同一笔订单更新状态时，需与首次同步入参一致。buyer_id（buyer_open_id）string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认 应用-开发配置-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相同的两次同步会被幂等处理。category_idstring否否否支付宝标准服务类目code,本模板支持类目code:c000003265service_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或discount_amount已回传时必传，且amount=pay_amount discount_amount))是否订单总金额。精确到小数点后两位，单位为元pay_amountprice选填，建议传入该参数否否实际支付金额。精确到小数点后两位。单位为元discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为元shop_infoordershopinfo否否否门店信息。详见下文 门店信息item_order_listitemorderinfo是否否商品信息列表。详见下文 商品信息列表ticket_infoticketinfo是否否凭证信息。如取件码等信息在此传递。详见下文 凭证信息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。本业务场景为: self_pickl 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） 的各项入参详情如下：参数参数类型是否必填能否更新是否消息使用字段参数说明come_againstring否否否字段名称：再来一单 字段说明：商家或服务商回流的再来一单小程序完整链接refund_amountstring是否是字段名称：退款金额 字段说明：退款的金额，默认单位为元rebate_pidstring否否否字段名称：服务商pid 字段说明:【特殊必填】餐饮返佣所需服务商pidinvoicestring否否否字段名称：开发票 字段说明：商家或服务商的开票链接商品信息列表开发者需通过商品信息列表字段（item_order_list）传入商品图片、商品详情页等信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否是商品名称。建议商品名称格式为：{商家名称} {商品名称} ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件获取的 material_id凭证信息若商家想在订单中展示取货码/取餐码凭证信息，可通过凭证信息（ticket_info）参数同步。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明shopstring否否否字段名称：提货门店 字段说明：提货门店可能与售卖门店不一行，因此必传resv_typestring是否否字段名称：自提订单类型 字段说明：自提订单类型：实时单(instant)/预约单(reservation)typestring否否否取单凭证名end_timestring否否否字段名称：预计提货结束时间 字段说明：预计提货结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。addressstring否否否字段名称：提货地址 字段说明：提货地址可能与门店地址不一样，因此必传timestring否否否字段名称：预计提货开始时间 字段说明：预计提货开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。ticket_nostring否否否取货码门店信息若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明merchant_shop_idstring否否否商家侧门店idaddressstring否否否门店地址namestring否否否门店名称预约成功 (book_successfully)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-预约成功 (book_successfully)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否否外部订单号。由商家自定义。 注意：同一笔订单更新状态时，需与首次同步入参一致。buyer_id（buyer_open_id）string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认 应用-开发配置-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相同的两次同步会被幂等处理。category_idstring否否否支付宝标准服务类目code,本模板支持类目code:c000003265service_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或discount_amount已回传时必传，且amount=pay_amount discount_amount))是否订单总金额。精确到小数点后两位，单位为元pay_amountprice选填，建议传入该参数否否实际支付金额。精确到小数点后两位。单位为元discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为元shop_infoordershopinfo否否否门店信息。详见下文: 门店信息item_order_listitemorderinfo是否否商品信息列表。详见下文: 商品信息列表ticket_infoticketinfo是否否凭证信息。如取件码等信息在此传递。详见下文: 凭证信息ext_infoorderextinfo是是否订单扩展字段。详见下文 订单扩展字段。订单扩展字段开发者需通过订单扩展字段（ext_info）更新订单状态，订单业务信息，订单类型等数据，入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_statusl ext_valuestring是是否订单状态, 例: book_successfullyl ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: self_pickl 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） 的各项入参详情如下：参数参数类型是否必填能否更新是否消息使用字段参数说明come_againstring否否否字段名称：再来一单 字段说明：商家或服务商回流的再来一单小程序完整链接rebate_pidstring否否否字段名称：服务商pid 字段说明:【特殊必填】餐饮返佣所需服务商pidstart_timestring是否是字段名称：预约开始时间 字段说明：预约到店自提的时间点,时间格式为 yyyy-mm-dd hh:mm:ss。invoicestring否否否字段名称：开发票 字段说明：商家或服务商的开票链接商品信息列表开发者需通过商品信息列表字段（item_order_list）传入商品图片、商品详情页等信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否是商品名称。建议商品名称格式为：{商家名称} {商品名称} ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件获取的 material_id凭证信息若商家想在订单中展示取货码/取餐码凭证信息，可通过凭证信息（ticket_info）参数同步。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明shopstring否否否字段名称：提货门店 字段说明：提货门店可能与售卖门店不一行，因此必传resv_typestring否否否字段名称：自提订单类型 字段说明：自提订单类型：实时单(instant)/预约单(reservation)typestring否否否取单凭证名end_timestring否否否字段名称：预计提货结束时间 字段说明：预计提货结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。addressstring否否否字段名称：提货地址 字段说明：提货地址可能与门店地址不一样，因此必传timestring否否否字段名称：预计提货开始时间 字段说明：预计提货开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。ticket_nostring是否是取货码门店信息若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明merchant_shop_idstring否否否商家侧门店idaddressstring否否否门店地址namestring否否是门店名称预约变更 (order_change)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-预约变更 (order_change)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否否外部订单号。由商家自定义。 注意：同一笔订单更新状态时，需与首次同步入参一致。buyer_id（buyer_open_id）string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认 应用-开发配置-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相同的两次同步会被幂等处理。category_idstring否否否支付宝标准服务类目code,本模板支持类目code:c000003265service_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或discount_amount已回传时必传，且amount=pay_amount discount_amount)是否订单总金额。精确到小数点后两位，单位为元pay_amountprice选填，建议传入该参数否否实际支付金额。精确到小数点后两位。单位为元discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为元shop_infoordershopinfo否否否门店信息。详见下文: 门店信息item_order_listitemorderinfo是否否商品信息列表。详见下文: 商品信息列表ticket_infoticketinfo是否否凭证信息。如取件码等信息在此传递。详见下文: 凭证信息ext_infoorderextinfo是是否订单扩展字段。详见下文 订单扩展字段。订单扩展字段开发者需通过订单扩展字段（ext_info）更新订单状态，订单业务信息，订单类型等数据，入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_statusl ext_valuestring是是否订单状态, 例: order_changel ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: self_pickl 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） 的各项入参详情如下：参数参数类型是否必填能否更新是否消息使用字段参数说明come_againstring否否否字段名称：再来一单 字段说明：商家或服务商回流的再来一单小程序完整链接change_timestring是否是字段名称：预约变更时间 字段说明：预约变更后到店自提的时间点,时间格式为 yyyy-mm-dd hh:mm:ss。rebate_pidstring否否否字段名称：服务商pid 字段说明:【特殊必填】餐饮返佣所需服务商pidinvoicestring否否否字段名称：开发票 字段说明：商家或服务商的开票链接商品信息列表开发者需通过商品信息列表字段（item_order_list）传入商品图片、商品详情页等信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否是商品名称。建议商品名称格式为：{商家名称} {商品名称} ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件获取的 material_id凭证信息若商家想在订单中展示取货码/取餐码凭证信息，可通过凭证信息（ticket_info）参数同步。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明shopstring否否否字段名称：提货门店 字段说明：提货门店可能与售卖门店不一行，因此必传resv_typestring否否否字段名称：自提订单类型 字段说明：自提订单类型：实时单(instant)/预约单(reservation)typestring否否否取单凭证名end_timestring否否否字段名称：预计提货结束时间 字段说明：预计提货结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。addressstring否否否字段名称：提货地址 字段说明：提货地址可能与门店地址不一样，因此必传timestring否否否字段名称：预计提货开始时间 字段说明：预计提货开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。ticket_nostring是否是取货码门店信息若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明merchant_shop_idstring否否否商家侧门店idaddressstring否否否门店地址namestring否否否门店名称预约临期 (arrival_time)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-预约临期 (arrival_time)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否否外部订单号。由商家自定义。 注意：同一笔订单更新状态时，需与首次同步入参一致。buyer_id（buyer_open_id）string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认 应用-开发配置-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相同的两次同步会被幂等处理。category_idstring否否否支付宝标准服务类目code,本模板支持类目code:c000003265service_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或discount_amount已回传时必传，且amount=pay_amount discount_amount)是否订单总金额。精确到小数点后两位，单位为元pay_amountprice选填，建议传入该参数否否实际支付金额。精确到小数点后两位。单位为元discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为元shop_infoordershopinfo否否否门店信息。详见下文: 门店信息item_order_listitemorderinfo是否否商品信息列表。详见下文: 商品信息列表ticket_infoticketinfo是否否凭证信息。如取件码等信息在此传递。详见下文: 凭证信息ext_infoorderextinfo是是否订单扩展字段。详见下文 订单扩展字段。订单扩展字段开发者需通过订单扩展字段（ext_info）更新订单状态，订单业务信息，订单类型等数据，入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_statusl ext_valuestring是是否订单状态, 例: arrival_timel ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: self_pickl 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） 的各项入参详情如下：参数参数类型是否必填能否更新是否消息使用字段参数说明come_againstring否否否字段名称：再来一单 字段说明：商家或服务商回流的再来一单小程序完整链接rebate_pidstring否否否字段名称：服务商pid 字段说明:【特殊必填】餐饮返佣所需服务商pidstart_timestring是否是字段名称：预约开始时间 字段说明：预约到店自提的时间点,时间格式为 yyyy-mm-dd hh:mm:ss。invoicestring否否否字段名称：开发票 字段说明：商家或服务商的开票链接商品信息列表开发者需通过商品信息列表字段（item_order_list）传入商品图片、商品详情页等信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否是商品名称。建议商品名称格式为：{商家名称} {商品名称} ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件获取的 material_id凭证信息若商家想在订单中展示取货码/取餐码凭证信息，可通过凭证信息（ticket_info）参数同步。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明shopstring否否否字段名称：提货门店 字段说明：提货门店可能与售卖门店不一行，因此必传resv_typestring否否否字段名称：自提订单类型 字段说明：自提订单类型：实时单(instant)/预约单(reservation)typestring否否否取单凭证名end_timestring否否否字段名称：预计提货结束时间 字段说明：预计提货结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。addressstring否否否字段名称：提货地址 字段说明：提货地址可能与门店地址不一样，因此必传timestring否否否字段名称：预计提货开始时间 字段说明：预计提货开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。ticket_nostring是否是取货码门店信息若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明merchant_shop_idstring否否否商家侧门店idaddressstring否否否门店地址namestring否否是门店名称
