开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
支付产品
私域产品
小程序产品
权限集列表
搜索关键词
搜索直达
收藏
消息
小程序码
小程序服务
订单中心
接入指南
各行业订单同步/查询详情
餐饮
零售批发
商业生活
交通出行
车主生活
教育培训
医疗卫生
酒旅景区
生活缴费
公共管理和社会组织
休闲娱乐
物流运输
网络通讯
api 列表
相关资料
小程序开发管理
生物核身
交易组件
小程序商品
支付有礼
商家粉丝群
营销产品
资金产品
会员产品
信用产品
广告产品
收藏
订阅更新
我的文档
设置
接入检测
即可查看检测结果)
若有未通过的接入检测项,接口将无法调通
商家需通过 alipay.merchant.order.sync(订单数据同步接口)订单扩展字段 ext_info#merchant_order_status 参数更新订单状态,具体状态说明如下。
订单状态说明
支持跨状态传递,如:near_depart (临近出发) 可直接跳转至 ticketed (出票成功) 。
不要求首次同步订单状态必须为 near_depart (临近出发) 。
订单状态发生变更后,需要及时同步最新状态。
当前场景定义的订单状态(中文和英文名)如下:
状态中文名
状态英文名
是否为有效订单核心状态
是否发送服务消息
是否发送 push
临近出发
near_depart



摆渡车登机
shuttle_buses



中转提醒
transit_remind



已支付
paid



开放值机
open_check_in



值机成功
check_in



取消值机
cancel_check_in



航班变更
flight_change



机型调整
model_change



物理舱位调整
cabin_change



座位变更
seats_change



航班延误
flight_delays



开始登机
start_boarding



临近登机
near_boarding



登机口变更
gate_change



航班取消
flight_cancellation



航班恢复
flight_back



航班时刻变更
time_change



航班到达
flight_arrives



行李提取
baggage_claim



行李转盘变更
baggageld_change



已退款
refunded



新行程开启
trip_start



航班取消(有保护)
flight_cancellation_p



行程取消
canceled



出票中
in_the_ticket



已改签
has_endorsed



出票成功
ticketed



注意:不同订单状态,仅 是否发送服务消息 时,用户才能在消息列表(支付宝凯发k8官方网娱乐官方首页服务提醒入口进入或凯发k8官方网娱乐官方首页底部消息 tab 进入)查看服务订单消息提醒。
不同状态参数使用说明
临近出发 (near_depart)
本文详细介绍通过接口 alipay.merchant.order.sync(订单数据同步接口)同步订单状态-临近出发 (near_depart) 时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。  注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id(buyer_open_id)
string



支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请

order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss,订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。
category_id
string



支付宝标准服务类目 code,本模板支持类目 code:c100955087。
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



订单状态, 例: near_depart。
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为: air_ticket。
l ext_key
string



订单详情地址 key。固定为merchant_order_link_page,一笔订单同步过程中需要保持一致。
l ext_value
string



商户小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数。
业务信息参数
业务信息参数(business_info)的各项入参详情如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
arrival_time
string



字段名称:落地时间
字段说明:本次航班预计落地时间,时间格式为 yyyy-mm-dd hh:mm:ss。
flight_no
string



字段名称:航班号
字段说明:本次航班编号。
departure_name
string



字段名称:始发机场
字段说明:本次航班的起飞机场名,包含航站楼。
arrival_name
string



字段名称:落地机场
字段说明:本次航班的落地机场名,包含航站楼。
departure_time
string



字段名称:起飞时间
字段说明:本次航班预计起飞时间。
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}。
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件 获取的 material_id。
摆渡车登机 (shuttle_buses)
本文详细介绍通过接口 alipay.merchant.order.sync(订单数据同步接口)同步订单状态-摆渡车登机 (shuttle_buses) 时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。  注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id(buyer_open_id)
string



支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请

order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss,订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。
category_id
string



支付宝标准服务类目 code,本模板支持类目 code:c100955087。
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



订单状态, 例: shuttle_buses。
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为: air_ticket。
l ext_key
string



订单详情地址 key。固定为merchant_order_link_page,一笔订单同步过程中需要保持一致。
l ext_value
string



商户小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数。
业务信息参数
业务信息参数(business_info) 的各项入参详情如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
arrival_time
string



字段名称:
落地时间
字段说明:本次航班预计落地时间,时间格式为 yyyy-mm-dd hh:mm:ss。
flight_no
string



