专利/商标服务（patent-凯发app官方网站

更新时间：2024-10-23 18:09:23

订阅更新

我的文档

设置

接入检测（

即可查看检测结果）

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

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

订单状态流转说明

订单状态流转图

订单状态说明

●

支持跨状态传递，如：upload_data (上传申报资料) 可直接跳转至 finished (已完成) 。

●

不要求首次同步订单状态必须为 upload_data (上传申报资料) 。

●

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

●

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

状态中文名	状态英文名	是否发送服务消息
上传申报资料	upload_data	否
资料审核	data_review	否
申报	declare	否
形式审查	formal_review	否
实质审查	substantive_review	否
商标复审	review_again	否
公告	notice	否
电子制证	electronic_certificate	否
纸质制证	paper_certificate	否
已关闭	closed	否
已退款	refunded	否
已完成	finished	否

注意：不同订单状态，仅是否发送服务消息为

是

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

状态机流转

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

当前状态	允许的后置状态
upload_data(上传申报资料)	closed/已关闭、 electronic_certificate/电子制证、 formal_review/形式审查、 finished/已完成、 refunded/已退款、 upload_data/上传申报资料、 substantive_review/实质审查、 notice/公告、 data_review/资料审核、 paper_certificate/纸质制证、 review_again/商标复审、 declare/申报
data_review(资料审核)	closed/已关闭、 electronic_certificate/电子制证、 formal_review/形式审查、 finished/已完成、 refunded/已退款、 substantive_review/实质审查、 notice/公告、 data_review/资料审核、 paper_certificate/纸质制证、 review_again/商标复审、 declare/申报
declare(申报)	closed/已关闭、 electronic_certificate/电子制证、 formal_review/形式审查、 finished/已完成、 refunded/已退款、 substantive_review/实质审查、 notice/公告、 paper_certificate/纸质制证、 review_again/商标复审、 declare/申报
formal_review(形式审查)	closed/已关闭、 electronic_certificate/电子制证、 formal_review/形式审查、 finished/已完成、 refunded/已退款、 substantive_review/实质审查、 notice/公告、 paper_certificate/纸质制证、 review_again/商标复审
substantive_review(实质审查)	closed/已关闭、 electronic_certificate/电子制证、 finished/已完成、 refunded/已退款、 substantive_review/实质审查、 notice/公告、 paper_certificate/纸质制证、 review_again/商标复审
review_again(商标复审)	closed/已关闭、 electronic_certificate/电子制证、 finished/已完成、 refunded/已退款、 notice/公告、 paper_certificate/纸质制证、 review_again/商标复审
notice(公告)	closed/已关闭、 electronic_certificate/电子制证、 finished/已完成、 refunded/已退款、 notice/公告、 paper_certificate/纸质制证
electronic_certificate(电子制证)	closed/已关闭、 electronic_certificate/电子制证、 finished/已完成、 refunded/已退款、 paper_certificate/纸质制证
paper_certificate(纸质制证)	closed/已关闭、 finished/已完成、 refunded/已退款、 paper_certificate/纸质制证
closed(已关闭)	closed/已关闭
refunded(已退款)	refunded/已退款
finished(已完成)	finished/已完成

不同状态参数使用说明

上传申报资料 (upload_data)

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

接口参数 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	是	是	否	订单状态, 例: upload_data
l ext_key	string	是	否	否	订单类型 key。固定为 merchant_biz_type。
l ext_value	string	是	否	否	订单类型 value。本业务场景为: patent_trademark
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。

商品信息列表

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

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
item_name	string	是	否	否	商品名称。建议商品名称格式为：{商家名称} {商品名称}
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	商品图片 value。需传入上传商品文件获取的 material_id
l ext_key	string	否	否	否	商品描述 key。固定为 goodsdesc。
l ext_value	string	否	否	否	商品描述 value。

资料审核 (data_review)

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

接口参数 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	是	是	否	订单状态, 例: data_review
l ext_key	string	是	否	否	订单类型 key。固定为 merchant_biz_type。
l ext_value	string	是	否	否	订单类型 value。本业务场景为: patent_trademark
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。

商品信息列表

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

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
item_name	string	是	否	否	商品名称。建议商品名称格式为：{商家名称} {商品名称}
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	商品图片 value。需传入上传商品文件获取的 material_id
l ext_key	string	否	否	否	商品描述 key。固定为 goodsdesc。
l ext_value	string	否	否	否	商品描述 value。

申报 (declare)

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

接口参数 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	是	是	否	订单状态, 例: declare
l ext_key	string	是	否	否	订单类型 key。固定为 merchant_biz_type。
l ext_value	string	是	否	否	订单类型 value。本业务场景为: patent_trademark
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。

商品信息列表

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

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
item_name	string	是	否	否	商品名称。建议商品名称格式为：{商家名称} {商品名称}
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	商品图片 value。需传入上传商品文件获取的 material_id
l ext_key	string	否	否	否	商品描述 key。固定为 goodsdesc。
l ext_value	string	否	否	否	商品描述 value。

形式审查 (formal_review)

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

