景区门票（scenic-凯发app官方网站

支付产品

私域产品

小程序产品

小程序产品介绍

集成说明

权限集列表

搜索关键词

搜索直达

消息

小程序码

小程序服务

订单中心

接入指南

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

餐饮

零售批发

商业生活

交通出行

车主生活

教育培训

医疗卫生

酒旅景区

生活缴费

公共管理和社会组织

休闲娱乐

物流运输

网络通讯

沙箱调试

api 列表

相关资料

常见问题

更新日志

小程序开发管理

生物核身

交易组件

小程序商品

更新日志

支付有礼

商家粉丝群

营销产品

资金产品

会员产品

信用产品

广告产品

更新时间：2024-10-23 18:07:58

订阅更新

我的文档

设置

接入检测（

即可查看检测结果）

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

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

订单状态流转说明

订单状态流转图

订单状态说明

●

支持跨状态传递，如：check_waiting (待检票) 可直接跳转至 ticketed (出票成功) 。

●

不要求首次同步订单状态必须为 check_waiting (待检票) 。

●

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

●

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

状态中文名	状态英文名	是否发送服务消息
待检票	check_waiting	是
已检票	checked	是
已完结	finished	否
出票中	ticket_running	否
待付款	pay_waiting	是
已退单	refund_success	是
已关闭	closed	是
退单中	refund_running	否
退单审核中	refund_auditing	否
出票成功	ticketed	是

注意

：不同订单状态，仅

是否发送服务消息

为

是

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

状态机流转

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

当前状态	允许的后置状态
check_waiting(待检票)	closed/已关闭、 finished/已完结、 refund_success/已退单、 checked/已检票、 check_waiting/待检票、 ticket_running/出票中、 pay_waiting/待付款、 refund_running/退单中、 refund_auditing/退单审核中
checked(已检票)	closed/已关闭、 finished/已完结、 refund_success/已退单、 checked/已检票、 check_waiting/待检票、 refund_running/退单中、 refund_auditing/退单审核中
finished(已完结)	closed/已关闭、 finished/已完结、 refund_success/已退单、 check_waiting/待检票、 refund_running/退单中、 refund_auditing/退单审核中
ticket_running(出票中)	closed/已关闭、 finished/已完结、 refund_success/已退单、 checked/已检票、 check_waiting/待检票、 ticket_running/出票中、 pay_waiting/待付款、 refund_running/退单中、 refund_auditing/退单审核中
pay_waiting(待付款)	closed/已关闭、 finished/已完结、 refund_success/已退单、 checked/已检票、 check_waiting/待检票、 ticket_running/出票中、 pay_waiting/待付款、 refund_running/退单中、 refund_auditing/退单审核中
refund_success(已退单)	closed/已关闭、 finished/已完结、 refund_success/已退单
closed(已关闭)	closed/已关闭、 finished/已完结、 checked/已检票
refund_running(退单中)	closed/已关闭、 finished/已完结、 refund_success/已退单、 refund_running/退单中
refund_auditing(退单审核中)	closed/已关闭、 finished/已完结、 refund_success/已退单、 checked/已检票、 check_waiting/待检票、 refund_running/退单中、 refund_auditing/退单审核中
ticketed(出票成功)	closed/已关闭、 finished/已完结、 refund_success/已退单、 checked/已检票、 check_waiting/待检票、 refund_running/退单中、 ticketed/出票成功、 refund_auditing/退单审核中

不同状态参数使用说明

待检票 (check_waiting)

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

接口参数 bizcontent 示例

参数说明

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
out_biz_no	string	是	否	是	外部订单号。由商家自定义。注意：同一笔订单更新状态时，需与首次同步入参一致。
buyer_id（buyer_open_id）	string	是	否	否	支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认应用-开发配置-openid配置管理已启用。无该配置项，可查看 openid配置申请。
order_type	string	是	否	否	订单类型。固定为service_order（服务订单）。
order_create_time	string	是	否	否	订单创建时间，即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time	string	是	是	否	订单修改时间，时间格式为 yyyy-mm-dd hh:mm:ss.sss，订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制，防止乱序。order_modified_time较晚的同步会被最终存储，order_modified_time相同的两次同步会被幂等处理。
service_code	string	否	否	否	服务code：传入小程序后台提报的服务id，将订单与服务关联。service_code 通过 alipay.open.app.service.apply(服务提报申请)接口提报服务后获取。
source_app	string	否	否	否	订单来源，默认alipay(支付宝小程序)，钉钉来源dingtalk，其他来源枚举值定义联系支付宝订单中心添加。
trade_no	string	否	否	否	支付宝交易号。注意：若该状态传递了trade_no，则同步该订单的后续状态时都需要传递trade_no。此字段关联支付宝账单详情卡片，建议回传真实有效交易号。
amount	price	选填，建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)	是	否	订单总金额。精确到小数点后两位，单位为元
pay_amount	price	选填，建议传入该参数	否	否	实际支付金额。精确到小数点后两位。单位为元
discount_amount	price	否	否	否	优惠金额。传入 discount_info_list 时必填。单位为元
item_order_list	itemorderinfo	是	否	否	商品信息列表。详见下文: 商品信息列表
ext_info	orderextinfo	是	是	否	订单扩展字段。详见下文订单扩展字段。

订单扩展字段

开发者需通过订单扩展字段（ext_info）更新订单状态，订单业务信息，订单类型等数据，入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
l ext_key	string	是	否	否	订单状态 key。固定为 merchant_order_status
l ext_value	string	是	是	否	订单状态, 例: check_waiting
l ext_key	string	是	否	否	订单类型 key。固定为 merchant_biz_type。
l ext_value	string	是	否	否	订单类型 value。本业务场景为: scenic_ticket
l ext_key	string	是	否	是	订单详情地址 key。固定为merchant_order_link_page，一笔订单同步过程中需要保持一致。
l ext_value	string	是	否	是	商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同，且需是小程序内部页面路径，例如：/pages/index/index?orderid=10190608609185。
l ext_key	string	是	否	否	商家小程序 appid key。固定为 tiny_app_id。
l ext_value	string	是	否	否	商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key	string	是	否	否	订单业务场景相关的信息 key。固定为 business_info。
l ext_value	jsonstring	是	是	否	订单业务信息详情 value。入参详情见下文业务信息参数。

业务信息参数

业务信息参数（business_info）的各项入参详情如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
ticket_num	string	是	否	是	字段名称:门票数量字段说明:门票的数量
passagers_info	string	否	否	否	字段名称:游客信息字段说明:[{"name":"填入游客姓名","mobile":"填入游客手机号","certtype":"填入游客证件类型","certno":"填入游客证件号"}]
contact_user_info	string	否	否	否	字段名称:联系人信息字段说明:[{"name":"填入游客姓名","mobile":"填入游客手机号","certtype":"填入游客证件类型","certno":"填入游客证件号"}]
drawer_way	string	否	否	否	字段名称:订票方式字段说明:通过什么方式预订的门票