字段名称:航班号
字段说明:本次航班编号。
departure_name
string



字段名称:始发机场
字段说明:本次航班的起飞机场名,包含航站楼。
arrival_name
string



字段名称:落地机场
字段说明:本次航班的落地机场名,包含航站楼。
departure_time
string



字段名称:
起飞时间
字段说明:本次航班预计起飞时间。
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}。
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件 获取的 material_id。
中转提醒 (transit_remind)
本文详细介绍通过接口 alipay.merchant.order.sync(订单数据同步接口)同步订单状态-中转提醒 (transit_remind) 时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。  注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id(buyer_open_id)
string



支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请

order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss,订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。
category_id
string



支付宝标准服务类目 code,本模板支持类目 code:c100955087。
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



订单状态, 例: transit_remind。
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为: air_ticket。
l ext_key
string



订单详情地址 key。固定为merchant_order_link_page,一笔订单同步过程中需要保持一致。
l ext_value
string



商户小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数。
业务信息参数
业务信息参数(business_info)的各项入参详情如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
arrival_time
string



字段名称:落地时间
字段说明:本次航班预计落地时间,时间格式为 yyyy-mm-dd hh:mm:ss。
flight_no
string



字段名称:航班号
字段说明:本次航班编号。
departure_name
string



字段名称:始发机场
字段说明:本次航班的起飞机场名,包含航站楼。
arrival_name
string



字段名称:落地机场
字段说明:本次航班的落地机场名,包含航站楼。
departure_time
string



字段名称:起飞时间
字段说明:本次航班预计起飞时间。
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}。
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件 获取的 material_id。
已支付 (paid)
本文详细介绍通过接口 alipay.merchant.order.sync(订单数据同步接口)同步订单状态-已支付 (paid) 时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。  注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id(buyer_open_id)
string



支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请

order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss,订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。
category_id
string



支付宝标准服务类目 code,本模板支持类目 code:c100955087。
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



订单总金额。精确到小数点后两位,单位为元。
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



订单状态, 例: paid。
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为: air_ticket。
l ext_key
string



订单详情地址 key。固定为merchant_order_link_page,一笔订单同步过程中需要保持一致。
l ext_value
string



商户小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数。
业务信息参数
业务信息参数(business_info) 的各项入参详情如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
arrival_time
string



字段名称:落地时间
字段说明:本次航班预计落地时间,时间格式为 yyyy-mm-dd hh:mm:ss。
flight_no
string



字段名称:航班号
字段说明:本次航班编号。
departure_name
string



字段名称:始发机场
字段说明:本次航班的起飞机场名,包含航站楼。
arrival_name
string



字段名称:落地机场
字段说明:本次航班的落地机场名,包含航站楼。
departure_time
string



字段名称:起飞时间
字段说明:本次航班预计起飞时间。
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}。
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件 获取的 material_id。
开放值机 (open_check_in)
本文详细介绍通过接口 alipay.merchant.order.sync(订单数据同步接口)同步订单状态-开放值机 (open_check_in) 时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。  注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id(buyer_open_id)
string



支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请

order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss,订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。
category_id
string



支付宝标准服务类目 code,本模板支持类目 code:c100955087。
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



订单状态, 例: open_check_in。
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为: air_ticket。
l ext_key
string



订单详情地址 key。固定为merchant_order_link_page,一笔订单同步过程中需要保持一致。
l ext_value
string



商户小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数。
业务信息参数
业务信息参数(business_info) 的各项入参详情如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
arrival_time
string



字段名称:落地时间
字段说明:本次航班预计落地时间,时间格式为 yyyy-mm-dd hh:mm:ss。
flight_no
string



字段名称:航班号
字段说明:本次航班编号。
departure_name
string



字段名称:始发机场
字段说明:本次航班的起飞机场名,包含航站楼。
arrival_name
string



字段名称:落地机场
字段说明:本次航班的落地机场名,包含航站楼。
departure_time
string



字段名称:起飞时间
字段说明:本次航班预计起飞时间。
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}。
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件 获取的 material_id。
值机成功 (check_in)
本文详细介绍通过接口 alipay.merchant.order.sync(订单数据同步接口)同步订单状态-值机成功 (check_in) 时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。  注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id(buyer_open_id)
string



支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请