接口参数 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	是	是	否	订单状态, 例: formal_review
l ext_key	string	是	否	否	订单类型 key。固定为 merchant_biz_type。
l ext_value	string	是	否	否	订单类型 value。本业务场景为: patent_trademark
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。

商品信息列表

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

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
item_name	string	是	否	否	商品名称。建议商品名称格式为：{商家名称} {商品名称}
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	商品图片 value。需传入上传商品文件获取的 material_id
l ext_key	string	否	否	否	商品描述 key。固定为 goodsdesc。
l ext_value	string	否	否	否	商品描述 value。

实质审查 (substantive_review)

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

接口参数 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	是	是	否	订单状态, 例: substantive_review
l ext_key	string	是	否	否	订单类型 key。固定为 merchant_biz_type。
l ext_value	string	是	否	否	订单类型 value。本业务场景为: patent_trademark
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。

商品信息列表

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

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
item_name	string	是	否	否	商品名称。建议商品名称格式为：{商家名称} {商品名称}
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	商品图片 value。需传入上传商品文件获取的 material_id
l ext_key	string	否	否	否	商品描述 key。固定为 goodsdesc。
l ext_value	string	否	否	否	商品描述 value。

商标复审 (review_again)

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

接口参数 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	是	是	否	订单状态, 例: review_again
l ext_key	string	是	否	否	订单类型 key。固定为 merchant_biz_type。
l ext_value	string	是	否	否	订单类型 value。本业务场景为: patent_trademark
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。

商品信息列表

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

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
item_name	string	是	否	否	商品名称。建议商品名称格式为：{商家名称} {商品名称}
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	商品图片 value。需传入上传商品文件获取的 material_id
l ext_key	string	否	否	否	商品描述 key。固定为 goodsdesc。
l ext_value	string	否	否	否	商品描述 value。

公告 (notice)

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

接口参数 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	是	是	否	订单状态, 例: notice
l ext_key	string	是	否	否	订单类型 key。固定为 merchant_biz_type。
l ext_value	string	是	否	否	订单类型 value。本业务场景为: patent_trademark
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。

商品信息列表

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

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
item_name	string	是	否	否	商品名称。建议商品名称格式为：{商家名称} {商品名称}
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	商品图片 value。需传入上传商品文件获取的 material_id
l ext_key	string	否	否	否	商品描述 key。固定为 goodsdesc。
l ext_value	string	否	否	否	商品描述 value。

电子制证 (electronic_certificate)

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

接口参数 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	是	是	否	订单状态, 例: electronic_certificate
l ext_key	string	是	否	否	订单类型 key。固定为 merchant_biz_type。
l ext_value	string	是	否	否	订单类型 value。本业务场景为: patent_trademark
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。

商品信息列表

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

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
item_name	string	是	否	否	商品名称。建议商品名称格式为：{商家名称} {商品名称}
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	商品图片 value。需传入上传商品文件获取的 material_id
l ext_key	string	否	否	否	商品描述 key。固定为 goodsdesc。
l ext_value	string	否	否	否	商品描述 value。

纸质制证 (paper_certificate)

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

接口参数 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	是	是	否	订单状态, 例: paper_certificate
l ext_key	string	是	否	否	订单类型 key。固定为 merchant_biz_type。
l ext_value	string	是	否	否	订单类型 value。本业务场景为: patent_trademark
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。

商品信息列表

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

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
item_name	string	是	否	否	商品名称。建议商品名称格式为：{商家名称} {商品名称}
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	商品图片 value。需传入上传商品文件获取的 material_id
l ext_key	string	否	否	否	商品描述 key。固定为 goodsdesc。
l ext_value	string	否	否	否	商品描述 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。本业务场景为: patent_trademark
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。

商品信息列表

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

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
item_name	string	是	否	否	商品名称。建议商品名称格式为：{商家名称} {商品名称}
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	商品图片 value。需传入上传商品文件获取的 material_id
l ext_key	string	否	否	否	商品描述 key。固定为 goodsdesc。
l ext_value	string	否	否	否	商品描述 value。

已退款 (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相同的两次同步会被幂等处理。
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	是	是	否	订单状态, 例: refunded
l ext_key	string	是	否	否	订单类型 key。固定为 merchant_biz_type。
l ext_value	string	是	否	否	订单类型 value。本业务场景为: patent_trademark
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。

商品信息列表

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

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
item_name	string	是	否	否	商品名称。建议商品名称格式为：{商家名称} {商品名称}
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	商品图片 value。需传入上传商品文件获取的 material_id
l ext_key	string	否	否	否	商品描述 key。固定为 goodsdesc。
l ext_value	string	否	否	否	商品描述 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。本业务场景为: patent_trademark
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。

商品信息列表

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

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
item_name	string	是	否	否	商品名称。建议商品名称格式为：{商家名称} {商品名称}
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	商品图片 value。需传入上传商品文件获取的 material_id
l ext_key	string	否	否	否	商品描述 key。固定为 goodsdesc。
l ext_value	string	否	否	否	商品描述 value。