更新时间：2024-10-23 18:08:02配置项检测工具收藏订阅更新我的文档设置接入检测（即可查看检测结果）若有未通过的接入检测项，接口将无法调通去登录返回文档商家需通过 alipay.merchant.order.sync（订单数据同步接口）订单扩展字段 ext_info#merchant_order_status 参数更新订单状态，具体状态说明如下。订单状态流转说明订单状态流转图订单状态说明●支持跨状态传递，如：create（下单成功）可直接跳转至 choose_room_f（选房失败）。●不要求首次同步订单状态必须为 create（下单成功）。●订单状态发生变更后，需要及时同步最新状态。●当前场景定义的订单状态（中文和英文名）如下：状态中文名状态英文名是否发送服务消息是否发送push下单成功create否否待支付wait_pay是否已支付paid否否待入住to_be_check_in是否已入住check_in是是待退房to_check_out是否已续住have_stay是否已退房check_out是否订单完成finished否否申请取消cancelling否否订单取消cancelled是否订单关闭closed否否取消失败un_cancel是是已确认confirmed是是注意：不同订单状态，仅是 否发送服务消息 为 是 时，用户才能在 消息列表（支付宝凯发k8官方网娱乐官方首页服务提醒入口进入或凯发k8官方网娱乐官方首页底部消息 tab 进入）查看服务订单消息提醒。不同状态参数使用说明下单成功 (create)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-下单成功（create）时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否否外部订单号。由商家自定义。 注意：同一笔订单更新状态时，需与首次同步入参一致。buyer_id（buyer_open_id）string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认 应用-开发配置-openid配置管理 已启用。无该配置项，可查看 openid配置申请。order_typestring是否否订单类型。固定为 service_order（服务订单）。order_create_timestring是否否订单创建时间，即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。order_modified_timestring是是否订单修改时间，时间格式为 yyyy-mm-dd hh:mm:ss.sss，订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制，防止乱序。order_modified_time 较晚的同步会被最终存储，order_modified_time 相同的两次同步会被幂等处理。service_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)是否订单总金额。精确到小数点后两位，单位为元。pay_amountprice选填，建议传入该参数否否实际支付金额。精确到小数点后两位。单位为元。discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为元。shop_infoordershopinfo是否否门店信息。详情可查看下文 门店信息。item_order_listitemorderinfo是否否商品信息列表。详情可查看下文 商品信息列表。ext_infoorderextinfo是是否订单扩展字段。详情可查看 订单扩展字段。订单扩展字段开发者需通过订单扩展字段（ext_info）更新订单状态，订单业务信息，订单类型等数据，入参为 ext_key（对应参数的key）、ext_value（对应参数的value）配合使用。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_status。l ext_valuestring是是否订单状态, 例: create。l ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: hotel_booking。l ext_keystring是否否订单详情地址 key。固定为merchant_order_link_page，一笔订单同步过程中需要保持一致。l ext_valuestring是否否商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同，且需是小程序内部页面路径，例如：/pages/index/index?orderid=10190608609185。l ext_keystring是否否商家小程序 appid key。固定为 tiny_app_id。l ext_valuestring是否否商家小程序 appid value。传入订单归属的小程序 appid。l ext_keystring是否否订单业务场景相关的信息 key。固定为 business_info。l ext_valuejsonstring是是否订单业务信息详情 value。入参详情可查看下文 业务信息参数。业务信息参数业务信息参数（business_info） 的各项入参详情如下：参数参数类型是否必填能否更新是否消息使用字段参数说明check_out_datestring否否否离店日期。check_in_timestring否否否字段名称：check in 时间 字段说明：check in时间，时间格式为 yyyy-mm-dd hh:mm:ss。cancel_rule_descriptionstring否否否取消规则描述。cancel_rule_namestring否否否取消规则名称。contactstring否否否联系人姓名。hotel_numberstring否否否字段名称：酒店电话。 字段说明：酒店联系电话。deadlinestring否否否字段名称：到店最晚时间。 字段说明：酒店规定的最晚到店时间,时间格式为 yyyy-mm-dd hh:mm:ss。tel_numberstring否否否联系人电话。check_out_timestring否否否字段名称：check out 时间。 字段说明：check out 时间，时间格式为 yyyy-mm-dd hh:mm:ss。booking_timestring否否否字段名称：预约入住时间。 字段说明：预约入住时间，时间格式为 yyyy-mm-dd hh:mm:ss。member_levelstring否否否会员等级。payment_typestring否否否字段名称：付款类型。 字段说明：“在线付款”、“到店付款”。check_in_datestring否否否入住日期。商品信息列表开发者需通过商品信息列表字段（item_order_list）传入商品图片、商品详情页等信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为：{商家名称} {商品名称}。 ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id。门店信息若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明merchant_shop_idstring否否否商家侧门店 id。addressstring否否否门店地址。alipay_shop_idstring否否否蚂蚁侧门店 id。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配置管理 已启用。无该配置项，可查看 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相同的两次同步会被幂等处理。service_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)是否订单总金额。精确到小数点后两位，单位为元。pay_amountprice选填，建议传入该参数否否实际支付金额。精确到小数点后两位。单位为元。discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为元。shop_infoordershopinfo是否否门店信息。详情可查看下文 门店信息。item_order_listitemorderinfo是否否商品信息列表。详情可查看下文 商品信息列表。ext_infoorderextinfo是是否订单扩展字段。详情可查看下文 订单扩展字段。订单扩展字段开发者需通过订单扩展字段（ext_info）更新订单状态，订单业务信息，订单类型等数据，入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_status。l ext_valuestring是是否订单状态, 例: wait_payl ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: hotel_booking。l ext_keystring是否是订单详情地址 key。固定为merchant_order_link_page，一笔订单同步过程中需要保持一致。l ext_valuestring是否是商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同，且需是小程序内部页面路径，例如：/pages/index/index?orderid=10190608609185。l ext_keystring是否否商家小程序 appid key。固定为 tiny_app_id。l ext_valuestring是否否商家小程序 appid value。传入订单归属的小程序 appid。l ext_keystring是否否订单业务场景相关的信息 key。固定为 business_info。l ext_valuejsonstring是是否订单业务信息详情 value。入参详情见下文 业务信息参数。业务信息参数业务信息参数（business_info） 的各项入参详情如下：参数参数类型是否必填能否更新是否消息使用字段参数说明check_out_datestring是否否离店日期。check_in_timestring是否否字段名称：check in 时间。 字段说明：check in 时间，时间格式为 yyyy-mm-dd hh:mm:ss。cancel_rule_descriptionstring否否否取消规则描述。cancel_rule_namestring否否否取消规则名称。contactstring否否否联系人姓名。hotel_numberstring否否否字段名称：酒店电话。字段说明：酒店联系电话。deadlinestring否否否字段名称：到店最晚时间。字段说明：酒店规定的最晚到店时间,时间格式为 yyyy-mm-dd hh:mm:ss。tel_numberstring否否否联系人电话。check_out_timestring是否否字段名称：check out 时间。 字段说明：check out 时间，时间格式为 yyyy-mm-dd hh:mm:ss。booking_timestring否否否字段名称：预约入住时间。 字段说明：预约入住时间，时间格式为 yyyy-mm-dd hh:mm:ss。member_levelstring否否否会员等级。payment_typestring否否否字段名称：付款类型。 字段说明：“在线付款”、“到店付款”。check_in_datestring是否否入住日期。商品信息列表开发者需通过商品信息列表字段（item_order_list）传入商品图片、商品详情页等信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否是商品名称。建议商品名称格式为：{商家名称} {商品名称}。 ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id。门店信息若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明merchant_shop_idstring否否否商家侧门店 id。addressstring否否否门店地址。namestring是否否门店名称。已支付 (paid)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-已支付 (paid)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否否外部订单号。由商家自定义。 注意：同一笔订单更新状态时，需与首次同步入参一致。buyer_id（buyer_open_id）string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认 应用-开发配置-openid配置管理 已启用。无该配置项，可查看 openid配置申请。order_typestring是否否订单类型。固定为service_order（服务订单）。order_create_timestring是否否订单创建时间，即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。order_modified_timestring是是否订单修改时间，时间格式为 yyyy-mm-dd hh:mm:ss.sss，订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制，防止乱序。order_modified_time较晚的同步会被最终存储，order_modified_time相同的两次同步会被幂等处理。service_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)是否订单总金额。精确到小数点后两位，单位为元。pay_amountprice选填，建议传入该参数否否实际支付金额。精确到小数点后两位。单位为元。discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为元。shop_infoordershopinfo否否否门店信息。详情可查看下文 门店信息。item_order_listitemorderinfo是否否商品信息列表。详情可查看下文 商品信息列表。ext_infoorderextinfo是是否订单扩展字段。详情可查看下文 订单扩展字段。订单扩展字段开发者需通过订单扩展字段（ext_info）更新订单状态，订单业务信息，订单类型等数据，入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_status。l ext_valuestring是是否订单状态, 例: paid。l ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: hotel_booking。l ext_keystring是否否订单详情地址 key。固定为merchant_order_link_page，一笔订单同步过程中需要保持一致。l ext_valuestring是否否商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同，且需是小程序内部页面路径，例如：/pages/index/index?orderid=10190608609185。l ext_keystring是否否商家小程序 appid key。固定为 tiny_app_id。l ext_valuestring是否否商家小程序 appid value。传入订单归属的小程序 appid。l ext_keystring是否否订单业务场景相关的信息 key。固定为 business_info。l ext_valuejsonstring是是否订单业务信息详情 value。入参详情可查看下文 业务信息参数。业务信息参数业务信息参数（business_info） 的各项入参详情如下：参数参数类型是否必填能否更新是否消息使用字段参数说明check_out_datestring是否否离店日期。check_in_timestring是否否字段名称：check in时间。 字段说明：check in时间，时间格式为 yyyy-mm-dd hh:mm:ss。cancel_rule_descriptionstring否否否取消规则描述。cancel_rule_namestring否否否取消规则名称。contactstring否否否联系人姓名。hotel_numberstring否否否字段名称：酒店电话。 字段说明：酒店联系电话。deadlinestring否否否字段名称：到店最晚时间。 字段说明：酒店规定的最晚到店时间，时间格式为 yyyy-mm-dd hh:mm:ss。tel_numberstring否否否联系人电话。check_out_timestring是否否字段名称：check out 时间。 字段说明：check out 时间，时间格式为 yyyy-mm-dd hh:mm:ss。booking_timestring否否否字段名称：预约入住时间。 字段说明：预约入住时间，时间格式为 yyyy-mm-dd hh:mm:ss。member_levelstring否否否会员等级。payment_typestring否否否字段名称：付款类型。 字段说明：“在线付款”、“到店付款”。check_in_datestring是否否入住日期。商品信息列表开发者需通过商品信息列表字段（item_order_list）传入商品图片、商品详情页等信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为：{商家名称} {商品名称}。 ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id。门店信息若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明merchant_shop_idstring否否否商家侧门店 id。addressstring否否否门店地址。namestring否否否门店名称。待入住 (to_be_check_in)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-待入住 (to_be_check_in)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否否外部订单号。由商家自定义。 注意：同一笔订单更新状态时，需与首次同步入参一致。buyer_id（buyer_open_id）string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认 应用-开发配置-openid配置管理 已启用。无该配置项，可查看 openid配置申请。order_typestring是否否订单类型。固定为service_order（服务订单）。order_create_timestring是否是订单创建时间，即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。order_modified_timestring是是否订单修改时间，时间格式为 yyyy-mm-dd hh:mm:ss.sss，订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制，防止乱序。order_modified_time较晚的同步会被最终存储，order_modified_time相同的两次同步会被幂等处理。service_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)是否订单总金额。精确到小数点后两位，单位为元。pay_amountprice选填，建议传入该参数否否实际支付金额。精确到小数点后两位。单位为元。discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为元。shop_infoordershopinfo否否否门店信息。详情可查看下文 门店信息。item_order_listitemorderinfo是否否商品信息列表。详情可查看下文 商品信息列表。ext_infoorderextinfo是是否订单扩展字段。详情可查看下文 订单扩展字段。订单扩展字段开发者需通过订单扩展字段（ext_info）更新订单状态，订单业务信息，订单类型等数据，入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_status。l ext_valuestring是是否订单状态, 例: to_be_check_in。l ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: hotel_booking。l ext_keystring是否是订单详情地址 key。固定为merchant_order_link_page，一笔订单同步过程中需要保持一致。l ext_valuestring是否是商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同，且需是小程序内部页面路径，例如：/pages/index/index?orderid=10190608609185。l ext_keystring是否否商家小程序 appid key。固定为 tiny_app_id。l ext_valuestring是否否商家小程序 appid value。传入订单归属的小程序 appid。l ext_keystring是否否订单业务场景相关的信息 key。固定为 business_info。l ext_valuejsonstring是是否订单业务信息详情 value。入参详情可查看下文 业务信息参数。业务信息参数业务信息参数（business_info） 的各项入参详情如下：参数参数类型是否必填能否更新是否消息使用字段参数说明check_out_datestring是否否离店日期。check_in_timestring是否否字段名称：check in 时间。 字段说明：check in 时间，时间格式为 yyyy-mm-dd hh:mm:ss。cancel_rule_descriptionstring否否否取消规则描述。cancel_rule_namestring否否否取消规则名称。contactstring否否否联系人姓名。hotel_numberstring否否否字段名称：酒店电话。 字段说明：酒店联系电话。deadlinestring否否否字段名称：到店最晚时间。 字段说明：酒店规定的最晚到店时间,时间格式为 yyyy-mm-dd hh:mm:ss。tel_numberstring否否否联系人电话。check_out_timestring是否否字段名称：check out 时间。 字段说明：check out 时间，时间格式为 yyyy-mm-dd hh:mm:ss。booking_timestring否否否字段名称：预约入住时间。 字段说明：预约入住时间，时间格式为 yyyy-mm-dd hh:mm:ss。member_levelstring否否否会员等级。payment_typestring否否否字段名称：付款类型。 字段说明：“在线付款”、“到店付款”。check_in_datestring是否是入住日期。商品信息列表开发者需通过商品信息列表字段（item_order_list）传入商品图片、商品详情页等信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否是商品名称。建议商品名称格式为：{商家名称} {商品名称}。 ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id。门店信息若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明merchant_shop_idstring否否否商家侧门店 id。addressstring否否是门店地址。namestring否否是门店名称。已入住 (check_in)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-已入住 (check_in)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否否外部订单号。由商家自定义。 注意：同一笔订单更新状态时，需与首次同步入参一致。buyer_id（buyer_open_id）string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认 应用-开发配置-openid配置管理 已启用。无该配置项，可查看 openid配置申请。order_typestring是否否订单类型。固定为service_order（服务订单）。order_create_timestring是否否订单创建时间，即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。order_modified_timestring是是否订单修改时间，时间格式为 yyyy-mm-dd hh:mm:ss.sss，订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制，防止乱序。order_modified_time较晚的同步会被最终存储，order_modified_time相同的两次同步会被幂等处理。service_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)是否订单总金额。精确到小数点后两位，单位为元。pay_amountprice选填，建议传入该参数否否实际支付金额。精确到小数点后两位。单位为元。discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为元。shop_infoordershopinfo否否否门店信息。详情可查看 门店信息。item_order_listitemorderinfo是否否商品信息列表。详情可查看下文 商品信息列表。ext_infoorderextinfo是是否订单扩展字段。详情可查看下文 订单扩展字段。订单扩展字段开发者需通过订单扩展字段（ext_info）更新订单状态，订单业务信息，订单类型等数据，入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_status。l ext_valuestring是是否订单状态, 例: check_in。l ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: hotel_booking。l ext_keystring是否是订单详情地址 key。固定为merchant_order_link_page，一笔订单同步过程中需要保持一致。l ext_valuestring是否是商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同，且需是小程序内部页面路径，例如：/pages/index/index?orderid=10190608609185。l ext_keystring是否否商家小程序 appid key。固定为 tiny_app_id。l ext_valuestring是否否商家小程序 appid value。传入订单归属的小程序 appid。l ext_keystring是否否订单业务场景相关的信息 key。固定为 business_info。l ext_valuejsonstring是是否订单业务信息详情 value。入参详情可查看下文 业务信息参数。业务信息参数业务信息参数（business_info） 的各项入参详情如下：参数参数类型是否必填能否更新是否消息使用字段参数说明check_out_datestring是否否离店日期。check_in_timestring是否否字段名称：check in 时间。 字段说明：check in 时间，时间格式为 yyyy-mm-dd hh:mm:ss。cancel_rule_descriptionstring否否否取消规则描述。cancel_rule_namestring否否否取消规则名称。contactstring否否是联系人姓名。hotel_numberstring否否否字段名称：酒店电话。 字段说明：酒店联系电话。deadlinestring否否否字段名称：到店最晚时间。 字段说明：酒店规定的最晚到店时间，时间格式为 yyyy-mm-dd hh:mm:ss。tel_numberstring否否否联系人电话。check_out_timestring是否否字段名称：check out 时间。 字段说明：check out 时间，时间格式为 yyyy-mm-dd hh:mm:ss。booking_timestring否否否字段名称：预约入住时间。 字段说明：预约入住时间，时间格式为 yyyy-mm-dd hh:mm:ss。member_levelstring否否否会员等级。payment_typestring否否否字段名称：付款类型。 字段说明：“在线付款”、“到店付款”。check_in_datestring是否否入住日期。room_numberstring否否是字段名称：选房成功房间号 字段说明：选房成功的房间号商品信息列表开发者需通过商品信息列表字段（item_order_list）传入商品图片、商品详情页等信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为：{商家名称} {商品名称}。 ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id。门店信息若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明merchant_shop_idstring否否否商家侧门店 id。addressstring否否否门店地址。namestring否否是门店名称。待退房 (to_check_out)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-待退房 (to_check_out)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否否外部订单号。由商家自定义。 注意：同一笔订单更新状态时，需与首次同步入参一致。buyer_id（buyer_open_id）string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认 应用-开发配置-openid配置管理 已启用。无该配置项，可查看 openid配置申请。order_typestring是否否订单类型。固定为service_order（服务订单）。order_create_timestring是否否订单创建时间，即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。order_modified_timestring是是否订单修改时间，时间格式为 yyyy-mm-dd hh:mm:ss.sss，订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制，防止乱序。order_modified_time较晚的同步会被最终存储，order_modified_time相同的两次同步会被幂等处理。service_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)是否订单总金额。精确到小数点后两位，单位为元。pay_amountprice选填，建议传入该参数否否实际支付金额。精确到小数点后两位。单位为元discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为元。shop_infoordershopinfo否否否门店信息。详情可查看下文 门店信息。item_order_listitemorderinfo是否否商品信息列表。详情可查看下文 商品信息列表。ext_infoorderextinfo是是否订单扩展字段。详情可查看下文 订单扩展字段。订单扩展字段开发者需通过订单扩展字段（ext_info）更新订单状态，订单业务信息，订单类型等数据，入参为 ext_key（对应参数的key）、ext_value（对应参数的value）配合使用。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_status。l ext_valuestring是是否订单状态, 例: to_check_out。l ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: hotel_booking。l 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） 的各项入参详情如下：参数参数类型是否必填能否更新是否消息使用字段参数说明check_out_datestring是否否离店日期。check_in_timestring是否否字段名称：check in 时间。 字段说明：check in时间，时间格式为 yyyy-mm-dd hh:mm:ss。cancel_rule_descriptionstring否否否取消规则描述。cancel_rule_namestring否否否取消规则名称。contactstring否否是联系人姓名。hotel_numberstring否否否字段名称：酒店电话。 字段说明：酒店联系电话。deadlinestring否否否字段名称：到店最晚时间。 字段说明：酒店规定的最晚到店时间，时间格式为 yyyy-mm-dd hh:mm:ss。tel_numberstring否否否联系人电话。check_out_timestring是否是字段名称：check out 时间。 字段说明：check out 时间，时间格式为 yyyy-mm-dd hh:mm:ss。booking_timestring否否否字段名称：预约入住时间。 字段说明：预约入住时间，时间格式为 yyyy-mm-dd hh:mm:ss。member_levelstring否否否会员等级。payment_typestring否否否字段名称：付款类型。 字段说明：“在线付款”、“到店付款”。check_in_datestring是否否入住日期。room_numberstring否否是字段名称：选房成功房间号 字段说明：选房成功的房间号商品信息列表开发者需通过商品信息列表字段（item_order_list）传入商品图片、商品详情页等信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为：{商家名称} {商品名称}。 ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id。门店信息若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明merchant_shop_idstring否否否商家侧门店 id。addressstring否否否门店地址。namestring否否是门店名称。已续住 (have_stay)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-已续住（have_stay）时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否否外部订单号。由商家自定义。 注意：同一笔订单更新状态时，需与首次同步入参一致。buyer_id（buyer_open_id）string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认 应用-开发配置-openid配置管理 已启用。无该配置项，可查看 openid配置申请。order_typestring是否否订单类型。固定为service_order（服务订单）。order_create_timestring是否否订单创建时间，即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。order_modified_timestring是是否订单修改时间，时间格式为 yyyy-mm-dd hh:mm:ss.sss，订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制，防止乱序。order_modified_time较晚的同步会被最终存储，order_modified_time相同的两次同步会被幂等处理。service_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)是否订单总金额。精确到小数点后两位，单位为元。pay_amountprice选填，建议传入该参数否否实际支付金额。精确到小数点后两位。单位为元。discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为元。shop_infoordershopinfo否否否门店信息。详情可查看下文 门店信息。item_order_listitemorderinfo是否否商品信息列表。详情可查看下文 商品信息列表。ext_infoorderextinfo是是否订单扩展字段。详情可查看下文 订单扩展字段。订单扩展字段开发者需通过订单扩展字段（ext_info）更新订单状态，订单业务信息，订单类型等数据，入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_status。l ext_valuestring是是否订单状态, 例: have_stay。l ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: hotel_booking。l ext_keystring是否是订单详情地址 key。固定为merchant_order_link_page，一笔订单同步过程中需要保持一致。l ext_valuestring是否是商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同，且需是小程序内部页面路径，例如：/pages/index/index?orderid=10190608609185。l ext_keystring是否否商家小程序 appid key。固定为 tiny_app_id。l ext_valuestring是否否商家小程序 appid value。传入订单归属的小程序 appid。l ext_keystring是否否订单业务场景相关的信息 key。固定为 business_info。l ext_valuejsonstring是是否订单业务信息详情 value。入参详情可查看下文 业务信息参数。业务信息参数业务信息参数（business_info） 的各项入参详情如下：参数参数类型是否必填能否更新是否消息使用字段参数说明check_out_datestring是否否离店日期。check_in_timestring是否否字段名称：check in 时间。 字段说明：check in时间，时间格式为 yyyy-mm-dd hh:mm:ss。cancel_rule_descriptionstring否否否取消规则描述。cancel_rule_namestring否否否取消规则名称。contactstring否否否联系人姓名。hotel_numberstring否否否字段名称：酒店电话。 字段说明：酒店联系电话。deadlinestring否否否字段名称：到店最晚时间。 字段说明：酒店规定的最晚到店时间，时间格式为 yyyy-mm-dd hh:mm:ss。tel_numberstring否否否联系人电话。check_out_timestring是否否字段名称：check out 时间。 字段说明：check out 时间，时间格式为 yyyy-mm-dd hh:mm:ss。booking_timestring否否否字段名称：预约入住时间。 字段说明：预约入住时间，时间格式为 yyyy-mm-dd hh:mm:ss。member_levelstring否否否会员等级。payment_typestring否否否字段名称：付款类型。 字段说明：“在线付款”、“到店付款”。check_in_datestring是否否入住日期。商品信息列表开发者需通过商品信息列表字段（item_order_list）传入商品图片、商品详情页等信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否是商品名称。建议商品名称格式为：{商家名称} {商品名称}。 ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id。门店信息若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明merchant_shop_idstring否否否商家侧门店 id。addressstring否否是门店地址。namestring否否是门店名称。已退房 (check_out)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-已退房（check_out）时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否否外部订单号。由商家自定义。 注意：同一笔订单更新状态时，需与首次同步入参一致。buyer_id（buyer_open_id）string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认 应用-开发配置-openid配置管理 已启用。无该配置项，可查看 openid配置申请。order_typestring是否否订单类型。固定为service_order（服务订单）。order_create_timestring是否否订单创建时间，即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。order_modified_timestring是是否订单修改时间，时间格式为 yyyy-mm-dd hh:mm:ss.sss，订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制，防止乱序。order_modified_time较晚的同步会被最终存储，order_modified_time相同的两次同步会被幂等处理。service_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)是否订单总金额。精确到小数点后两位，单位为元。pay_amountprice选填，建议传入该参数否否实际支付金额。精确到小数点后两位。单位为元。discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为元。shop_infoordershopinfo否否否门店信息。详情可查看下文 门店信息。item_order_listitemorderinfo是否否商品信息列表。详情可查看下文 商品信息列表。ext_infoorderextinfo是是否订单扩展字段。详情可查看下文 订单扩展字段。订单扩展字段开发者需通过订单扩展字段（ext_info）更新订单状态，订单业务信息，订单类型等数据，入参为 ext_key（对应参数的key）、ext_value（对应参数的value）配合使用。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_status。l ext_valuestring是是否订单状态, 例: check_out。l ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: hotel_booking。l ext_keystring是否是订单详情地址 key。固定为merchant_order_link_page，一笔订单同步过程中需要保持一致。l ext_valuestring是否是商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同，且需是小程序内部页面路径，例如：/pages/index/index?orderid=10190608609185。l ext_keystring是否否商家小程序 appid key。固定为 tiny_app_id。l ext_valuestring是否否商家小程序 appid value。传入订单归属的小程序 appid。l ext_keystring是否否订单业务场景相关的信息 key。固定为 business_info。l ext_valuejsonstring是是否订单业务信息详情 value。入参详情可查看下文 业务信息参数。业务信息参数业务信息参数（business_info） 的各项入参详情如下：参数参数类型是否必填能否更新是否消息使用字段参数说明check_out_datestring是否否离店日期。check_in_timestring是否否字段名称：check in时间。 字段说明：check in时间，时间格式为 yyyy-mm-dd hh:mm:ss。cancel_rule_descriptionstring否否否取消规则描述。cancel_rule_namestring否否否取消规则名称。contactstring否否否联系人姓名。hotel_numberstring否否否字段名称：酒店电话。 字段说明：酒店联系电话。deadlinestring否否否字段名称：到店最晚时间。 字段说明：酒店规定的最晚到店时间，时间格式为 yyyy-mm-dd hh:mm:ss。tel_numberstring否否否联系人电话。check_out_timestring是否是字段名称：check out 时间。 字段说明：check out 时间，时间格式为 yyyy-mm-dd hh:mm:ss。booking_timestring否否否字段名称：预约入住时间。 字段说明：预约入住时间，时间格式为 yyyy-mm-dd hh:mm:ss。member_levelstring否否否会员等级。payment_typestring否否否字段名称：付款类型。 字段说明：“在线付款”、“到店付款”。check_in_datestring是否否入住日期。商品信息列表开发者需通过商品信息列表字段（item_order_list）传入商品图片、商品详情页等信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否是商品名称。建议商品名称格式为：{商家名称} {商品名称}。 ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id。门店信息若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明merchant_shop_idstring否否否商家侧门店 id。addressstring否否是门店地址。namestring否否是门店名称。订单完成 (finished)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-订单完成（finished）时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否否外部订单号。由商家自定义。 注意：同一笔订单更新状态时，需与首次同步入参一致。buyer_id（buyer_open_id）string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认 应用-开发配置-openid配置管理 已启用。无该配置项，可查看 openid配置申请。order_typestring是否否订单类型。固定为service_order（服务订单）。order_create_timestring是否否订单创建时间，即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。order_modified_timestring是是否订单修改时间，时间格式为 yyyy-mm-dd hh:mm:ss.sss，订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制，防止乱序。order_modified_time较晚的同步会被最终存储，order_modified_time 相同的两次同步会被幂等处理。service_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)是否订单总金额。精确到小数点后两位，单位为元。pay_amountprice选填，建议传入该参数否否实际支付金额。精确到小数点后两位。单位为元。discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为元。shop_infoordershopinfo否否否门店信息。详情可查看下文 门店信息。item_order_listitemorderinfo是否否商品信息列表。详情可查看下文 商品信息列表。ext_infoorderextinfo是是否订单扩展字段。详情可查看下文 订单扩展字段。订单扩展字段开发者需通过订单扩展字段（ext_info）更新订单状态，订单业务信息，订单类型等数据，入参为 ext_key（对应参数的key）、ext_value（对应参数的value）配合使用。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_status。l ext_valuestring是是否订单状态, 例: finished。l ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: hotel_booking。l ext_keystring是否否订单详情地址 key。固定为merchant_order_link_page，一笔订单同步过程中需要保持一致。l ext_valuestring是否否商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同，且需是小程序内部页面路径，例如：/pages/index/index?orderid=10190608609185。l ext_keystring是否否商家小程序 appid key。固定为 tiny_app_id。l ext_valuestring是否否商家小程序 appid value。传入订单归属的小程序 appid。l ext_keystring是否否订单业务场景相关的信息 key。固定为 business_info。l ext_valuejsonstring是是否订单业务信息详情 value。入参详情可查看下文 业务信息参数。业务信息参数业务信息参数（business_info） 的各项入参详情如下：参数参数类型是否必填能否更新是否消息使用字段参数说明check_out_datestring是否否离店日期。check_in_timestring是否否字段名称：check in 时间。 字段说明：check in时间，时间格式为 yyyy-mm-dd hh:mm:ss。cancel_rule_descriptionstring否否否取消规则描述。cancel_rule_namestring否否否取消规则名称。contactstring否否否联系人姓名。hotel_numberstring否否否字段名称：酒店电话。 字段说明：酒店联系电话。deadlinestring否否否字段名称：到店最晚时间。 字段说明：酒店规定的最晚到店时间,时间格式为 yyyy-mm-dd hh:mm:ss。tel_numberstring否否否联系人电话。check_out_timestring是否否字段名称：check out 时间。 字段说明：check out 时间，时间格式为 yyyy-mm-dd hh:mm:ss。booking_timestring否否否字段名称：预约入住时间。 字段说明：预约入住时间，时间格式为 yyyy-mm-dd hh:mm:ss。member_levelstring否否否会员等级。payment_typestring否否否字段名称：付款类型。 字段说明：“在线付款”、“到店付款”。check_in_datestring是否否入住日期。商品信息列表开发者需通过商品信息列表字段（item_order_list）传入商品图片、商品详情页等信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为：{商家名称} {商品名称}。 ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id。门店信息若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明merchant_shop_idstring否否否商家侧门店 id。addressstring否否否门店地址。namestring否否否门店名称。申请取消 (cancelling)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-申请取消（cancelling）时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否否外部订单号。由商家自定义。 注意：同一笔订单更新状态时，需与首次同步入参一致。buyer_id（buyer_open_id）string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认 应用-开发配置-openid配置管理 已启用。无该配置项，可查看 openid配置申请。order_typestring是否否订单类型。固定为service_order（服务订单）。order_create_timestring是否否订单创建时间，即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。order_modified_timestring是是否订单修改时间，时间格式为 yyyy-mm-dd hh:mm:ss.sss，订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制，防止乱序。order_modified_time较晚的同步会被最终存储，order_modified_time相同的两次同步会被幂等处理。service_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)是否订单总金额。精确到小数点后两位，单位为元。pay_amountprice选填，建议传入该参数否否实际支付金额。精确到小数点后两位。单位为元。discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为元。shop_infoordershopinfo否否否门店信息。详情可查看下文 门店信息。item_order_listitemorderinfo是否否商品信息列表。详情可查看下文 商品信息列表。ext_infoorderextinfo是是否订单扩展字段。详情可查看下文 订单扩展字段。订单扩展字段开发者需通过订单扩展字段（ext_info）更新订单状态，订单业务信息，订单类型等数据，入参为 ext_key（对应参数的key）、ext_value（对应参数的value）配合使用。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_status。l ext_valuestring是是否订单状态, 例: cancelling。l ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: hotel_booking。l 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） 的各项入参详情如下：参数参数类型是否必填能否更新是否消息使用字段参数说明check_out_datestring是否否离店日期。check_in_timestring是否否字段名称：check in 时间。 字段说明：check in 时间，时间格式为 yyyy-mm-dd hh:mm:ss。cancel_rule_descriptionstring否否否取消规则描述。cancel_rule_namestring否否否取消规则名称。contactstring否否否联系人姓名。hotel_numberstring否否否字段名称：酒店电话。 字段说明：酒店联系电话。deadlinestring否否否字段名称：到店最晚时间。 字段说明：酒店规定的最晚到店时间，时间格式为 yyyy-mm-dd hh:mm:ss。tel_numberstring否否否联系人电话。check_out_timestring是否否字段名称：check out 时间。 字段说明：check out 时间，时间格式为 yyyy-mm-dd hh:mm:ss。booking_timestring否否否字段名称：预约入住时间。 字段说明：预约入住时间，时间格式为 yyyy-mm-dd hh:mm:ss。member_levelstring否否否会员等级。payment_typestring否否否字段名称：付款类型。 字段说明：“在线付款”、“到店付款”。check_in_datestring是否否入住日期。商品信息列表开发者需通过商品信息列表字段（item_order_list）传入商品图片、商品详情页等信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为：{商家名称} {商品名称}。 ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id。门店信息若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明merchant_shop_idstring否否否商家侧门店 id。addressstring否否否门店地址。namestring否否否门店名称。订单取消 (cancelled)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-订单取消 (cancelled)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否否外部订单号。由商家自定义。 注意：同一笔订单更新状态时，需与首次同步入参一致。buyer_id（buyer_open_id）string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认 应用-开发配置-openid配置管理 已启用。无该配置项，可查看 openid配置申请。order_typestring是否否订单类型。固定为service_order（服务订单）。order_create_timestring是否是订单创建时间，即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。order_modified_timestring是是否订单修改时间，时间格式为 yyyy-mm-dd hh:mm:ss.sss，订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制，防止乱序。order_modified_time较晚的同步会被最终存储，order_modified_time相同的两次同步会被幂等处理。service_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)是否订单总金额。精确到小数点后两位，单位为元。pay_amountprice选填，建议传入该参数否否实际支付金额。精确到小数点后两位。单位为元。discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为元。shop_infoordershopinfo否否否门店信息。详情可查看下文 门店信息。item_order_listitemorderinfo是否否商品信息列表。详情可查看下文 商品信息列表。ext_infoorderextinfo是是否订单扩展字段。详情可查看下文 订单扩展字段。订单扩展字段开发者需通过订单扩展字段（ext_info）更新订单状态，订单业务信息，订单类型等数据，入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_status。l ext_valuestring是是否订单状态, 例: cancelled。l ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: hotel_booking。l ext_keystring是否是订单详情地址 key。固定为merchant_order_link_page，一笔订单同步过程中需要保持一致。l ext_valuestring是否是商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同，且需是小程序内部页面路径，例如：/pages/index/index?orderid=10190608609185。l ext_keystring是否否商家小程序 appid key。固定为 tiny_app_id。l ext_valuestring是否否商家小程序 appid value。传入订单归属的小程序 appid。l ext_keystring是否否订单业务场景相关的信息 key。固定为 business_info。l ext_valuejsonstring是是否订单业务信息详情 value。入参详情可查看下文 业务信息参数。业务信息参数业务信息参数（business_info） 的各项入参详情如下：参数参数类型是否必填能否更新是否消息使用字段参数说明check_out_datestring是否否离店日期。check_in_timestring是否否字段名称：check in 时间。 字段说明：check in 时间，时间格式为 yyyy-mm-dd hh:mm:ss。cancel_rule_descriptionstring否否否取消规则描述。cancel_rule_namestring否否否取消规则名称。contactstring否否否联系人姓名。hotel_numberstring否否否字段名称：酒店电话。 字段说明：酒店联系电话。deadlinestring否否否字段名称：到店最晚时间。 字段说明：酒店规定的最晚到店时间，时间格式为 yyyy-mm-dd hh:mm:ss。tel_numberstring否否否联系人电话。check_out_timestring是否否字段名称：check out 时间。 字段说明：check out 时间，时间格式为 yyyy-mm-dd hh:mm:ss。booking_timestring否否否字段名称：预约入住时间。 字段说明：预约入住时间，时间格式为 yyyy-mm-dd hh:mm:ss。member_levelstring否否否会员等级。payment_typestring否否否字段名称:付款类型。 字段说明：“在线付款”、“到店付款”。check_in_datestring是否否入住日期。商品信息列表开发者需通过商品信息列表字段（item_order_list）传入商品图片、商品详情页等信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否是商品名称。建议商品名称格式为：{商家名称} {商品名称}。 ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id。门店信息若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明merchant_shop_idstring否否否商家侧门店 id。addressstring否否否门店地址。namestring否否否门店名称。订单关闭 (closed)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-订单关闭 (closed)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否否外部订单号。由商家自定义。 注意：同一笔订单更新状态时，需与首次同步入参一致。buyer_id（buyer_open_id）string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认 应用-开发配置-openid配置管理 已启用。无该配置项，可查看 openid配置申请。order_typestring是否否订单类型。固定为 service_order（服务订单）。order_create_timestring是否否订单创建时间，即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。order_modified_timestring是是否订单修改时间，时间格式为 yyyy-mm-dd hh:mm:ss.sss，订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制，防止乱序。order_modified_time较晚的同步会被最终存储，order_modified_time相同的两次同步会被幂等处理。service_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)是否订单总金额。精确到小数点后两位，单位为元。pay_amountprice选填，建议传入该参数否否实际支付金额。精确到小数点后两位。单位为元。discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为元。shop_infoordershopinfo否否否门店信息。详情可查看下文 门店信息。item_order_listitemorderinfo是否否商品信息列表。详情可查看下文 商品信息列表。ext_infoorderextinfo是是否订单扩展字段。详情可查看下文 订单扩展字段。订单扩展字段开发者需通过订单扩展字段（ext_info）更新订单状态，订单业务信息，订单类型等数据，入参为 ext_key（对应参数的key）、ext_value（对应参数的value）配合使用。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_status。l ext_valuestring是是否订单状态, 例: closed。l ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: hotel_booking。l ext_keystring是否否订单详情地址 key。固定为merchant_order_link_page，一笔订单同步过程中需要保持一致。l ext_valuestring是否否商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同，且需是小程序内部页面路径，例如：/pages/index/index?orderid=10190608609185。l ext_keystring是否否商家小程序 appid key。固定为 tiny_app_id。l ext_valuestring是否否商家小程序 appid value。传入订单归属的小程序 appid。l ext_keystring是否否订单业务场景相关的信息 key。固定为 business_info。l ext_valuejsonstring是是否订单业务信息详情 value。入参详情可查看下文 业务信息参数。业务信息参数业务信息参数（business_info） 的各项入参详情如下：参数参数类型是否必填能否更新是否消息使用字段参数说明check_out_datestring是否否离店日期。check_in_timestring是否否字段名称：check in 时间。 字段说明：check in 时间，时间格式为 yyyy-mm-dd hh:mm:ss。cancel_rule_descriptionstring否否否取消规则描述。cancel_rule_namestring否否否取消规则名称。contactstring否否否联系人姓名。hotel_numberstring否否否字段名称：酒店电话。 字段说明：酒店联系电话。deadlinestring否否否字段名称：到店最晚时间。 字段说明：酒店规定的最晚到店时间，时间格式为 yyyy-mm-dd hh:mm:ss。tel_numberstring否否否联系人电话。check_out_timestring是否否字段名称：check out 时间。 字段说明：check out 时间，时间格式为 yyyy-mm-dd hh:mm:ss。booking_timestring否否否字段名称：预约入住时间。 字段说明：预约入住时间，时间格式为 yyyy-mm-dd hh:mm:ss。member_levelstring否否否会员等级。payment_typestring否否否字段名称：付款类型。 字段说明：“在线付款”、“到店付款”。check_in_datestring是否否入住日期。商品信息列表开发者需通过商品信息列表字段（item_order_list）传入商品图片、商品详情页等信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为：{商家名称} {商品名称}。 ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id。门店信息若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明merchant_shop_idstring否否否商家侧门店 id。addressstring否否否门店地址。namestring否否否门店名称。取消失败 (un_cancel)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-取消失败 (un_cancel)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否否外部订单号。由商家自定义。 注意：同一笔订单更新状态时，需与首次同步入参一致。buyer_id（buyer_open_id）string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认 应用-开发配置-openid配置管理 已启用。无该配置项，可查看 openid配置申请。order_typestring是否否订单类型。固定为 service_order（服务订单）。order_create_timestring是否否订单创建时间，即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。order_modified_timestring是是否订单修改时间，时间格式为 yyyy-mm-dd hh:mm:ss.sss，订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制，防止乱序。order_modified_time较晚的同步会被最终存储，order_modified_time相同的两次同步会被幂等处理。service_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)是否订单总金额。精确到小数点后两位，单位为元。pay_amountprice选填，建议传入该参数否否实际支付金额。精确到小数点后两位。单位为元。discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为元。shop_infoordershopinfo是否否门店信息。详情可查看下文 门店信息。item_order_listitemorderinfo是否否商品信息列表。详情可查看下文 商品信息列表。ext_infoorderextinfo是是否订单扩展字段。详情可查看下文 订单扩展字段。订单扩展字段开发者需通过订单扩展字段（ext_info）更新订单状态，订单业务信息，订单类型等数据，入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_status。l ext_valuestring是是否订单状态, 例: un_cancel。l ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: hotel_booking。l ext_keystring是否是订单详情地址 key。固定为merchant_order_link_page，一笔订单同步过程中需要保持一致。l ext_valuestring是否是商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同，且需是小程序内部页面路径，例如：/pages/index/index?orderid=10190608609185。l ext_keystring是否否商家小程序 appid key。固定为 tiny_app_id。l ext_valuestring是否否商家小程序 appid value。传入订单归属的小程序 appid。l ext_keystring是否否订单业务场景相关的信息 key。固定为 business_info。l ext_valuejsonstring是是否订单业务信息详情 value。入参详情可查看下文 业务信息参数。业务信息参数业务信息参数（business_info）的各项入参详情如下：参数参数类型是否必填能否更新是否消息使用字段参数说明reasonstring是否是字段名称：取消失败原因。 字段说明：酒店取消失败的原因。check_out_datestring否否否离店日期。check_in_timestring否否否字段名称：check in时间。 字段说明：check in 时间，时间格式为 yyyy-mm-dd hh:mm:ss。cancel_rule_descriptionstring否否否取消规则描述。cancel_rule_namestring否否否取消规则名称。contactstring是否是联系人姓名。hotel_numberstring否否否字段名称：酒店电话。 字段说明：酒店联系电话。deadlinestring否否否字段名称：到店最晚时间。 字段说明：酒店规定的最晚到店时间,时间格式为 yyyy-mm-dd hh:mm:ss。tel_numberstring否否否联系人电话。check_out_timestring否否否字段名称：check out 时间。 字段说明：check out 时间，时间格式为 yyyy-mm-dd hh:mm:ss。booking_timestring是否是字段名称：预约入住时间。 字段说明：预约入住时间，时间格式为 yyyy-mm-dd hh:mm:ss。member_levelstring否否否会员等级。payment_typestring否否否字段名称：付款类型。 字段说明：“在线付款”、“到店付款”。check_in_datestring否否否入住日期。商品信息列表开发者需通过商品信息列表字段（item_order_list）传入商品图片、商品详情页等信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否是商品名称。建议商品名称格式为：{商家名称} {商品名称}。 ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id。门店信息若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明merchant_shop_idstring否否否商家侧门店 id。addressstring否否否门店地址。alipay_shop_idstring否否否蚂蚁侧门店 id。namestring是否是门店名称。已确认 (confirmed)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-已确认 (confirmed)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否否外部订单号。由商家自定义。 注意：同一笔订单更新状态时，需与首次同步入参一致。buyer_id（buyer_open_id）string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认 应用-开发配置-openid配置管理 已启用。无该配置项，可查看 openid配置申请。order_typestring是否否订单类型。固定为service_order（服务订单）。order_create_timestring是否否订单创建时间，即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。order_modified_timestring是是否订单修改时间，时间格式为 yyyy-mm-dd hh:mm:ss.sss，订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制，防止乱序。order_modified_time较晚的同步会被最终存储，order_modified_time相同的两次同步会被幂等处理。service_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)是否订单总金额。精确到小数点后两位，单位为元。pay_amountprice选填，建议传入该参数否否实际支付金额。精确到小数点后两位。单位为元。discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为元。shop_infoordershopinfo是否否门店信息。详情可查看下文 门店信息。item_order_listitemorderinfo是否否商品信息列表。详情可查看下文 商品信息列表。ext_infoorderextinfo是是否订单扩展字段。详情可查看 订单扩展字段。订单扩展字段开发者需通过订单扩展字段（ext_info）更新订单状态，订单业务信息，订单类型等数据，入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_status。l ext_valuestring是是否订单状态, 例: confirmed。l ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: hotel_booking。l ext_keystring是否是订单详情地址 key。固定为merchant_order_link_page，一笔订单同步过程中需要保持一致。l ext_valuestring是否是商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同，且需是小程序内部页面路径，例如：/pages/index/index?orderid=10190608609185。l ext_keystring是否否商家小程序 appid key。固定为 tiny_app_id。l ext_valuestring是否否商家小程序 appid value。传入订单归属的小程序 appid。l ext_keystring是否否订单业务场景相关的信息 key。固定为 business_info。l ext_valuejsonstring是是否订单业务信息详情 value。入参详情可查看下文 业务信息参数。业务信息参数业务信息参数（business_info） 的各项入参详情如下：参数参数类型是否必填能否更新是否消息使用字段参数说明check_out_datestring否否否离店日期。check_in_timestring否否否字段名称：check in 时间。 字段说明：check in时间，时间格式为 yyyy-mm-dd hh:mm:ss。cancel_rule_descriptionstring否否否取消规则描述。cancel_rule_namestring否否否取消规则名称。contactstring是否是联系人姓名。hotel_numberstring否否否字段名称：酒店电话。 字段说明：酒店联系电话。deadlinestring否否否字段名称：到店最晚时间。 字段说明：酒店规定的最晚到店时间，时间格式为 yyyy-mm-dd hh:mm:ss。tel_numberstring否否否联系人电话。check_out_timestring否否否字段名称：check out 时间。 字段说明：check out 时间，时间格式为 yyyy-mm-dd hh:mm:ss。booking_timestring是否是字段名称：预约入住时间。 字段说明：预约入住时间，时间格式为 yyyy-mm-dd hh:mm:ss。member_levelstring否否否会员等级。payment_typestring否否否字段名称：付款类型。 字段说明：“在线付款”、“到店付款”。check_in_datestring否否否入住日期。商品信息列表开发者需通过商品信息列表字段（item_order_list）传入商品图片、商品详情页等信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否是商品名称。建议商品名称格式为：{商家名称} {商品名称}。 ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id。门店信息若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明merchant_shop_idstring否否否商家侧门店 id。addressstring否否否门店地址。alipay_shop_idstring否否否蚂蚁侧门店 id。namestring是否是门店名称。待选房 (to_choose_room)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-待选房 (to_choose_room)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否否外部订单号。由商家自定义。 注意：同一笔订单更新状态时，需与首次同步入参一致。buyer_id（buyer_open_id）string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认 应用-开发配置-openid配置管理 已启用。无该配置项，可查看 openid配置申请。order_typestring是否否订单类型。固定为service_order（服务订单）。order_create_timestring是否否订单创建时间，即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。order_modified_timestring是是否订单修改时间，时间格式为 yyyy-mm-dd hh:mm:ss.sss，订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制，防止乱序。order_modified_time较晚的同步会被最终存储，order_modified_time相同的两次同步会被幂等处理。service_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)是否订单总金额。精确到小数点后两位，单位为元。pay_amountprice选填，建议传入该参数否否实际支付金额。精确到小数点后两位。单位为元。discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为元。shop_infoordershopinfo否否否门店信息。详情可查看下文 门店信息。item_order_listitemorderinfo是否否商品信息列表。详情可查看下文 商品信息列表。ext_infoorderextinfo是是否订单扩展字段。详情可查看 订单扩展字段。订单扩展字段开发者需通过订单扩展字段（ext_info）更新订单状态，订单业务信息，订单类型等数据，入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_statusl ext_valuestring是是否订单状态, 例: to_choose_rooml ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: hotel_bookingl ext_keystring是否是订单详情地址 key。固定为merchant_order_link_page，一笔订单同步过程中需要保持一致。l ext_valuestring是否是商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同，且需是小程序内部页面路径，例如：/pages/index/index?orderid=10190608609185。l ext_keystring是否否商家小程序 appid key。固定为 tiny_app_id。l ext_valuestring是否否商家小程序 appid value。传入订单归属的小程序 appid。l ext_keystring是否否订单业务场景相关的信息 key。固定为 business_info。l ext_valuejsonstring是是否订单业务信息详情 value。入参详情可查看下文 业务信息参数。业务信息参数业务信息参数（business_info） 的各项入参详情如下：参数参数类型是否必填能否更新是否消息使用字段参数说明check_out_datestring否否否离店日期。check_in_timestring否否否字段名称：check in 时间。 字段说明：check in时间，时间格式为 yyyy-mm-dd hh:mm:ss。cancel_rule_descriptionstring否否否取消规则描述。cancel_rule_namestring否否否取消规则名称。contactstring是否是联系人姓名。hotel_numberstring否否否字段名称：酒店电话。 字段说明：酒店联系电话。deadlinestring否否否字段名称：到店最晚时间。 字段说明：酒店规定的最晚到店时间，时间格式为 yyyy-mm-dd hh:mm:ss。requirementsstring是否否字段名称：选房要求。 字段说明：选择房间的要求。tel_numberstring否否否联系人电话。check_out_timestring否否否字段名称：check out 时间。 字段说明：check out 时间，时间格式为 yyyy-mm-dd hh:mm:ss。booking_timestring是否是字段名称：预约入住时间。 字段说明：预约入住时间，时间格式为 yyyy-mm-dd hh:mm:ss。member_levelstring否否否会员等级。payment_typestring否否否字段名称：付款类型。 字段说明：“在线付款”、“到店付款”。check_in_datestring否否否入住日期。商品信息列表开发者需通过商品信息列表字段（item_order_list）传入商品图片、商品详情页等信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为：{商家名称} {商品名称}。 ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id。门店信息若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明merchant_shop_idstring否否否商家侧门店idaddressstring否否否门店地址alipay_shop_idstring否否否蚂蚁侧门店idnamestring否否是门店名称选房成功 (choose_room_s)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-选房成功 (choose_room_s)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否否外部订单号。由商家自定义。 注意：同一笔订单更新状态时，需与首次同步入参一致。buyer_id（buyer_open_id）string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认 应用-开发配置-openid配置管理 已启用。无该配置项，可查看 openid配置申请。order_typestring是否否订单类型。固定为service_order（服务订单）。order_create_timestring是否否订单创建时间，即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。order_modified_timestring是是否订单修改时间，时间格式为 yyyy-mm-dd hh:mm:ss.sss，订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制，防止乱序。order_modified_time较晚的同步会被最终存储，order_modified_time相同的两次同步会被幂等处理。service_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)是否订单总金额。精确到小数点后两位，单位为元。pay_amountprice选填，建议传入该参数否否实际支付金额。精确到小数点后两位。单位为元。discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为元。shop_infoordershopinfo否否否门店信息。详情可查看下文 门店信息。item_order_listitemorderinfo是否否商品信息列表。详情可查看下文 商品信息列表。ext_infoorderextinfo是是否订单扩展字段。详情可查看 订单扩展字段。订单扩展字段开发者需通过订单扩展字段（ext_info）更新订单状态，订单业务信息，订单类型等数据，入参为 ext_key（对应参数的key）、ext_value（对应参数的value）配合使用。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_status。l ext_valuestring是是否订单状态, 例: choose_room_s。l ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: hotel_bookingl ext_keystring是否是订单详情地址 key。固定为merchant_order_link_page，一笔订单同步过程中需要保持一致。l ext_valuestring是否是商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同，且需是小程序内部页面路径，例如：/pages/index/index?orderid=10190608609185。l ext_keystring是否否商家小程序 appid key。固定为 tiny_app_id。l ext_valuestring是否否商家小程序 appid value。传入订单归属的小程序 appid。l ext_keystring是否否订单业务场景相关的信息 key。固定为 business_info。l ext_valuejsonstring是是否订单业务信息详情 value。入参详情可查看下文 业务信息参数。业务信息参数业务信息参数（business_info） 的各项入参详情如下：参数参数类型是否必填能否更新是否消息使用字段参数说明check_out_datestring否否否离店日期。check_in_timestring否否否字段名称：check in 时间。 字段说明：check in时间，时间格式为 yyyy-mm-dd hh:mm:ss。cancel_rule_descriptionstring否否否取消规则描述。cancel_rule_namestring否否否取消规则名称。contactstring是否是联系人姓名。hotel_numberstring否否否字段名称：酒店电话。 字段说明：酒店联系电话。deadlinestring否否否字段名称：到店最晚时间。 字段说明：酒店规定的最晚到店时间，时间格式为 yyyy-mm-dd hh:mm:ss。requirementsstring是否是字段名称：选房要求。 字段说明：选择房间的要求。tel_numberstring否否否联系人电话。check_out_timestring否否否字段名称：check out 时间。 字段说明：check out 时间，时间格式为 yyyy-mm-dd hh:mm:ss。booking_timestring是否是字段名称：预约入住时间。 字段说明：预约入住时间，时间格式为 yyyy-mm-dd hh:mm:ss。room_numberstring是否是字段名称：选房成功房间号。 字段说明：选房成功的房间号。member_levelstring否否否会员等级。payment_typestring否否否字段名称：付款类型。 字段说明：“在线付款”、“到店付款”。check_in_datestring否否否入住日期。商品信息列表开发者需通过商品信息列表字段（item_order_list）传入商品图片、商品详情页等信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为：{商家名称} {商品名称}。 ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id。门店信息若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明merchant_shop_idstring否否否商家侧门店 id。addressstring否否否门店地址。alipay_shop_idstring否否否蚂蚁侧门店 id。namestring否否是门店名称。选房失败 (choose_room_f)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-选房失败（choose_room_f）时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否否外部订单号。由商家自定义。 注意：同一笔订单更新状态时，需与首次同步入参一致。buyer_id（buyer_open_id）string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认 应用-开发配置-openid配置管理 已启用。无该配置项，可查看 openid配置申请。order_typestring是否否订单类型。固定为service_order（服务订单）。order_create_timestring是否否订单创建时间，即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。order_modified_timestring是是否订单修改时间，时间格式为 yyyy-mm-dd hh:mm:ss.sss，订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制，防止乱序。order_modified_time较晚的同步会被最终存储，order_modified_time相同的两次同步会被幂等处理。service_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)是否订单总金额。精确到小数点后两位，单位为元。pay_amountprice选填，建议传入该参数否否实际支付金额。精确到小数点后两位。单位为元。discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为元。shop_infoordershopinfo是否否门店信息。详情可查看下文 门店信息。item_order_listitemorderinfo是否否商品信息列表。详情可查看下文 商品信息列表。ext_infoorderextinfo是是否订单扩展字段。详情可查看 订单扩展字段。订单扩展字段开发者需通过订单扩展字段（ext_info）更新订单状态，订单业务信息，订单类型等数据，入参为 ext_key（对应参数的key）、ext_value（对应参数的value）配合使用。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_status。l ext_valuestring是是否订单状态, 例: choose_room_f。l ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: hotel_booking。l ext_keystring是否是订单详情地址 key。固定为merchant_order_link_page，一笔订单同步过程中需要保持一致。l ext_valuestring是否是商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同，且需是小程序内部页面路径，例如：/pages/index/index?orderid=10190608609185。l ext_keystring是否否商家小程序 appid key。固定为 tiny_app_id。l ext_valuestring是否否商家小程序 appid value。传入订单归属的小程序 appid。l ext_keystring是否否订单业务场景相关的信息 key。固定为 business_info。l ext_valuejsonstring是是否订单业务信息详情 value。入参详情可查看下文 业务信息参数。业务信息参数业务信息参数（business_info） 的各项入参详情如下：参数参数类型是否必填能否更新是否消息使用字段参数说明check_out_datestring否否否离店日期。check_in_timestring否否否字段名称：check in 时间。 字段说明：check in时间，时间格式为 yyyy-mm-dd hh:mm:ss。cancel_rule_descriptionstring否否否取消规则描述。cancel_rule_namestring否否否取消规则名称。f_reasonstring是否是字段名称：选房失败原因。 字段说明：选房失败的原因。contactstring是否是联系人姓名。hotel_numberstring否否否字段名称：酒店电话。 字段说明：酒店联系电话。deadlinestring否否否字段名称：到店最晚时间。 字段说明：酒店规定的最晚到店时间，时间格式为 yyyy-mm-dd hh:mm:ss。requirementsstring否否否字段名称。选房要求。 字段说明：选择房间的要求。tel_numberstring否否否联系人电话。check_out_timestring否否否字段名称：check out 时间。 字段说明：check out 时间，时间格式为 yyyy-mm-dd hh:mm:ss。booking_timestring是否是字段名称：预约入住时间。 字段说明：预约入住时间，时间格式为 yyyy-mm-dd hh:mm:ss。member_levelstring否否否会员等级。payment_typestring否否否字段名称：付款类型。 字段说明：“在线付款”、“到店付款”。check_in_datestring否否否入住日期。商品信息列表开发者需通过商品信息列表字段（item_order_list）传入商品图片、商品详情页等信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为：{商家名称} {商品名称}。 ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id。门店信息若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明merchant_shop_idstring否否否商家侧门店 id。addressstring否否否门店地址。alipay_shop_idstring否否否蚂蚁侧门店 id。namestring是否是门店名称。