商品信息列表

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

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
sku_id	string	是	否	否	商家侧商品 sku id
status	string	是	否	否	字段名称:商品状态字段说明:门票状态
item_name	string	是	否	是	商品名称。建议商品名称格式为：{商家名称} {商品名称}
quantity	number	是	否	否	商品数量。支持两位小数点。注意：与unit_price成对出现，若传了quantity，则需要将unit_price传入
unit_price	price	是	否	否	商品单价。精确到小数点后两位。单位为元注意：与quantity成对出现，若传了unit_price，则需要将quantity传入
unit	string	否	否	否	字段名称:商品规格字段说明:份、件、斤、kg，默认为份
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	否	否	否	entry_start_time key,固定为 entry_start_time
l ext_value	string	否	否	否	entry_start_time value 字段说明:入园开始时间
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	商品图片 value。需传入上传商品文件获取的 material_id。
l ext_key	string	是	否	否	end_time key,固定为 end_time
l ext_value	string	是	否	否	end_time value 字段说明:订单中游玩结束时间点
l ext_key	string	否	否	否	location_type key,固定为 location_type
l ext_value	string	否	否	否	location_type value 字段说明:商品扩展-商品关联地点类型，如museum
l ext_key	string	否	否	否	entry_end_time key,固定为 entry_end_time
l ext_value	string	否	否	否	entry_end_time value 字段说明:入园结束时间
l ext_key	string	否	否	否	location_merchant_id key,固定为 location_merchant_id
l ext_value	string	否	否	否	location_merchant_id value 字段说明:景区id
l ext_key	string	是	否	否	start_time key,固定为 start_time
l ext_value	string	是	否	否	start_time value 字段说明:订单中游玩开始时间点
l ext_key	string	否	否	否	ticket_type key,固定为 ticket_type
l ext_value	string	否	否	否	ticket_type value 字段说明:景区类型：山水，人文，乐园，寺庙，博物馆，其他
l ext_key	string	否	否	否	location_name key,固定为 location_name
l ext_value	string	否	否	否	location_name value 字段说明:景区名称
l ext_key	string	否	否	否	商品描述 key。固定为 goodsdesc。
l ext_value	string	否	否	否	商品描述 value。
l ext_key	string	否	否	否	invalid_day_in_week key,固定为 invalid_day_in_week
l ext_value	string	否	否	否	invalid_day_in_week value 字段说明:商品扩展-每周不可用日期，数字1~7用逗号分隔，1则表示星期一
l ext_key	string	否	否	否	location_type_desc key,固定为 location_type_desc
l ext_value	string	否	否	否	location_type_desc value 字段说明:商品扩展-商品关联地点类型，如博物馆
l ext_key	string	否	否	否	invalid_dates key,固定为 invalid_dates
l ext_value	string	否	否	否	invalid_dates value 字段说明:商品扩展-不可用日期

已检票 (checked)

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

接口参数 bizcontent 示例

参数说明

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
out_biz_no	string	是	否	是	外部订单号。由商家自定义。注意：同一笔订单更新状态时，需与首次同步入参一致。
buyer_id（buyer_open_id）	string	是	否	否	支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认应用-开发配置-openid配置管理已启用。无该配置项，可查看 openid配置申请。
order_type	string	是	否	否	订单类型。固定为service_order（服务订单）。
order_create_time	string	是	否	否	订单创建时间，即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time	string	是	是	否	订单修改时间，时间格式为 yyyy-mm-dd hh:mm:ss.sss，订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制，防止乱序。order_modified_time较晚的同步会被最终存储，order_modified_time相同的两次同步会被幂等处理。
service_code	string	否	否	否	服务code：传入小程序后台提报的服务id，将订单与服务关联。service_code 通过 alipay.open.app.service.apply(服务提报申请)接口提报服务后获取。
source_app	string	否	否	否	订单来源，默认alipay(支付宝小程序)，钉钉来源dingtalk，其他来源枚举值定义联系支付宝订单中心添加。
trade_no	string	否	否	否	支付宝交易号。注意：若该状态传递了trade_no，则同步该订单的后续状态时都需要传递trade_no。此字段关联支付宝账单详情卡片，建议回传真实有效交易号。
amount	price	选填，建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)	是	否	订单总金额。精确到小数点后两位，单位为元
pay_amount	price	选填，建议传入该参数	否	否	实际支付金额。精确到小数点后两位。单位为元
discount_amount	price	否	否	否	优惠金额。传入 discount_info_list 时必填。单位为元
item_order_list	itemorderinfo	是	否	否	商品信息列表。详见下文: 商品信息列表
ext_info	orderextinfo	是	是	否	订单扩展字段。详见下文订单扩展字段。

订单扩展字段

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
l ext_key	string	是	否	否	订单状态 key。固定为 merchant_order_status
l ext_value	string	是	是	否	订单状态, 例: checked
l ext_key	string	是	否	否	订单类型 key。固定为 merchant_biz_type。
l ext_value	string	是	否	否	订单类型 value。本业务场景为: scenic_ticket
l ext_key	string	是	否	是	订单详情地址 key。固定为merchant_order_link_page，一笔订单同步过程中需要保持一致。
l ext_value	string	是	否	是	商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同，且需是小程序内部页面路径，例如：/pages/index/index?orderid=10190608609185。
l ext_key	string	是	否	否	商家小程序 appid key。固定为 tiny_app_id。
l ext_value	string	是	否	否	商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key	string	是	否	否	订单业务场景相关的信息 key。固定为 business_info。
l ext_value	jsonstring	是	是	否	订单业务信息详情 value。入参详情见下文业务信息参数。

业务信息参数

业务信息参数（business_info）的各项入参详情如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
ticket_num	string	是	否	是	字段名称:门票数量字段说明:门票的数量
passagers_info	string	否	否	否	字段名称:游客信息字段说明:[{"name":"填入游客姓名","mobile":"填入游客手机号","certtype":"填入游客证件类型","certno":"填入游客证件号"}]
contact_user_info	string	否	否	否	字段名称:联系人信息字段说明:[{"name":"填入游客姓名","mobile":"填入游客手机号","certtype":"填入游客证件类型","certno":"填入游客证件号"}]
drawer_way	string	否	否	否	字段名称:订票方式字段说明:通过什么方式预订的门票

商品信息列表

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

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
sku_id	string	是	否	否	商家侧商品 sku id
status	string	是	否	否	字段名称:商品状态字段说明:门票状态
item_name	string	是	否	是	商品名称。建议商品名称格式为：{商家名称} {商品名称}
quantity	number	是	否	否	商品数量。支持两位小数点。注意：与unit_price成对出现，若传了quantity，则需要将unit_price传入
sku_id	string	是	否	否	商家侧商品 sku id
unit_price	price	是	否	否	商品单价。精确到小数点后两位。单位为元注意：与quantity成对出现，若传了unit_price，则需要将quantity传入
unit	string	否	否	否	字段名称:商品规格字段说明:份、件、斤、kg，默认为份
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	否	否	否	entry_start_time key,固定为 entry_start_time
l ext_value	string	否	否	否	entry_start_time value 字段说明:入园开始时间
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	商品图片 value。需传入上传商品文件获取的 material_id。
l ext_key	string	是	否	否	end_time key,固定为 end_time
l ext_value	string	是	否	否	end_time value 字段说明:订单中游玩结束时间点
l ext_key	string	否	否	否	location_type key,固定为 location_type
l ext_value	string	否	否	否	location_type value 字段说明:商品扩展-商品关联地点类型，如museum
l ext_key	string	否	否	否	entry_end_time key,固定为 entry_end_time
l ext_value	string	否	否	否	entry_end_time value 字段说明:入园结束时间
l ext_key	string	否	否	否	location_merchant_id key,固定为 location_merchant_id
l ext_value	string	否	否	否	location_merchant_id value 字段说明:景区id
l ext_key	string	是	否	否	start_time key,固定为 start_time
l ext_value	string	是	否	否	start_time value 字段说明:订单中游玩开始时间点
l ext_key	string	否	否	否	ticket_type key,固定为 ticket_type
l ext_value	string	否	否	否	ticket_type value 字段说明:景区类型：山水，人文，乐园，寺庙，博物馆，其他
l ext_key	string	否	否	否	location_name key,固定为 location_name
l ext_value	string	否	否	否	location_name value 字段说明:景区名称
l ext_key	string	否	否	否	商品描述 key。固定为 goodsdesc。
l ext_value	string	否	否	否	商品描述 value。
l ext_key	string	否	否	否	invalid_day_in_week key,固定为 invalid_day_in_week
l ext_value	string	否	否	否	invalid_day_in_week value 字段说明:商品扩展-每周不可用日期，数字1~7用逗号分隔，1则表示星期一
l ext_key	string	否	否	否	location_type_desc key,固定为 location_type_desc
l ext_value	string	否	否	否	location_type_desc value 字段说明:商品扩展-商品关联地点类型，如博物馆
l ext_key	string	否	否	否	invalid_dates key,固定为 invalid_dates
l ext_value	string	否	否	否	invalid_dates value 字段说明:商品扩展-不可用日期

已完结 (finished)

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

接口参数 bizcontent 示例