order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss,订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。
category_id
string



支付宝标准服务类目 code,本模板支持类目 code:c100955087。
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_in。
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为: air_ticket。
l ext_key
string



订单详情地址 key。固定为merchant_order_link_page,一笔订单同步过程中需要保持一致。
l ext_value
string



商户小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数。
业务信息参数
业务信息参数(business_info)的各项入参详情如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
arrival_time
string



字段名称:落地时间
字段说明:本次航班预计落地时间,时间格式为 yyyy-mm-dd hh:mm:ss。
flight_no
string



字段名称:航班号
字段说明:本次航班编号。
departure_name
string



字段名称:始发机场
字段说明:本次航班的起飞机场名,包含航站楼。
arrival_name
string



字段名称:落地机场
字段说明:本次航班的落地机场名,包含航站楼。
departure_time
string



字段名称:起飞时间
字段说明:本次航班预计起飞时间。
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}。
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件 获取的 material_id。
取消值机 (cancel_check_in)
本文详细介绍通过接口 alipay.merchant.order.sync(订单数据同步接口)同步订单状态-取消值机 (cancel_check_in) 时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。  注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id(buyer_open_id)
string



支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请

order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss,订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。
category_id
string



支付宝标准服务类目 code,本模板支持类目 code:c100955087。
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



订单状态, 例: cancel_check_in。
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为: air_ticket。
l ext_key
string



订单详情地址 key。固定为merchant_order_link_page,一笔订单同步过程中需要保持一致。
l ext_value
string



商户小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数。
业务信息参数
业务信息参数(business_info) 的各项入参详情如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
arrival_time
string



字段名称:落地时间
字段说明:本次航班预计落地时间,时间格式为 yyyy-mm-dd hh:mm:ss。
flight_no
string



字段名称:航班号
字段说明:本次航班编号。
departure_name
string



字段名称:始发机场
字段说明:本次航班的起飞机场名,包含航站楼。
arrival_name
string



字段名称:落地机场
字段说明:本次航班的落地机场名,包含航站楼。
departure_time
string



字段名称:起飞时间
字段说明:本次航班预计起飞时间。
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}。
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件 获取的 material_id。
航班变更 (flight_change)
本文详细介绍通过接口 alipay.merchant.order.sync(订单数据同步接口)同步订单状态-航班变更 (flight_change) 时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。  注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id(buyer_open_id)
string



支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请

order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss,订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。
category_id
string



支付宝标准服务类目 code,本模板支持类目 code:c100955087。
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



订单状态, 例: flight_change。
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为: air_ticket。
l ext_key
string



订单详情地址 key。固定为merchant_order_link_page,一笔订单同步过程中需要保持一致。
l ext_value
string



商户小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数。
业务信息参数
业务信息参数(business_info) 的各项入参详情如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
new_departure_time
string



字段名称:新起飞时间
字段说明:变更后的起飞时间,时间格式为 yyyy-mm-dd hh:mm:ss。
new_departure_name
string



字段名称:新始发机场
字段说明:变更后的始发机场。
new_flight_no
string



字段名称:新航班号
字段说明:变更后的航班号。
new_arrival_name
string



字段名称:新到达机场
字段说明:变更后的到达机场。
new_arrival_time
string



字段名称:新到达时间
字段说明:变更后的到达时间,时间格式为 yyyy-mm-dd hh:mm:ss。
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}。
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件 获取的 material_id。
机型调整 (model_change)
本文详细介绍通过接口 alipay.merchant.order.sync(订单数据同步接口)同步订单状态-机型调整 (model_change) 时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。  注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id(buyer_open_id)
string



支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请

order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss,订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。
category_id
string



支付宝标准服务类目 code,本模板支持类目 code:c100955087。
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



订单状态, 例: model_change。
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为: air_ticket。
l ext_key
string



订单详情地址 key。固定为merchant_order_link_page,一笔订单同步过程中需要保持一致。
l ext_value
string



商户小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数。
业务信息参数
业务信息参数(business_info) 的各项入参详情如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
models
string



字段名称:原机型
字段说明:变更前的机型。
flight_no
string



字段名称:航班号
字段说明:本次航班编号。
new_models
string



字段名称:新机型
字段说明:变更后的机型。
departure_time
string



