更新时间：2024-10-23 18:07:59配置项检测工具收藏订阅更新我的文档设置接入检测（即可查看检测结果）若有未通过的接入检测项，接口将无法调通去登录返回文档商家需通过 alipay.merchant.order.sync(订单数据同步接口) 订单扩展字段 ext_info#merchant_order_status 参数更新订单状态，具体状态说明如下。订单状态流转说明订单状态说明●支持跨状态传递，如：create (订单创建成功) 可直接跳转至 refunded (已退款) 。●不要求首次同步订单状态必须为 create (订单创建成功) 。●订单状态发生变更后，需要及时同步最新状态。●当前场景定义的订单状态(中文和英文名)如下：状态中文名状态英文名是否为有效订单核心状态是否发送服务消息是否发送push订单创建成功create否否否待支付wait_pay否否否出票中in_the_ticket否否否出票成功ticketed是是是出票失败un_ticket否是是待观影await_screening否否否放映中now_showing否否否订单完成finished是否否已取消cancelled是否否申请退票refunding否否否退票中refund_in_progress否否否退票失败un_refunded否是是已退款refunded是否否注意：不同订单状态，仅 是否发送服务消息 为 是 时，用户才能在消息列表（支付宝凯发k8官方网娱乐官方首页服务提醒入口进入或凯发k8官方网娱乐官方首页底部消息tab进入）查看服务订单消息提醒。状态机流转订单状态机流转如下(左侧表示起始状态，右侧表示允许的后置状态)当前状态允许的后置状态create(订单创建成功)create/订单创建成功、 cancelled/已取消、 wait_pay/待支付wait_pay(待支付)in_the_ticket/出票中、 cancelled/已取消、 wait_pay/待支付in_the_ticket(出票中)un_ticket/出票失败、 in_the_ticket/出票中、 ticketed/出票成功ticketed(出票成功)await_screening/待观影、 refunding/申请退票、 ticketed/出票成功un_ticket(出票失败)refund_in_progress/退票中、 un_ticket/出票失败、 cancelled/已取消、 refunded/已退款、 refunding/申请退票await_screening(待观影)now_showing/放映中、 refund_in_progress/退票中、 await_screening/待观影、 refunding/申请退票now_showing(放映中)now_showing/放映中、 finished/订单完成finished(订单完成)finished/订单完成cancelled(已取消)refund_in_progress/退票中、 un_refunded/退票失败、 cancelled/已取消、 refunded/已退款、 refunding/申请退票refunding(申请退票)refund_in_progress/退票中、 un_refunded/退票失败、 refunded/已退款、 refunding/申请退票refund_in_progress(退票中)refund_in_progress/退票中、 un_refunded/退票失败、 refunded/已退款un_refunded(退票失败)refund_in_progress/退票中、 un_refunded/退票失败、 refunded/已退款refunded(已退款)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:c000003559service_codestring否否否服务code：传入小程序后台提报的服务id，将订单与服务关联。service_code 通过 alipay.open.app.service.apply(服务提报申请)接口提报服务后获取。source_appstring否否否订单来源，默认alipay(支付宝小程序)，钉钉来源dingtalk，其他来源枚举值定义联系支付宝订单中心添加。trade_nostring否否否支付宝交易号。注意：若该状态传递了trade_no，则同步该订单的后续状态时都需要传递trade_no。此字段关联支付宝账单详情卡片，建议回传真实有效交易号。amountprice是是否订单总金额：某笔交易订单优惠前的总金额，单位为【元】注意事项service_order且不涉及金额可不传入该字段，其他场景必传pay_amountprice是否否用户应付金额 ：用户最终结算时需要支付金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】注意事项service_order且不涉及金额可不传入该字段，其他场景必传discount_amountprice是否否商户总计优惠金额：代表商户侧给予用户的总计优惠金额 （不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】。item_order_listitemorderinfo是否否商品信息列表。详见下文: 商品信息列表ext_infoorderextinfo是是否订单扩展字段。详见下文 订单扩展字段。订单扩展字段开发者需通过订单扩展字段（ext_info）更新订单状态，订单业务信息，订单类型等数据，入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_statusl ext_valuestring是是否订单状态, 例: createl ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: movie_ticketl 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。商品信息列表开发者需通过商品信息列表字段（item_order_list）传入商品图片、商品详情页等信息。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为：{商家名称} {商品名称}quantitynumber是否否商品数量。支持两位小数点。 注意：与unit_price成对出现，若传了quantity，则需要将unit_price传入unit_priceprice是否否商品单价。精确到小数点后两位。单位为元注意：与quantity成对出现，若传了unit_price，则需要将quantity传入 ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否start_time key,固定为 start_timel ext_valuestring是否否start_time value 字段说明:商品扩展-开始时间l ext_keystring否否否ticket_type key,固定为 ticket_typel ext_valuestring否否否ticket_type value 字段说明:商品扩展-票类型l ext_keystring否否否商品图片 key。固定为 image_material_id。l ext_valuestring否否否商品图片 value。需传入 上传商品文件 获取的 material_idl ext_keystring是否否end_time key,固定为 end_timel ext_valuestring是否否end_time value 字段说明:商品扩展-结束时间l ext_keystring是否否location_name key,固定为 location_namel ext_valuestring是否否location_name value 字段说明:地点名称l ext_keystring是否否performance_hall key,固定为 performance_halll ext_valuestring是否否performance_hall value 字段说明:地演出厅l ext_keystring是否否performance_seats key,固定为 performance_seatsl ext_valuestring是否否performance_seats value 字段说明:演出座位待支付 (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:c000003559service_codestring否否否服务code：传入小程序后台提报的服务id，将订单与服务关联。service_code 通过 alipay.open.app.service.apply(服务提报申请)接口提报服务后获取。source_appstring否否否订单来源，默认alipay(支付宝小程序)，钉钉来源dingtalk，其他来源枚举值定义联系支付宝订单中心添加。trade_nostring否否否支付宝交易号。注意：若该状态传递了trade_no，则同步该订单的后续状态时都需要传递trade_no。此字段关联支付宝账单详情卡片，建议回传真实有效交易号。amountprice是是否订单总金额：某笔交易订单优惠前的总金额，单位为【元】注意事项service_order且不涉及金额可不传入该字段，其他场景必传pay_amountprice是否否用户应付金额 ：用户最终结算时需要支付金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】注意事项service_order且不涉及金额可不传入该字段，其他场景必传discount_amountprice是否否商户总计优惠金额：代表商户侧给予用户的总计优惠金额 （不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】。item_order_listitemorderinfo是否否商品信息列表。详见下文: 商品信息列表ext_infoorderextinfo是是否订单扩展字段。详见下文 订单扩展字段。订单扩展字段开发者需通过订单扩展字段（ext_info）更新订单状态，订单业务信息，订单类型等数据，入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下：参数参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_statusl ext_valuestring是是否订单状态, 例: wait_payl ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: movie_ticketl ext_keystring是否否订单详情地址 key。固定为merchant_order_link_page，一笔订单同步过程中需要保持一致。l ext_valuestring是否否商户小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。l ext_keystring是否