参数说明

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
out_biz_no	string	是	否	否	外部订单号。由商家自定义。注意：同一笔订单更新状态时，需与首次同步入参一致。
buyer_id（buyer_open_id）	string	是	否	否	支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认应用-开发配置-openid配置管理已启用。无该配置项，可查看 openid配置申请。
order_type	string	是	否	否	订单类型。固定为service_order（服务订单）。
order_create_time	string	是	否	否	订单创建时间，即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time	string	是	是	否	订单修改时间，时间格式为 yyyy-mm-dd hh:mm:ss.sss，订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制，防止乱序。order_modified_time较晚的同步会被最终存储，order_modified_time相同的两次同步会被幂等处理。
service_code	string	否	否	否	服务code：传入小程序后台提报的服务id，将订单与服务关联。service_code 通过 alipay.open.app.service.apply(服务提报申请)接口提报服务后获取。
source_app	string	否	否	否	订单来源，默认alipay(支付宝小程序)，钉钉来源dingtalk，其他来源枚举值定义联系支付宝订单中心添加。
trade_no	string	否	否	否	支付宝交易号。注意：若该状态传递了trade_no，则同步该订单的后续状态时都需要传递trade_no。此字段关联支付宝账单详情卡片，建议回传真实有效交易号。
amount	price	选填，建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)	是	否	订单总金额。精确到小数点后两位，单位为元
pay_amount	price	选填，建议传入该参数	否	否	实际支付金额。精确到小数点后两位。单位为元
discount_amount	price	否	否	否	优惠金额。传入 discount_info_list 时必填。单位为元
item_order_list	itemorderinfo	是	否	否	商品信息列表。详见下文: 商品信息列表
ext_info	orderextinfo	是	是	否	订单扩展字段。详见下文订单扩展字段。

订单扩展字段

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
l ext_key	string	是	否	否	订单状态 key。固定为 merchant_order_status
l ext_value	string	是	是	否	订单状态, 例: finished
l ext_key	string	是	否	否	订单类型 key。固定为 merchant_biz_type。
l ext_value	string	是	否	否	订单类型 value。本业务场景为: scenic_ticket
l ext_key	string	是	否	否	订单详情地址 key。固定为merchant_order_link_page，一笔订单同步过程中需要保持一致。
l ext_value	string	是	否	否	商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同，且需是小程序内部页面路径，例如：/pages/index/index?orderid=10190608609185。
l ext_key	string	是	否	否	商家小程序 appid key。固定为 tiny_app_id。
l ext_value	string	是	否	否	商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key	string	是	否	否	订单业务场景相关的信息 key。固定为 business_info。
l ext_value	jsonstring	是	是	否	订单业务信息详情 value。入参详情见下文业务信息参数。

业务信息参数

业务信息参数（business_info）的各项入参详情如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
ticket_num	string	是	否	否	字段名称:门票数量字段说明:门票的数量
passagers_info	string	否	否	否	字段名称:游客信息字段说明:[{"name":"填入游客姓名","mobile":"填入游客手机号","certtype":"填入游客证件类型","certno":"填入游客证件号"}]
contact_user_info	string	否	否	否	字段名称:联系人信息字段说明:[{"name":"填入游客姓名","mobile":"填入游客手机号","certtype":"填入游客证件类型","certno":"填入游客证件号"}]
drawer_way	string	否	否	否	字段名称:订票方式字段说明:通过什么方式预订的门票

商品信息列表

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

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
sku_id	string	是	否	否	商家侧商品 sku id
status	string	是	否	否	字段名称:商品状态字段说明:门票状态
item_name	string	是	否	否	商品名称。建议商品名称格式为：{商家名称} {商品名称}
quantity	number	是	否	否	商品数量。支持两位小数点。注意：与unit_price成对出现，若传了quantity，则需要将unit_price传入
sku_id	string	是	否	否	商家侧商品 sku id
unit_price	price	是	否	否	商品单价。精确到小数点后两位。单位为元注意：与quantity成对出现，若传了unit_price，则需要将quantity传入
unit	string	否	否	否	字段名称:商品规格字段说明:份、件、斤、kg，默认为份
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	否	否	否	entry_start_time key,固定为 entry_start_time
l ext_value	string	否	否	否	entry_start_time value 字段说明:入园开始时间
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	商品图片 value。需传入上传商品文件获取的 material_id。
l ext_key	string	是	否	否	end_time key,固定为 end_time
l ext_value	string	是	否	否	end_time value 字段说明:订单中游玩结束时间点
l ext_key	string	否	否	否	location_type key,固定为 location_type
l ext_value	string	否	否	否	location_type value 字段说明:商品扩展-商品关联地点类型，如museum
l ext_key	string	否	否	否	entry_end_time key,固定为 entry_end_time
l ext_value	string	否	否	否	entry_end_time value 字段说明:入园结束时间
l ext_key	string	否	否	否	location_merchant_id key,固定为 location_merchant_id
l ext_value	string	否	否	否	location_merchant_id value 字段说明:景区id
l ext_key	string	是	否	否	start_time key,固定为 start_time
l ext_value	string	是	否	否	start_time value 字段说明:订单中游玩开始时间点
l ext_key	string	否	否	否	ticket_type key,固定为 ticket_type
l ext_value	string	否	否	否	ticket_type value 字段说明:景区类型：山水，人文，乐园，寺庙，博物馆，其他
l ext_key	string	否	否	否	location_name key,固定为 location_name
l ext_value	string	否	否	否	location_name value 字段说明:景区名称
l ext_key	string	否	否	否	商品描述 key。固定为 goodsdesc。
l ext_value	string	否	否	否	商品描述 value。
l ext_key	string	否	否	否	invalid_day_in_week key,固定为 invalid_day_in_week
l ext_value	string	否	否	否	invalid_day_in_week value 字段说明:商品扩展-每周不可用日期，数字1~7用逗号分隔，1则表示星期一
l ext_key	string	否	否	否	location_type_desc key,固定为 location_type_desc
l ext_value	string	否	否	否	location_type_desc value 字段说明:商品扩展-商品关联地点类型，如博物馆
l ext_key	string	否	否	否	invalid_dates key,固定为 invalid_dates
l ext_value	string	否	否	否	invalid_dates value 字段说明:商品扩展-不可用日期

出票中 (ticket_running)

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

接口参数 bizcontent 示例

参数说明

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
out_biz_no	string	是	否	否	外部订单号。由商家自定义。注意：同一笔订单更新状态时，需与首次同步入参一致。
buyer_id（buyer_open_id）	string	是	否	否	支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认应用-开发配置-openid配置管理已启用。无该配置项，可查看 openid配置申请。
order_type	string	是	否	否	订单类型。固定为service_order（服务订单）。
order_create_time	string	是	否	否	订单创建时间，即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time	string	是	是	否	订单修改时间，时间格式为 yyyy-mm-dd hh:mm:ss.sss，订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制，防止乱序。order_modified_time较晚的同步会被最终存储，order_modified_time相同的两次同步会被幂等处理。
service_code	string	否	否	否	服务code：传入小程序后台提报的服务id，将订单与服务关联。service_code 通过 alipay.open.app.service.apply(服务提报申请)接口提报服务后获取。
source_app	string	否	否	否	订单来源，默认alipay(支付宝小程序)，钉钉来源dingtalk，其他来源枚举值定义联系支付宝订单中心添加。
trade_no	string	否	否	否	支付宝交易号。注意：若该状态传递了trade_no，则同步该订单的后续状态时都需要传递trade_no。此字段关联支付宝账单详情卡片，建议回传真实有效交易号。
amount	price	选填，建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)	是	否	订单总金额。精确到小数点后两位，单位为元
pay_amount	price	选填，建议传入该参数	否	否	实际支付金额。精确到小数点后两位。单位为元
discount_amount	price	否	否	否	优惠金额。传入 discount_info_list 时必填。单位为元
item_order_list	itemorderinfo	是	否	否	商品信息列表。详见下文: 商品信息列表
ext_info	orderextinfo	是	是	否	订单扩展字段。详见下文订单扩展字段。

订单扩展字段

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
l ext_key	string	是	否	否	订单状态 key。固定为 merchant_order_status
l ext_value	string	是	是	否	订单状态, 例: ticket_running
l ext_key	string	是	否	否	订单类型 key。固定为 merchant_biz_type。
l ext_value	string	是	否	否	订单类型 value。本业务场景为: scenic_ticket
l ext_key	string	是	否	否	订单详情地址 key。固定为merchant_order_link_page，一笔订单同步过程中需要保持一致。
l ext_value	string	是	否	否	商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同，且需是小程序内部页面路径，例如：/pages/index/index?orderid=10190608609185。
l ext_key	string	是	否	否	商家小程序 appid key。固定为 tiny_app_id。
l ext_value	string	是	否	否	商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key	string	是	否	否	订单业务场景相关的信息 key。固定为 business_info。
l ext_value	jsonstring	是	是	否	订单业务信息详情 value。入参详情见下文业务信息参数。