字段名称:起飞时间
字段说明:本次航班预计起飞时间。
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}。
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件 获取的 material_id。
物理舱位调整 (cabin_change)
本文详细介绍通过接口 alipay.merchant.order.sync(订单数据同步接口)同步订单状态-物理舱位调整 (cabin_change) 时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。  注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id(buyer_open_id)
string



支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请

order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss,订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。
category_id
string



支付宝标准服务类目 code,本模板支持类目 code:c100955087。
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



订单状态, 例: cabin_change。
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为: air_ticket。
l ext_key
string



订单详情地址 key。固定为merchant_order_link_page,一笔订单同步过程中需要保持一致。
l ext_value
string



商户小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数。
业务信息参数
业务信息参数(business_info) 的各项入参详情如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
new_shipping_space
string



字段名称:新舱位
字段说明:变更后的舱位。
flight_no
string



字段名称:航班号
字段说明:本次航班编号。
shipping_space
string



字段名称:原舱位
字段说明:变更前的舱位。
departure_time
string



字段名称:起飞时间
字段说明:本次航班预计起飞时间。
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}。
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件 获取的 material_id。
座位变更 (seats_change)
本文详细介绍通过接口 alipay.merchant.order.sync(订单数据同步接口)同步订单状态-座位变更 (seats_change) 时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。  注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id(buyer_open_id)
string



支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请

order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss,订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。
category_id
string



支付宝标准服务类目 code,本模板支持类目 code:c100955087。
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



订单状态, 例: seats_change。
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为: air_ticket。
l ext_key
string



订单详情地址 key。固定为merchant_order_link_page,一笔订单同步过程中需要保持一致。
l ext_value
string



商户小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数。
业务信息参数
业务信息参数(business_info) 的各项入参详情如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
seat_no
string



字段名称:座位号
字段说明:已经值机后产生的座位号。
new_seat_no
string



字段名称:新座位号
字段说明:变更后的座位号。
flight_no
string



字段名称:航班号
字段说明:本次航班编号。
departure_time
string



字段名称:起飞时间
字段说明:本次航班预计起飞时间。
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}。
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件 获取的 material_id。
航班延误 (flight_delays)
本文详细介绍通过接口 alipay.merchant.order.sync(订单数据同步接口)同步订单状态-航班延误 (flight_delays) 时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。  注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id(buyer_open_id)
string



支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请

order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss,订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。
category_id
string



支付宝标准服务类目 code,本模板支持类目 code:c100955087。
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



订单状态, 例: flight_delays。
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为: air_ticket。
l ext_key
string



订单详情地址 key。固定为merchant_order_link_page,一笔订单同步过程中需要保持一致。
l ext_value
string



商户小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数。
业务信息参数
业务信息参数(business_info) 的各项入参详情如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
reason
string



字段名称:原因
字段说明:航班取消或者变更的原因。
arrival_time
string



字段名称:落地时间
字段说明:本次航班预计落地时间,时间格式为 yyyy-mm-dd hh:mm:ss。
flight_no
string



字段名称:航班号
字段说明:本次航班编号。
departure_name
string



字段名称:始发机场
字段说明:本次航班的起飞机场名,包含航站楼。
arrival_name
string



字段名称:落地机场
字段说明:本次航班的落地机场名,包含航站楼。
departure_time
string



字段名称:起飞时间
字段说明:本次航班预计起飞时间。
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}。
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件 获取的 material_id。
开始登机 (start_boarding)
本文详细介绍通过接口 alipay.merchant.order.sync(订单数据同步接口)同步订单状态-开始登机 (start_boarding) 时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。  注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id(buyer_open_id)
string



支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请

order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss,订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。
category_id
string



支付宝标准服务类目 code,本模板支持类目 code:c100955087。
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



订单状态, 例: start_boarding。
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为: air_ticket。
l ext_key
string



订单详情地址 key。固定为merchant_order_link_page,一笔订单同步过程中需要保持一致。
l ext_value
string



商户小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数。
业务信息参数
业务信息参数(business_info) 的各项入参详情如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
arrival_time
string



字段名称:落地时间
字段说明:本次航班预计落地时间,时间格式为 yyyy-mm-dd hh:mm:ss。
flight_no
string



字段名称:航班号
字段说明:本次航班编号。
departure_name
string



字段名称:始发机场
字段说明:本次航班的起飞机场名,包含航站楼。
board_gate
string



字段名称:登机口
字段说明:本次航班的登机口。
arrival_name
string