业务信息参数

业务信息参数（business_info）的各项入参详情如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
ticket_num	string	是	否	否	字段名称:门票数量字段说明:门票的数量
passagers_info	string	否	否	否	字段名称:游客信息字段说明:[{"name":"填入游客姓名","mobile":"填入游客手机号","certtype":"填入游客证件类型","certno":"填入游客证件号"}]
contact_user_info	string	否	否	否	字段名称:联系人信息字段说明:[{"name":"填入游客姓名","mobile":"填入游客手机号","certtype":"填入游客证件类型","certno":"填入游客证件号"}]

商品信息列表

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

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
sku_id	string	是	否	否	商家侧商品 sku id
status	string	是	否	否	字段名称:商品状态字段说明:门票状态
item_name	string	是	否	否	商品名称。建议商品名称格式为：{商家名称} {商品名称}
quantity	number	是	否	否	商品数量。支持两位小数点。注意：与unit_price成对出现，若传了quantity，则需要将unit_price传入
sku_id	string	是	否	否	商家侧商品 sku id
unit_price	price	是	否	否	商品单价。精确到小数点后两位。单位为元注意：与quantity成对出现，若传了unit_price，则需要将quantity传入
unit	string	否	否	否	字段名称:商品规格字段说明:份、件、斤、kg，默认为份
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	否	否	否	entry_start_time key,固定为 entry_start_time
l ext_value	string	否	否	否	entry_start_time value 字段说明:入园开始时间
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	商品图片 value。需传入上传商品文件获取的 material_id。
l ext_key	string	是	否	否	end_time key,固定为 end_time
l ext_value	string	是	否	否	end_time value 字段说明:订单中游玩结束时间点
l ext_key	string	否	否	否	location_type key,固定为 location_type
l ext_value	string	否	否	否	location_type value 字段说明:商品扩展-商品关联地点类型，如museum
l ext_key	string	否	否	否	entry_end_time key,固定为 entry_end_time
l ext_value	string	否	否	否	entry_end_time value 字段说明:入园结束时间
l ext_key	string	否	否	否	location_merchant_id key,固定为 location_merchant_id
l ext_value	string	否	否	否	location_merchant_id value 字段说明:景区id
l ext_key	string	是	否	否	start_time key,固定为 start_time
l ext_value	string	是	否	否	start_time value 字段说明:订单中游玩开始时间点
l ext_key	string	否	否	否	ticket_type key,固定为 ticket_type
l ext_value	string	否	否	否	ticket_type value 字段说明:景区类型：山水，人文，乐园，寺庙，博物馆，其他
l ext_key	string	否	否	否	location_name key,固定为 location_name
l ext_value	string	否	否	否	location_name value 字段说明:景区名称
l ext_key	string	否	否	否	商品描述 key。固定为 goodsdesc。
l ext_value	string	否	否	否	商品描述 value。
l ext_key	string	否	否	否	invalid_day_in_week key,固定为 invalid_day_in_week
l ext_value	string	否	否	否	invalid_day_in_week value 字段说明:商品扩展-每周不可用日期，数字1~7用逗号分隔，1则表示星期一
l ext_key	string	否	否	否	location_type_desc key,固定为 location_type_desc
l ext_value	string	否	否	否	location_type_desc value 字段说明:商品扩展-商品关联地点类型，如博物馆
l ext_key	string	否	否	否	invalid_dates key,固定为 invalid_dates
l ext_value	string	否	否	否	invalid_dates value 字段说明:商品扩展-不可用日期

待付款 (pay_waiting)

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

接口参数 bizcontent 示例

参数说明

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
out_biz_no	string	是	否	是	外部订单号。由商家自定义。注意：同一笔订单更新状态时，需与首次同步入参一致。
buyer_id（buyer_open_id）	string	是	否	否	支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认应用-开发配置-openid配置管理已启用。无该配置项，可查看 openid配置申请。
order_type	string	是	否	否	订单类型。固定为service_order（服务订单）。
order_create_time	string	是	否	否	订单创建时间，即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time	string	是	是	否	订单修改时间，时间格式为 yyyy-mm-dd hh:mm:ss.sss，订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制，防止乱序。order_modified_time较晚的同步会被最终存储，order_modified_time相同的两次同步会被幂等处理。
service_code	string	否	否	否	服务code：传入小程序后台提报的服务id，将订单与服务关联。service_code 通过 alipay.open.app.service.apply(服务提报申请)接口提报服务后获取。
source_app	string	否	否	否	订单来源，默认alipay(支付宝小程序)，钉钉来源dingtalk，其他来源枚举值定义联系支付宝订单中心添加。
trade_no	string	否	否	否	支付宝交易号。注意：若该状态传递了trade_no，则同步该订单的后续状态时都需要传递trade_no。此字段关联支付宝账单详情卡片，建议回传真实有效交易号。
amount	price	选填，建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)	是	否	订单总金额。精确到小数点后两位，单位为元
pay_amount	price	选填，建议传入该参数	否	否	实际支付金额。精确到小数点后两位。单位为元
discount_amount	price	否	否	否	优惠金额。传入 discount_info_list 时必填。单位为元
item_order_list	itemorderinfo	是	否	否	商品信息列表。详见下文: 商品信息列表
ext_info	orderextinfo	是	是	否	订单扩展字段。详见下文订单扩展字段。

订单扩展字段

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
l ext_key	string	是	否	否	订单状态 key。固定为 merchant_order_status
l ext_value	string	是	是	否	订单状态, 例: pay_waiting
l ext_key	string	是	否	否	订单类型 key。固定为 merchant_biz_type。
l ext_value	string	是	否	否	订单类型 value。本业务场景为: scenic_ticket
l ext_key	string	是	否	是	订单详情地址 key。固定为merchant_order_link_page，一笔订单同步过程中需要保持一致。
l ext_value	string	是	否	是	商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同，且需是小程序内部页面路径，例如：/pages/index/index?orderid=10190608609185。
l ext_key	string	是	否	否	商家小程序 appid key。固定为 tiny_app_id。
l ext_value	string	是	否	否	商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key	string	是	否	否	订单业务场景相关的信息 key。固定为 business_info。
l ext_value	jsonstring	是	是	否	订单业务信息详情 value。入参详情见下文业务信息参数。

业务信息参数

业务信息参数（business_info）的各项入参详情如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
ticket_num	string	是	否	是	字段名称:门票数量字段说明:门票的数量
passagers_info	string	否	否	否	字段名称:游客信息字段说明:[{"name":"填入游客姓名","mobile":"填入游客手机号","certtype":"填入游客证件类型","certno":"填入游客证件号"}]
contact_user_info	string	否	否	否	字段名称:联系人信息字段说明:[{"name":"填入游客姓名","mobile":"填入游客手机号","certtype":"填入游客证件类型","certno":"填入游客证件号"}]
drawer_way	string	否	否	否	字段名称:订票方式字段说明:通过什么方式预订的门票

商品信息列表

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

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
sku_id	string	是	否	否	商家侧商品 sku id
status	string	是	否	否	字段名称:商品状态字段说明:门票状态
item_name	string	是	否	是	商品名称。建议商品名称格式为：{商家名称} {商品名称}
quantity	number	是	否	否	商品数量。支持两位小数点。注意：与unit_price成对出现，若传了quantity，则需要将unit_price传入
sku_id	string	是	否	否	商家侧商品 sku id
unit_price	price	是	否	否	商品单价。精确到小数点后两位。单位为元注意：与quantity成对出现，若传了unit_price，则需要将quantity传入
unit	string	否	否	否	字段名称:商品规格字段说明:份、件、斤、kg，默认为份
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	否	否	否	entry_start_time key,固定为 entry_start_time
l ext_value	string	否	否	否	entry_start_time value 字段说明:入园开始时间
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	商品图片 value。需传入上传商品文件获取的 material_id。
l ext_key	string	是	否	否	end_time key,固定为 end_time
l ext_value	string	是	否	否	end_time value 字段说明:订单中游玩结束时间点
l ext_key	string	否	否	否	location_type key,固定为 location_type
l ext_value	string	否	否	否	location_type value 字段说明:商品扩展-商品关联地点类型，如museum
l ext_key	string	否	否	否	entry_end_time key,固定为 entry_end_time
l ext_value	string	否	否	否	entry_end_time value 字段说明:入园结束时间
l ext_key	string	否	否	否	location_merchant_id key,固定为 location_merchant_id
l ext_value	string	否	否	否	location_merchant_id value 字段说明:景区id
l ext_key	string	是	否	否	start_time key,固定为 start_time
l ext_value	string	是	否	否	start_time value 字段说明:订单中游玩开始时间点
l ext_key	string	否	否	否	ticket_type key,固定为 ticket_type
l ext_value	string	否	否	否	ticket_type value 字段说明:景区类型：山水，人文，乐园，寺庙，博物馆，其他
l ext_key	string	否	否	否	location_name key,固定为 location_name
l ext_value	string	否	否	否	location_name value 字段说明:景区名称
l ext_key	string	否	否	否	商品描述 key。固定为 goodsdesc。
l ext_value	string	否	否	否	商品描述 value。
l ext_key	string	否	否	否	invalid_day_in_week key,固定为 invalid_day_in_week
l ext_value	string	否	否	否	invalid_day_in_week value 字段说明:商品扩展-每周不可用日期，数字1~7用逗号分隔，1则表示星期一
l ext_key	string	否	否	否	location_type_desc key,固定为 location_type_desc
l ext_value	string	否	否	否	location_type_desc value 字段说明:商品扩展-商品关联地点类型，如博物馆
l ext_key	string	否	否	否	invalid_dates key,固定为 invalid_dates
l ext_value	string	否	否	否	invalid_dates value 字段说明:商品扩展-不可用日期

已退单 (refund_success)

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

接口参数 bizcontent 示例

参数说明

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
out_biz_no	string	是	否	是	外部订单号。由商家自定义。注意：同一笔订单更新状态时，需与首次同步入参一致。
buyer_id（buyer_open_id）	string	是	否	否	支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认应用-开发配置-openid配置管理已启用。无该配置项，可查看 openid配置申请。
order_type	string	是	否	否	订单类型。固定为service_order（服务订单）。
order_create_time	string	是	否	否	订单创建时间，即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time	string	是	是	否	订单修改时间，时间格式为 yyyy-mm-dd hh:mm:ss.sss，订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制，防止乱序。order_modified_time较晚的同步会被最终存储，order_modified_time相同的两次同步会被幂等处理。
service_code	string	否	否	否	服务code：传入小程序后台提报的服务id，将订单与服务关联。service_code 通过 alipay.open.app.service.apply(服务提报申请)接口提报服务后获取。
source_app	string	否	否	否	订单来源，默认alipay(支付宝小程序)，钉钉来源dingtalk，其他来源枚举值定义联系支付宝订单中心添加。
trade_no	string	否	否	否	支付宝交易号。注意：若该状态传递了trade_no，则同步该订单的后续状态时都需要传递trade_no。此字段关联支付宝账单详情卡片，建议回传真实有效交易号。
amount	price	选填，建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)	是	否	订单总金额。精确到小数点后两位，单位为元
pay_amount	price	选填，建议传入该参数	否	否	实际支付金额。精确到小数点后两位。单位为元
discount_amount	price	否	否	否	优惠金额。传入 discount_info_list 时必填。单位为元
item_order_list	itemorderinfo	是	否	否	商品信息列表。详见下文: 商品信息列表
ext_info	orderextinfo	是	是	否	订单扩展字段。详见下文订单扩展字段。

订单扩展字段

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
l ext_key	string	是	否	否	订单状态 key。固定为 merchant_order_status
l ext_value	string	是	是	否	订单状态, 例: refund_success
l ext_key	string	是	否	否	订单类型 key。固定为 merchant_biz_type。
l ext_value	string	是	否	否	订单类型 value。本业务场景为: scenic_ticket
l ext_key	string	是	否	是	订单详情地址 key。固定为merchant_order_link_page，一笔订单同步过程中需要保持一致。
l ext_value	string	是	否	是	商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同，且需是小程序内部页面路径，例如：/pages/index/index?orderid=10190608609185。
l ext_key	string	是	否	否	商家小程序 appid key。固定为 tiny_app_id。
l ext_value	string	是	否	否	商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key	string	是	否	否	订单业务场景相关的信息 key。固定为 business_info。
l ext_value	jsonstring	是	是	否	订单业务信息详情 value。入参详情见下文业务信息参数。

业务信息参数

业务信息参数（business_info）的各项入参详情如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
ticket_num	string	是	否	是	字段名称:门票数量字段说明:门票的数量
passagers_info	string	否	否	否	字段名称:游客信息字段说明:[{"name":"填入游客姓名","mobile":"填入游客手机号","certtype":"填入游客证件类型","certno":"填入游客证件号"}]
contact_user_info	string	否	否	否	字段名称:联系人信息字段说明:[{"name":"填入游客姓名","mobile":"填入游客手机号","certtype":"填入游客证件类型","certno":"填入游客证件号"}]
drawer_way	string	否	否	否	字段名称:订票方式字段说明:通过什么方式预订的门票

商品信息列表

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

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
sku_id	string	是	否	否	商家侧商品 sku id
status	string	是	否	否	字段名称:商品状态字段说明:门票状态
item_name	string	是	否	是	商品名称。建议商品名称格式为：{商家名称} {商品名称}
quantity	number	是	否	否	商品数量。支持两位小数点。注意：与unit_price成对出现，若传了quantity，则需要将unit_price传入
sku_id	string	是	否	否	商家侧商品 sku id
unit_price	price	是	否	否	商品单价。精确到小数点后两位。单位为元注意：与quantity成对出现，若传了unit_price，则需要将quantity传入
unit	string	否	否	否	字段名称:商品规格字段说明:份、件、斤、kg，默认为份
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	否	否	否	entry_start_time key,固定为 entry_start_time
l ext_value	string	否	否	否	entry_start_time value 字段说明:入园开始时间
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	商品图片 value。需传入上传商品文件获取的 material_id。
l ext_key	string	是	否	否	end_time key,固定为 end_time
l ext_value	string	是	否	否	end_time value 字段说明:订单中游玩结束时间点
l ext_key	string	否	否	否	location_type key,固定为 location_type
l ext_value	string	否	否	否	location_type value 字段说明:商品扩展-商品关联地点类型，如museum
l ext_key	string	否	否	否	entry_end_time key,固定为 entry_end_time
l ext_value	string	否	否	否	entry_end_time value 字段说明:入园结束时间
l ext_key	string	否	否	否	location_merchant_id key,固定为 location_merchant_id
l ext_value	string	否	否	否	location_merchant_id value 字段说明:景区id
l ext_key	string	是	否	否	start_time key,固定为 start_time
l ext_value	string	是	否	否	start_time value 字段说明:订单中游玩开始时间点
l ext_key	string	否	否	否	ticket_type key,固定为 ticket_type
l ext_value	string	否	否	否	ticket_type value 字段说明:景区类型：山水，人文，乐园，寺庙，博物馆，其他
l ext_key	string	否	否	否	location_name key,固定为 location_name
l ext_value	string	否	否	否	location_name value 字段说明:景区名称
l ext_key	string	否	否	否	商品描述 key。固定为 goodsdesc。
l ext_value	string	否	否	否	商品描述 value。
l ext_key	string	否	否	否	invalid_day_in_week key,固定为 invalid_day_in_week
l ext_value	string	否	否	否	invalid_day_in_week value 字段说明:商品扩展-每周不可用日期，数字1~7用逗号分隔，1则表示星期一
l ext_key	string	否	否	否	location_type_desc key,固定为 location_type_desc
l ext_value	string	否	否	否	location_type_desc value 字段说明:商品扩展-商品关联地点类型，如博物馆
l ext_key	string	否	否	否	invalid_dates key,固定为 invalid_dates
l ext_value	string	否	否	否	invalid_dates value 字段说明:商品扩展-不可用日期

已关闭 (closed)

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

接口参数 bizcontent 示例