字段名称:落地机场
字段说明:本次航班的落地机场名,包含航站楼。
departure_time
string



字段名称:起飞时间
字段说明:本次航班预计起飞时间。
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}。
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件 获取的 material_id。
临近登机 (near_boarding)
本文详细介绍通过接口 alipay.merchant.order.sync(订单数据同步接口)同步订单状态-临近登机 (near_boarding) 时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。  注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id(buyer_open_id)
string



支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请

order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss,订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。
category_id
string



支付宝标准服务类目 code,本模板支持类目 code:c100955087。
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



订单状态, 例: near_boarding。
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为: air_ticket。
l ext_key
string



订单详情地址 key。固定为merchant_order_link_page,一笔订单同步过程中需要保持一致。
l ext_value
string



商户小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数。
业务信息参数
业务信息参数(business_info) 的各项入参详情如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
arrival_time
string



字段名称:落地时间
字段说明:本次航班预计落地时间,时间格式为 yyyy-mm-dd hh:mm:ss。
flight_no
string



字段名称:航班号
字段说明:本次航班编号。
departure_name
string



字段名称:始发机场
字段说明:本次航班的起飞机场名,包含航站楼。
arrival_name
string



字段名称:落地机场
字段说明:本次航班的落地机场名,包含航站楼。
departure_time
string



字段名称:起飞时间
字段说明:本次航班预计起飞时间。
latest_time
string



字段名称:最晚到达机场时间
字段说明:建议最晚几点到达机场,时间格式为 yyyy-mm-dd hh:mm:ss。
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}。
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件 获取的 material_id。
登机口变更 (gate_change)
本文详细介绍通过接口 alipay.merchant.order.sync(订单数据同步接口)同步订单状态-登机口变更 (gate_change) 时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。  注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id(buyer_open_id)
string



支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请

order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss,订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。
category_id
string



支付宝标准服务类目 code,本模板支持类目 code:c100955087。
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



订单状态, 例: gate_change。
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为: air_ticket。
l ext_key
string



订单详情地址 key。固定为merchant_order_link_page,一笔订单同步过程中需要保持一致。
l ext_value
string



商户小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数。
业务信息参数
业务信息参数(business_info) 的各项入参详情如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
new_board_gate
string



字段名称:新登机口
字段说明:变更后的登记口。
arrival_time
string



字段名称:落地时间
字段说明:本次航班预计落地时间,时间格式为 yyyy-mm-dd hh:mm:ss。
flight_no
string



字段名称:航班号
字段说明:本次航班编号。
board_gate
string



字段名称:登机口
字段说明:本次航班的登机口。
departure_time
string



字段名称:起飞时间
字段说明:本次航班预计起飞时间。
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}。
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件 获取的 material_id。
航班取消 (flight_cancellation)
本文详细介绍通过接口 alipay.merchant.order.sync(订单数据同步接口)同步订单状态-航班取消 (flight_cancellation) 时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。  注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id(buyer_open_id)
string



支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请

order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss,订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。
category_id
string



支付宝标准服务类目 code,本模板支持类目 code:c100955087。
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



订单状态, 例: flight_cancellation。
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为: air_ticket。
l ext_key
string



订单详情地址 key。固定为merchant_order_link_page,一笔订单同步过程中需要保持一致。
l ext_value
string



商户小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数。
业务信息参数
业务信息参数(business_info) 的各项入参详情如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
reason
string



字段名称:原因
字段说明:航班取消或者变更的原因。
arrival_time
string



字段名称:落地时间
字段说明:本次航班预计落地时间,时间格式为 yyyy-mm-dd hh:mm:ss。
flight_no
string



字段名称:航班号
字段说明:本次航班编号。
departure_name
string



字段名称:始发机场
字段说明:本次航班的起飞机场名,包含航站楼。
arrival_name
string



字段名称:落地机场
字段说明:本次航班的落地机场名,包含航站楼。
departure_time
string



字段名称:起飞时间
字段说明:本次航班预计起飞时间。
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}。
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件 获取的 material_id。
航班恢复 (flight_back)
本文详细介绍通过接口 alipay.merchant.order.sync(订单数据同步接口)同步订单状态-航班恢复 (flight_back) 时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。  注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id(buyer_open_id)
string



支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请

order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss,订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。
category_id
string