参数说明

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
out_biz_no	string	是	否	是	外部订单号。由商家自定义。注意：同一笔订单更新状态时，需与首次同步入参一致。
buyer_id（buyer_open_id）	string	是	否	否	支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认应用-开发配置-openid配置管理已启用。无该配置项，可查看 openid配置申请。
order_type	string	是	否	否	订单类型。固定为service_order（服务订单）。
order_create_time	string	是	否	否	订单创建时间，即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time	string	是	是	否	订单修改时间，时间格式为 yyyy-mm-dd hh:mm:ss.sss，订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制，防止乱序。order_modified_time较晚的同步会被最终存储，order_modified_time相同的两次同步会被幂等处理。
service_code	string	否	否	否	服务code：传入小程序后台提报的服务id，将订单与服务关联。service_code 通过 alipay.open.app.service.apply(服务提报申请)接口提报服务后获取。
source_app	string	否	否	否	订单来源，默认alipay(支付宝小程序)，钉钉来源dingtalk，其他来源枚举值定义联系支付宝订单中心添加。
trade_no	string	否	否	否	支付宝交易号。注意：若该状态传递了trade_no，则同步该订单的后续状态时都需要传递trade_no。此字段关联支付宝账单详情卡片，建议回传真实有效交易号。
amount	price	选填，建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)	是	否	订单总金额。精确到小数点后两位，单位为元
pay_amount	price	选填，建议传入该参数	否	否	实际支付金额。精确到小数点后两位。单位为元
discount_amount	price	否	否	否	优惠金额。传入 discount_info_list 时必填。单位为元
item_order_list	itemorderinfo	是	否	否	商品信息列表。详见下文: 商品信息列表
ext_info	orderextinfo	是	是	否	订单扩展字段。详见下文订单扩展字段。

订单扩展字段

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
l ext_key	string	是	否	否	订单状态 key。固定为 merchant_order_status
l ext_value	string	是	是	否	订单状态, 例: closed
l ext_key	string	是	否	否	订单类型 key。固定为 merchant_biz_type。
l ext_value	string	是	否	否	订单类型 value。本业务场景为: scenic_ticket
l ext_key	string	是	否	是	订单详情地址 key。固定为merchant_order_link_page，一笔订单同步过程中需要保持一致。
l ext_value	string	是	否	是	商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同，且需是小程序内部页面路径，例如：/pages/index/index?orderid=10190608609185。
l ext_key	string	是	否	否	商家小程序 appid key。固定为 tiny_app_id。
l ext_value	string	是	否	否	商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key	string	是	否	否	订单业务场景相关的信息 key。固定为 business_info。
l ext_value	jsonstring	是	是	否	订单业务信息详情 value。入参详情见下文业务信息参数。

业务信息参数

业务信息参数（business_info）的各项入参详情如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
ticket_num	string	是	否	是	字段名称:门票数量字段说明:门票的数量
passagers_info	string	否	否	否	字段名称:游客信息字段说明:[{"name":"填入游客姓名","mobile":"填入游客手机号","certtype":"填入游客证件类型","certno":"填入游客证件号"}]
contact_user_info	string	否	否	否	字段名称:联系人信息字段说明:[{"name":"填入游客姓名","mobile":"填入游客手机号","certtype":"填入游客证件类型","certno":"填入游客证件号"}]
drawer_way	string	否	否	否	字段名称:订票方式字段说明:通过什么方式预订的门票

商品信息列表

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

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
sku_id	string	是	否	否	商家侧商品 sku id
status	string	是	否	否	字段名称:商品状态字段说明:门票状态
item_name	string	是	否	是	商品名称。建议商品名称格式为：{商家名称} {商品名称}
quantity	number	是	否	否	商品数量。支持两位小数点。注意：与unit_price成对出现，若传了quantity，则需要将unit_price传入
sku_id	string	是	否	否	商家侧商品 sku id
unit_price	price	是	否	否	商品单价。精确到小数点后两位。单位为元注意：与quantity成对出现，若传了unit_price，则需要将quantity传入
unit	string	否	否	否	字段名称:商品规格字段说明:份、件、斤、kg，默认为份
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	否	否	否	entry_start_time key,固定为 entry_start_time
l ext_value	string	否	否	否	entry_start_time value 字段说明:入园开始时间
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	商品图片 value。需传入上传商品文件获取的 material_id。
l ext_key	string	是	否	否	end_time key,固定为 end_time
l ext_value	string	是	否	否	end_time value 字段说明:订单中游玩结束时间点
l ext_key	string	否	否	否	location_type key,固定为 location_type
l ext_value	string	否	否	否	location_type value 字段说明:商品扩展-商品关联地点类型，如museum
l ext_key	string	否	否	否	entry_end_time key,固定为 entry_end_time
l ext_value	string	否	否	否	entry_end_time value 字段说明:入园结束时间
l ext_key	string	否	否	否	location_merchant_id key,固定为 location_merchant_id
l ext_value	string	否	否	否	location_merchant_id value 字段说明:景区id
l ext_key	string	是	否	否	start_time key,固定为 start_time
l ext_value	string	是	否	否	start_time value 字段说明:订单中游玩开始时间点
l ext_key	string	否	否	否	ticket_type key,固定为 ticket_type
l ext_value	string	否	否	否	ticket_type value 字段说明:景区类型：山水，人文，乐园，寺庙，博物馆，其他
l ext_key	string	否	否	否	location_name key,固定为 location_name
l ext_value	string	否	否	否	location_name value 字段说明:景区名称
l ext_key	string	否	否	否	商品描述 key。固定为 goodsdesc。
l ext_value	string	否	否	否	商品描述 value。
l ext_key	string	否	否	否	invalid_day_in_week key,固定为 invalid_day_in_week
l ext_value	string	否	否	否	invalid_day_in_week value 字段说明:商品扩展-每周不可用日期，数字1~7用逗号分隔，1则表示星期一
l ext_key	string	否	否	否	location_type_desc key,固定为 location_type_desc
l ext_value	string	否	否	否	location_type_desc value 字段说明:商品扩展-商品关联地点类型，如博物馆
l ext_key	string	否	否	否	invalid_dates key,固定为 invalid_dates
l ext_value	string	否	否	否	invalid_dates value 字段说明:商品扩展-不可用日期

退单中 (refund_running)

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

接口参数 bizcontent 示例

参数说明

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
out_biz_no	string	是	否	否	外部订单号。由商家自定义。注意：同一笔订单更新状态时，需与首次同步入参一致。
buyer_id（buyer_open_id）	string	是	否	否	支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认应用-开发配置-openid配置管理已启用。无该配置项，可查看 openid配置申请。
order_type	string	是	否	否	订单类型。固定为service_order（服务订单）。
order_create_time	string	是	否	否	订单创建时间，即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time	string	是	是	否	订单修改时间，时间格式为 yyyy-mm-dd hh:mm:ss.sss，订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制，防止乱序。order_modified_time较晚的同步会被最终存储，order_modified_time相同的两次同步会被幂等处理。
service_code	string	否	否	否	服务code：传入小程序后台提报的服务id，将订单与服务关联。service_code 通过 alipay.open.app.service.apply(服务提报申请)接口提报服务后获取。
source_app	string	否	否	否	订单来源，默认alipay(支付宝小程序)，钉钉来源dingtalk，其他来源枚举值定义联系支付宝订单中心添加。
trade_no	string	否	否	否	支付宝交易号。注意：若该状态传递了trade_no，则同步该订单的后续状态时都需要传递trade_no。此字段关联支付宝账单详情卡片，建议回传真实有效交易号。
amount	price	选填，建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)	是	否	订单总金额。精确到小数点后两位，单位为元
pay_amount	price	选填，建议传入该参数	否	否	实际支付金额。精确到小数点后两位。单位为元
discount_amount	price	否	否	否	优惠金额。传入 discount_info_list 时必填。单位为元
item_order_list	itemorderinfo	是	否	否	商品信息列表。详见下文: 商品信息列表
ext_info	orderextinfo	是	是	否	订单扩展字段。详见下文订单扩展字段。

订单扩展字段

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
l ext_key	string	是	否	否	订单状态 key。固定为 merchant_order_status
l ext_value	string	是	是	否	订单状态, 例: refund_running
l ext_key	string	是	否	否	订单类型 key。固定为 merchant_biz_type。
l ext_value	string	是	否	否	订单类型 value。本业务场景为: scenic_ticket
l ext_key	string	是	否	否	订单详情地址 key。固定为merchant_order_link_page，一笔订单同步过程中需要保持一致。
l ext_value	string	是	否	否	商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同，且需是小程序内部页面路径，例如：/pages/index/index?orderid=10190608609185。
l ext_key	string	是	否	否	商家小程序 appid key。固定为 tiny_app_id。
l ext_value	string	是	否	否	商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key	string	是	否	否	订单业务场景相关的信息 key。固定为 business_info。
l ext_value	jsonstring	是	是	否	订单业务信息详情 value。入参详情见下文业务信息参数。