支付宝标准服务类目 code,本模板支持类目 code:c100955087。
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



订单状态, 例: flight_back。
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为: air_ticket。
l ext_key
string



订单详情地址 key。固定为merchant_order_link_page,一笔订单同步过程中需要保持一致。
l ext_value
string



商户小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数。
业务信息参数
业务信息参数(business_info) 的各项入参详情如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
arrival_time
string



字段名称:落地时间
字段说明:本次航班预计落地时间,时间格式为 yyyy-mm-dd hh:mm:ss。
flight_no
string



字段名称:航班号
字段说明:本次航班编号。
departure_name
string



字段名称:始发机场
字段说明:本次航班的起飞机场名,包含航站楼。
arrival_name
string



字段名称:落地机场
字段说明:本次航班的落地机场名,包含航站楼。
departure_time
string



字段名称:起飞时间
字段说明:本次航班预计起飞时间。
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}。
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件 获取的 material_id。
航班时刻变更 (time_change)
本文详细介绍通过接口 alipay.merchant.order.sync(订单数据同步接口)同步订单状态-航班时刻变更 (time_change) 时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。  注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id(buyer_open_id)
string



支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请
order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss,订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。
category_id
string



支付宝标准服务类目 code,本模板支持类目code:c100955087。
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



订单状态, 例: time_change。
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为: air_ticket。
l ext_key
string



订单详情地址 key。固定为merchant_order_link_page,一笔订单同步过程中需要保持一致。
l ext_value
string



商户小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数。
业务信息参数
业务信息参数(business_info)的各项入参详情如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
new_departure_time
string



字段名称:新起飞时间
字段说明:变更后的起飞时间,时间格式为 yyyy-mm-dd hh:mm:ss。
new_departure_name
string



字段名称:新始发机场
字段说明:变更后的始发机场。
new_flight_no
string



字段名称:新航班号
字段说明:变更后的航班号。
new_arrival_name
string



字段名称:新到达机场
字段说明:变更后的到达机场。
new_arrival_time
string



字段名称:新到达时间
字段说明:变更后的到达时间,时间格式为 yyyy-mm-dd hh:mm:ss。
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}。
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件 获取的 material_id。
航班到达 (flight_arrives)
本文详细介绍通过接口 alipay.merchant.order.sync(订单数据同步接口)同步订单状态-航班到达 (flight_arrives) 时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。  注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id(buyer_open_id)
string



支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请

order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss,订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。
category_id
string



支付宝标准服务类目 code,本模板支持类目code:c100955087。
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



订单状态, 例: flight_arrives。
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为: air_ticket。
l ext_key
string



订单详情地址 key。固定为 merchant_order_link_page,一笔订单同步过程中需要保持一致。
l ext_value
string



商户小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数。
业务信息参数
业务信息参数(business_info) 的各项入参详情如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
arrival_time
string



字段名称:落地时间
字段说明:本次航班预计落地时间,时间格式为 yyyy-mm-dd hh:mm:ss。
flight_no
string



字段名称:航班号
字段说明:本次航班编号。
arrival_name
string



字段名称:落地机场
字段说明:本次航班的落地机场名,包含航站楼。
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}。
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件 获取的 material_id。
行李提取 (baggage_claim)
本文详细介绍通过接口 alipay.merchant.order.sync(订单数据同步接口)同步订单状态-行李提取 (baggage_claim) 时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。  注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id(buyer_open_id)
string



支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请

order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss,订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。
category_id
string



支付宝标准服务类目 code,本模板支持类目 code:c100955087。
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



订单状态, 例: baggage_claim。
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为: air_ticket。
l ext_key
string



订单详情地址 key。固定为 merchant_order_link_page,一笔订单同步过程中需要保持一致。
l ext_value
string



商户小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数。
业务信息参数
业务信息参数(business_info) 的各项入参详情如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
arrival_time
string



字段名称:落地时间
字段说明:本次航班预计落地时间,时间格式为 yyyy-mm-dd hh:mm:ss。
flight_no
string



字段名称:航班号
字段说明:本次航班编号。
arrival_name
string



字段名称:落地机场
字段说明:本次航班的落地机场名,包含航站楼。
baggage_id
string



字段名称:行李转盘
字段说明:行李转盘的编号。
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}。
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件 获取的 material_id。
行李转盘变更 (baggageld_change)
本文详细介绍通过接口 alipay.merchant.order.sync(订单数据同步接口)同步订单状态-行李转盘变更 (baggageld_change) 时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。  注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id(buyer_open_id)
string



支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请

order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss,订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。
category_id
string



支付宝标准服务类目 code,本模板支持类目 code:c100955087。
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



订单状态, 例: baggageld_change。
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为: air_ticket。
l ext_key
string



订单详情地址 key。固定为merchant_order_link_page,一笔订单同步过程中需要保持一致。
l ext_value
string



商户小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数。
业务信息参数
业务信息参数(business_info) 的各项入参详情如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
arrival_time
string



字段名称:落地时间
字段说明:本次航班预计落地时间,时间格式为 yyyy-mm-dd hh:mm:ss。
new_baggage_id
string



字段名称:新行李转盘
字段说明:变更后的行李转盘。
flight_no
string



字段名称:航班号
字段说明:本次航班编号。
arrival_name
string



字段名称:落地机场
字段说明:本次航班的落地机场名,包含航站楼。
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}。
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件 获取的 material_id。
已退款 (refunded)
本文详细介绍通过接口 alipay.merchant.order.sync(订单数据同步接口)同步订单状态-已退款 (refunded) 时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。  注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id(buyer_open_id)
string



支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请

order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss,订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。
category_id
string



支付宝标准服务类目 code,本模板支持类目 code:c100955087。
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



订单状态, 例: refunded。
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为: air_ticket。
l ext_key
string



订单详情地址 key。固定为merchant_order_link_page,一笔订单同步过程中需要保持一致。
l ext_value
string



商户小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数。
业务信息参数
业务信息参数(business_info) 的各项入参详情如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
flight_no
string



字段名称:航班号
字段说明:本次航班编号。
departure_name
string



字段名称:始发机场
字段说明:本次航班的起飞机场名,包含航站楼。
arrival_name
string



字段名称:落地机场
字段说明:本次航班的落地机场名,包含航站楼。
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}。
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件 获取的 material_id。
新行程开启 (trip_start)
本文详细介绍通过接口 alipay.merchant.order.sync(订单数据同步接口)同步订单状态-新行程开启 (trip_start) 时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。  注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id(buyer_open_id)
string



支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请
order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss,订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。
category_id
string



支付宝标准服务类目 code,本模板支持类目 code:c100955087。
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



订单状态, 例: trip_start。
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为: air_ticket。
l ext_key
string



订单详情地址 key。固定为merchant_order_link_page,一笔订单同步过程中需要保持一致。
l ext_value
string



商户小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数。
业务信息参数
业务信息参数(business_info) 的各项入参详情如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
arrival_time
string



字段名称:落地时间
字段说明:本次航班预计落地时间,时间格式为 yyyy-mm-dd hh:mm:ss。
flight_no
string



字段名称:航班号
字段说明:本次航班编号。
departure_name
string



字段名称:始发机场
字段说明:本次航班的起飞机场名,包含航站楼。
arrival_name
string



字段名称:落地机场
字段说明:本次航班的落地机场名,包含航站楼。
departure_time
string



字段名称:起飞时间
字段说明:本次航班预计起飞时间。
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}。
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件 获取的 material_id。
航班取消(有保护) (flight_cancellation_p)
本文详细介绍通过接口 alipay.merchant.order.sync(订单数据同步接口)同步订单状态-航班取消(有保护) (flight_cancellation_p) 时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。  注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id(buyer_open_id)
string



支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请

order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss,订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。
category_id
string



支付宝标准服务类目 code,本模板支持类目 code:c100955087。
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



订单状态, 例: flight_cancellation_p。
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为: air_ticket。
l ext_key
string



订单详情地址 key。固定为merchant_order_link_page,一笔订单同步过程中需要保持一致。
l ext_value
string



商户小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数。
业务信息参数
业务信息参数(business_info)的各项入参详情如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
new_departure_time
string



字段名称:新起飞时间
字段说明:变更后的起飞时间,时间格式为 yyyy-mm-dd hh:mm:ss。
new_departure_name
string



字段名称:新始发机场
字段说明:变更后的始发机场。
new_flight_no
string



字段名称:新航班号
字段说明:变更后的航班号。
new_arrival_name
string



字段名称:新到达机场
字段说明:变更后的到达机场。
new_arrival_time
string