业务信息参数

业务信息参数（business_info）的各项入参详情如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
ticket_num	string	是	否	否	字段名称:门票数量字段说明:门票的数量
passagers_info	string	否	否	否	字段名称:游客信息字段说明:[{"name":"填入游客姓名","mobile":"填入游客手机号","certtype":"填入游客证件类型","certno":"填入游客证件号"}]
contact_user_info	string	否	否	否	字段名称:联系人信息字段说明:[{"name":"填入游客姓名","mobile":"填入游客手机号","certtype":"填入游客证件类型","certno":"填入游客证件号"}]
drawer_way	string	否	否	否	字段名称:订票方式字段说明:通过什么方式预订的门票

商品信息列表

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

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
sku_id	string	是	否	否	商家侧商品 sku id
status	string	是	否	否	字段名称:商品状态字段说明:门票状态
item_name	string	是	否	否	商品名称。建议商品名称格式为：{商家名称} {商品名称}
quantity	number	是	否	否	商品数量。支持两位小数点。注意：与unit_price成对出现，若传了quantity，则需要将unit_price传入
sku_id	string	是	否	否	商家侧商品 sku id
unit_price	price	是	否	否	商品单价。精确到小数点后两位。单位为元注意：与quantity成对出现，若传了unit_price，则需要将quantity传入
unit	string	否	否	否	字段名称:商品规格字段说明:份、件、斤、kg，默认为份
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	否	否	否	entry_start_time key,固定为 entry_start_time
l ext_value	string	否	否	否	entry_start_time value 字段说明:入园开始时间
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	商品图片 value。需传入上传商品文件获取的 material_id。
l ext_key	string	是	否	否	end_time key,固定为 end_time
l ext_value	string	是	否	否	end_time value 字段说明:订单中游玩结束时间点
l ext_key	string	否	否	否	location_type key,固定为 location_type
l ext_value	string	否	否	否	location_type value 字段说明:商品扩展-商品关联地点类型，如museum
l ext_key	string	否	否	否	entry_end_time key,固定为 entry_end_time
l ext_value	string	否	否	否	entry_end_time value 字段说明:入园结束时间
l ext_key	string	否	否	否	location_merchant_id key,固定为 location_merchant_id
l ext_value	string	否	否	否	location_merchant_id value 字段说明:景区id
l ext_key	string	是	否	否	start_time key,固定为 start_time
l ext_value	string	是	否	否	start_time value 字段说明:订单中游玩开始时间点
l ext_key	string	否	否	否	ticket_type key,固定为 ticket_type
l ext_value	string	否	否	否	ticket_type value 字段说明:景区类型：山水，人文，乐园，寺庙，博物馆，其他
l ext_key	string	否	否	否	location_name key,固定为 location_name
l ext_value	string	否	否	否	location_name value 字段说明:景区名称
l ext_key	string	否	否	否	商品描述 key。固定为 goodsdesc。
l ext_value	string	否	否	否	商品描述 value。
l ext_key	string	否	否	否	invalid_day_in_week key,固定为 invalid_day_in_week
l ext_value	string	否	否	否	invalid_day_in_week value 字段说明:商品扩展-每周不可用日期，数字1~7用逗号分隔，1则表示星期一
l ext_key	string	否	否	否	location_type_desc key,固定为 location_type_desc
l ext_value	string	否	否	否	location_type_desc value 字段说明:商品扩展-商品关联地点类型，如博物馆
l ext_key	string	否	否	否	invalid_dates key,固定为 invalid_dates
l ext_value	string	否	否	否	invalid_dates value 字段说明:商品扩展-不可用日期

退单审核中 (refund_auditing)

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

接口参数 bizcontent 示例

参数说明

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
out_biz_no	string	是	否	否	外部订单号。由商家自定义。注意：同一笔订单更新状态时，需与首次同步入参一致。
buyer_id（buyer_open_id）	string	是	否	否	支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认应用-开发配置-openid配置管理已启用。无该配置项，可查看 openid配置申请。
order_type	string	是	否	否	订单类型。固定为service_order（服务订单）。
order_create_time	string	是	否	否	订单创建时间，即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time	string	是	是	否	订单修改时间，时间格式为 yyyy-mm-dd hh:mm:ss.sss，订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制，防止乱序。order_modified_time较晚的同步会被最终存储，order_modified_time相同的两次同步会被幂等处理。
service_code	string	否	否	否	服务code：传入小程序后台提报的服务id，将订单与服务关联。service_code 通过 alipay.open.app.service.apply(服务提报申请)接口提报服务后获取。
source_app	string	否	否	否	订单来源，默认alipay(支付宝小程序)，钉钉来源dingtalk，其他来源枚举值定义联系支付宝订单中心添加。
trade_no	string	否	否	否	支付宝交易号。注意：若该状态传递了trade_no，则同步该订单的后续状态时都需要传递trade_no。此字段关联支付宝账单详情卡片，建议回传真实有效交易号。
amount	price	选填，建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)	是	否	订单总金额。精确到小数点后两位，单位为元
pay_amount	price	选填，建议传入该参数	否	否	实际支付金额。精确到小数点后两位。单位为元
discount_amount	price	否	否	否	优惠金额。传入 discount_info_list 时必填。单位为元
item_order_list	itemorderinfo	是	否	否	商品信息列表。详见下文: 商品信息列表
ext_info	orderextinfo	是	是	否	订单扩展字段。详见下文订单扩展字段。

订单扩展字段

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
l ext_key	string	是	否	否	订单状态 key。固定为 merchant_order_status
l ext_value	string	是	是	否	订单状态, 例: refund_auditing
l ext_key	string	是	否	否	订单类型 key。固定为 merchant_biz_type。
l ext_value	string	是	否	否	订单类型 value。本业务场景为: scenic_ticket
l ext_key	string	是	否	否	订单详情地址 key。固定为merchant_order_link_page，一笔订单同步过程中需要保持一致。
l ext_value	string	是	否	否	商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同，且需是小程序内部页面路径，例如：/pages/index/index?orderid=10190608609185。
l ext_key	string	是	否	否	商家小程序 appid key。固定为 tiny_app_id。
l ext_value	string	是	否	否	商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key	string	是	否	否	订单业务场景相关的信息 key。固定为 business_info。
l ext_value	jsonstring	是	是	否	订单业务信息详情 value。入参详情见下文业务信息参数。

业务信息参数

业务信息参数（business_info）的各项入参详情如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
ticket_num	string	是	否	否	字段名称:门票数量字段说明:门票的数量
passagers_info	string	否	否	否	字段名称:游客信息字段说明:[{"name":"填入游客姓名","mobile":"填入游客手机号","certtype":"填入游客证件类型","certno":"填入游客证件号"}]
contact_user_info	string	否	否	否	字段名称:联系人信息字段说明:[{"name":"填入游客姓名","mobile":"填入游客手机号","certtype":"填入游客证件类型","certno":"填入游客证件号"}]
drawer_way	string	否	否	否	字段名称:订票方式字段说明:通过什么方式预订的门票