字段名称:新到达时间
字段说明:变更后的到达时间,时间格式为 yyyy-mm-dd hh:mm:ss。
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}。
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件 获取的 material_id。
行程取消 (canceled)
本文详细介绍通过接口 alipay.merchant.order.sync(订单数据同步接口)同步订单状态-行程取消 (canceled) 时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。  注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id(buyer_open_id)
string



支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请

order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss,订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。
category_id
string



支付宝标准服务类目 code,本模板支持类目 code:c100955087。
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



订单状态, 例: canceled。
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为: air_ticket。
l ext_key
string



订单详情地址 key。固定为merchant_order_link_page,一笔订单同步过程中需要保持一致。
l ext_value
string



商户小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数。
业务信息参数
业务信息参数(business_info) 的各项入参详情如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
flight_no
string



字段名称:航班号
字段说明:本次航班编号。
departure_name
string



字段名称:始发机场
字段说明:本次航班的起飞机场名,包含航站楼。
arrival_name
string



字段名称:落地机场
字段说明:本次航班的落地机场名,包含航站楼。
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}。
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件 获取的 material_id。
出票中 (in_the_ticket)
本文详细介绍通过接口 alipay.merchant.order.sync(订单数据同步接口)同步订单状态-出票中 (in_the_ticket) 时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。  注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id(buyer_open_id)
string



支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请

order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss,订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。
category_id
string



支付宝标准服务类目 code,本模板支持类目 code:c100955087。
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



订单状态, 例: in_the_ticket。
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为: air_ticket。
l ext_key
string



订单详情地址 key。固定为merchant_order_link_page,一笔订单同步过程中需要保持一致。
l ext_value
string



商户小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数。
业务信息参数
业务信息参数(business_info) 的各项入参详情如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
arrival_time
string



字段名称:落地时间
字段说明:本次航班预计落地时间,时间格式为 yyyy-mm-dd hh:mm:ss。
flight_no
string



字段名称:航班号
字段说明:本次航班编号。
departure_time
string



字段名称:起飞时间
字段说明:本次航班预计起飞时间。
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}。
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件 获取的 material_id。
已改签 (has_endorsed)
本文详细介绍通过接口 alipay.merchant.order.sync(订单数据同步接口)同步订单状态-已改签 (has_endorsed) 时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。  注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id(buyer_open_id)
string



支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请

order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss,订单状态或内容发生变更时需要同步更新该时间。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。
category_id
string



支付宝标准服务类目 code,本模板支持类目 code:c100955087。
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



订单状态, 例: has_endorsed。
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为: air_ticket。
l ext_key
string



订单详情地址 key。固定为merchant_order_link_page,一笔订单同步过程中需要保持一致。
l ext_value
string



商户小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数。
业务信息参数
业务信息参数(business_info)的各项入参详情如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
flight_no
string



字段名称:航班号
字段说明:本次航班编号。
departure_name
string



字段名称:始发机场
字段说明:本次航班的起飞机场名,包含航站楼。
arrival_name
string



字段名称:落地机场
字段说明:本次航班的落地机场名,包含航站楼。
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}。
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件 获取的 material_id。
出票成功 (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 相同的两次同步会被幂等处理。
category_id
string



支付宝标准服务类目 code,本模板支持类目 code:c100955087。
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



订单状态, 例: ticketed。
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为: air_ticket。
l ext_key
string



订单详情地址 key。固定为merchant_order_link_page,一笔订单同步过程中需要保持一致。
l ext_value
string



商户小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数。
业务信息参数
业务信息参数(business_info) 的各项入参详情如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
arrival_time
string



字段名称:落地时间
字段说明:本次航班预计落地时间,时间格式为 yyyy-mm-dd hh:mm:ss。
flight_no
string



字段名称:航班号
字段说明:本次航班编号。
departure_name
string



字段名称:始发机场
字段说明:本次航班的起飞机场名,包含航站楼。
arrival_name
string



字段名称:落地机场
字段说明:本次航班的落地机场名,包含航站楼。
departure_time
string



字段名称:起飞时间
字段说明:本次航班预计起飞时间。
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}。
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件 获取的 material_id。
内容没有解决您的问题?您还可以前往 或 寻求帮助
凯发k8官方网娱乐官方 copyright © 支付宝(杭州)信息技术有限公司  | icp证浙b2-20160559
该文档对你是否有帮助?
当前页面目录
网站地图