商品信息列表

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

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
sku_id	string	是	否	否	商家侧商品 sku id
status	string	是	否	否	字段名称:商品状态字段说明:门票状态
item_name	string	是	否	否	商品名称。建议商品名称格式为：{商家名称} {商品名称}
quantity	number	是	否	否	商品数量。支持两位小数点。注意：与unit_price成对出现，若传了quantity，则需要将unit_price传入
sku_id	string	是	否	否	商家侧商品 sku id
unit_price	price	是	否	否	商品单价。精确到小数点后两位。单位为元注意：与quantity成对出现，若传了unit_price，则需要将quantity传入
unit	string	否	否	否	字段名称:商品规格字段说明:份、件、斤、kg，默认为份
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	否	否	否	entry_start_time key,固定为 entry_start_time
l ext_value	string	否	否	否	entry_start_time value 字段说明:入园开始时间
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	商品图片 value。需传入上传商品文件获取的 material_id。
l ext_key	string	是	否	否	end_time key,固定为 end_time
l ext_value	string	是	否	否	end_time value 字段说明:订单中游玩结束时间点
l ext_key	string	否	否	否	location_type key,固定为 location_type
l ext_value	string	否	否	否	location_type value 字段说明:商品扩展-商品关联地点类型，如museum
l ext_key	string	否	否	否	entry_end_time key,固定为 entry_end_time
l ext_value	string	否	否	否	entry_end_time value 字段说明:入园结束时间
l ext_key	string	否	否	否	location_merchant_id key,固定为 location_merchant_id
l ext_value	string	否	否	否	location_merchant_id value 字段说明:景区id
l ext_key	string	是	否	否	start_time key,固定为 start_time
l ext_value	string	是	否	否	start_time value 字段说明:订单中游玩开始时间点
l ext_key	string	否	否	否	ticket_type key,固定为 ticket_type
l ext_value	string	否	否	否	ticket_type value 字段说明:景区类型：山水，人文，乐园，寺庙，博物馆，其他
l ext_key	string	否	否	否	location_name key,固定为 location_name
l ext_value	string	否	否	否	location_name value 字段说明:景区名称
l ext_key	string	否	否	否	商品描述 key。固定为 goodsdesc。
l ext_value	string	否	否	否	商品描述 value。
l ext_key	string	否	否	否	invalid_day_in_week key,固定为 invalid_day_in_week
l ext_value	string	否	否	否	invalid_day_in_week value 字段说明:商品扩展-每周不可用日期，数字1~7用逗号分隔，1则表示星期一
l ext_key	string	否	否	否	location_type_desc key,固定为 location_type_desc
l ext_value	string	否	否	否	location_type_desc value 字段说明:商品扩展-商品关联地点类型，如博物馆
l ext_key	string	否	否	否	invalid_dates key,固定为 invalid_dates
l ext_value	string	否	否	否	invalid_dates value 字段说明:商品扩展-不可用日期

出票成功 (ticketed)

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

接口参数 bizcontent 示例

参数说明

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
out_biz_no	string	是	否	是	外部订单号。由商家自定义。注意：同一笔订单更新状态时，需与首次同步入参一致。
buyer_id（buyer_open_id）	string	是	否	否	支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认应用-开发配置-openid配置管理已启用。无该配置项，可查看 openid配置申请。
order_type	string	是	否	否	订单类型。固定为service_order（服务订单）。
order_create_time	string	是	否	否	订单创建时间，即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time	string	是	是	否	订单修改时间，时间格式为 yyyy-mm-dd hh:mm:ss.sss，订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制，防止乱序。order_modified_time较晚的同步会被最终存储，order_modified_time相同的两次同步会被幂等处理。
service_code	string	否	否	否	服务code：传入小程序后台提报的服务id，将订单与服务关联。service_code 通过 alipay.open.app.service.apply(服务提报申请)接口提报服务后获取。
source_app	string	否	否	否	订单来源，默认alipay(支付宝小程序)，钉钉来源dingtalk，其他来源枚举值定义联系支付宝订单中心添加。
trade_no	string	否	否	否	支付宝交易号。注意：若该状态传递了trade_no，则同步该订单的后续状态时都需要传递trade_no。此字段关联支付宝账单详情卡片，建议回传真实有效交易号。
amount	price	选填，建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)	是	否	订单总金额。精确到小数点后两位，单位为元
pay_amount	price	选填，建议传入该参数	否	否	实际支付金额。精确到小数点后两位。单位为元
discount_amount	price	否	否	否	优惠金额。传入 discount_info_list 时必填。单位为元
item_order_list	itemorderinfo	是	否	否	商品信息列表。详见下文: 商品信息列表
ext_info	orderextinfo	是	是	否	订单扩展字段。详见下文订单扩展字段。

订单扩展字段

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
l ext_key	string	是	否	否	订单状态 key。固定为 merchant_order_status
l ext_value	string	是	是	否	订单状态, 例: ticketed
l ext_key	string	是	否	否	订单类型 key。固定为 merchant_biz_type。
l ext_value	string	是	否	否	订单类型 value。本业务场景为: scenic_ticket
l ext_key	string	是	否	是	订单详情地址 key。固定为merchant_order_link_page，一笔订单同步过程中需要保持一致。
l ext_value	string	是	否	是	商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同，且需是小程序内部页面路径，例如：/pages/index/index?orderid=10190608609185。
l ext_key	string	是	否	否	商家小程序 appid key。固定为 tiny_app_id。
l ext_value	string	是	否	否	商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key	string	是	否	否	订单业务场景相关的信息 key。固定为 business_info。
l ext_value	jsonstring	是	是	否	订单业务信息详情 value。入参详情见下文业务信息参数。

业务信息参数

业务信息参数（business_info）的各项入参详情如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
ticket_num	string	是	否	是	字段名称:门票数量字段说明:门票的数量
passagers_info	string	否	否	否	字段名称:游客信息字段说明:[{"name":"填入游客姓名","mobile":"填入游客手机号","certtype":"填入游客证件类型","certno":"填入游客证件号"}]
contact_user_info	string	否	否	否	字段名称:联系人信息字段说明:[{"name":"填入游客姓名","mobile":"填入游客手机号","certtype":"填入游客证件类型","certno":"填入游客证件号"}]
drawer_way	string	是	否	否	字段名称:订票方式字段说明:通过什么方式预订的门票

商品信息列表

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

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
sku_id	string	否	否	否	商家侧商品 sku id
status	string	否	否	否	字段名称:商品状态字段说明:门票状态
item_name	string	是	否	是	商品名称。建议商品名称格式为：{商家名称} {商品名称}
quantity	number	否	否	否	商品数量。支持两位小数点。注意：与unit_price成对出现，若传了quantity，则需要将unit_price传入
sku_id	string	否	否	否	商家侧商品 sku id
unit_price	price	否	否	否	商品单价。精确到小数点后两位。单位为元注意：与quantity成对出现，若传了unit_price，则需要将quantity传入
unit	string	否	否	否	字段名称:商品规格字段说明:份、件、斤、kg，默认为份
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	否	否	否	entry_start_time key,固定为 entry_start_time
l ext_value	string	否	否	否	entry_start_time value 字段说明:入园开始时间
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	商品图片 value。需传入上传商品文件获取的 material_id。
l ext_key	string	否	否	否	end_time key,固定为 end_time
l ext_value	string	否	否	否	end_time value 字段说明:订单中游玩结束时间点
l ext_key	string	否	否	否	location_type key,固定为 location_type
l ext_value	string	否	否	否	location_type value 字段说明:商品扩展-商品关联地点类型，如museum
l ext_key	string	否	否	否	entry_end_time key,固定为 entry_end_time
l ext_value	string	否	否	否	entry_end_time value 字段说明:入园结束时间
l ext_key	string	否	否	否	location_merchant_id key,固定为 location_merchant_id
l ext_value	string	否	否	否	location_merchant_id value 字段说明:景区id
l ext_key	string	否	否	否	start_time key,固定为 start_time
l ext_value	string	否	否	否	start_time value 字段说明:订单中游玩开始时间点
l ext_key	string	否	否	否	ticket_type key,固定为 ticket_type
l ext_value	string	否	否	否	ticket_type value 字段说明:景区类型：山水，人文，乐园，寺庙，博物馆，其他
l ext_key	string	否	否	否	location_name key,固定为 location_name
l ext_value	string	否	否	否	location_name value 字段说明:景区名称
l ext_key	string	否	否	否	商品描述 key。固定为 goodsdesc。
l ext_value	string	否	否	否	商品描述 value。
l ext_key	string	否	否	否	invalid_day_in_week key,固定为 invalid_day_in_week
l ext_value	string	否	否	否	invalid_day_in_week value 字段说明:商品扩展-每周不可用日期，数字1~7用逗号分隔，1则表示星期一
l ext_key	string	否	否	否	location_type_desc key,固定为 location_type_desc
l ext_value	string	否	否	否	location_type_desc value 字段说明:商品扩展-商品关联地点类型，如博物馆
l ext_key	string	否	否	否	invalid_dates key,固定为 invalid_dates
l ext_value	string	否	否	否	invalid_dates value 字段说明:商品扩展-不可用日期

相关问题