珠宝回收（jewelry-凯发app官方网站

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

订阅更新

我的文档

设置

接入检测（

即可查看检测结果）

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

商家需通过 alipay.merchant.order.sync(订单数据同步接口) 订单扩展字段

ext_info#merchant_order_status

参数更新订单状态，具体状态说明如下。

订单状态流转说明

订单状态说明

●

支持跨状态传递，如：create (订单创建成功) 可直接跳转至 to_be_delivered (待到店) 。

●

不要求首次同步订单状态必须为 create (订单创建成功) 。

●

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

●

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

状态中文名	状态英文名	是否为有效订单核心状态	是否发送服务消息	是否发送push
订单创建成功	create	是	否	否
待商家确认	pending	否	否	否
待寄出	to_shipped	否	否	否
送往回收机构	to_institution	否	否	否
检测中	checking	否	否	否
待确认回收金额	amount_to_confirmed	否	是	否
待打款	payment_pending	否	否	否
打款失败	payment_failed	否	是	否
订单完成	finished	是	是	否
订单关闭	closed	否	否	否
待付运费	freight_to_be_paid	否	是	否
寄回中	sending_back	否	否	否
待收货	to_be_received	否	否	否
待到店	to_be_delivered	否	是	否

注意

：不同订单状态，仅

是否发送服务消息

为

是

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

状态机流转

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

当前状态	允许的后置状态
create(订单创建成功)	create/订单创建成功、 to_be_delivered/待到店、 closed/订单关闭、 pending/待商家确认、 to_shipped/待寄出
pending(待商家确认)	to_be_delivered/待到店、 closed/订单关闭、 pending/待商家确认、 to_shipped/待寄出
to_shipped(待寄出)	to_institution/送往回收机构、 closed/订单关闭、 to_shipped/待寄出
to_institution(送往回收机构)	to_institution/送往回收机构、 closed/订单关闭、 checking/检测中
checking(检测中)	closed/订单关闭、 amount_to_confirmed/待确认回收金额、 sending_back/寄回中、 checking/检测中
amount_to_confirmed(待确认回收金额)	closed/订单关闭、 freight_to_be_paid/待付运费、 amount_to_confirmed/待确认回收金额、 payment_pending/待打款、 sending_back/寄回中、 finished/订单完成
payment_pending(待打款)	payment_pending/待打款、 payment_failed/打款失败、 finished/订单完成
payment_failed(打款失败)	payment_pending/待打款、 payment_failed/打款失败、 finished/订单完成
finished(订单完成)	finished/订单完成
closed(订单关闭)	closed/订单关闭
freight_to_be_paid(待付运费)	closed/订单关闭、 freight_to_be_paid/待付运费、 sending_back/寄回中
sending_back(寄回中)	sending_back/寄回中、 to_be_received/待收货
to_be_received(待收货)	closed/订单关闭、 to_be_received/待收货
to_be_delivered(待到店)	to_be_delivered/待到店、 closed/订单关闭、 checking/检测中

不同状态参数使用说明

订单创建成功 (create)

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

接口参数 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:c100845251
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)	是	否	订单总金额：某笔交易订单优惠前的总金额，单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
pay_amount	price	选填，建议传入该参数	否	否	用户应付金额：用户最终结算时需要支付金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
discount_amount	price	否	否	否	商户总计优惠金额：代表商户侧给予用户的总计优惠金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】。
logistics_info_list	string	否	否	否
shop_info	ordershopinfo	否	否	否	门店信息。详见下文: 门店信息
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	是	是	否	订单状态, 例: create
l ext_key	string	是	否	否	订单类型 key。固定为 merchant_biz_type。
l ext_value	string	是	否	否	订单类型 value。本业务场景为: jewelry_recycling
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）的各项入参详情如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
nspection_results	string	否	否	否	商品质检结果
return_logistics_code	string	否	否	否	字段名称:退回承运物流公司 字段说明:退货承运物流公司
offline_recycling_id	string	否	否	否	线下回收到店码
jewelry_type	string	是	否	否	回收珠宝类型
return_logistics_phone_no	string	否	否	否	字段名称:退回收件人手机号后四位 字段说明:退货收件人手机号后四位
recycling_inspection_fee	string	否	否	否	回收检测费
inspection_report_url	string	否	否	否	质检报告url链接
estimated_recovery_amount	string	否	否	否	字段名称:预估回收价 字段说明:预估回收金额
insurance_fee	string	否	否	否	保价费
return_logistics_no	string	否	否	否	字段名称:退回物流单号 字段说明:退货物流单号
user_receiving_name	string	否	否	否	用户收款方式
reference_number	string	否	否	否	字段名称:支付宝打款单号 字段说明:202409019273946394729
weight_of_recyclable	string	否	否	否	回收克重
offline_appointment_time	string	否	否	否	线下回收预约时间
actual_ecovered_amount	string	否	否	否	实际回收价
identification_report_id	string	否	否	否	鉴定报告id
user_receiving_account	string	否	否	否	用户收款钱包账号

商品信息列表

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

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
item_name	string	是	否	否	商品名称。建议商品名称格式为：{商家名称} {商品名称}
quantity	number	是	否	否	商品数量。支持两位小数点。注意：与unit_price成对出现，若传了quantity，则需要将unit_price传入
sku_id	string	否	否	否	商家侧商品 sku id
unit_price	price	否	否	否	商品单价。精确到小数点后两位。单位为元注意：与quantity成对出现，若传了unit_price，则需要将quantity传入
unit	string	否	否	否	字段名称:商品规格 字段说明:份、件、斤、kg，默认为份
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	商品图片 value。需传入上传商品文件获取的 material_id

物流信息

若商家想在订单中展示物流信息，可通过物流信息（logistics_info_list）同步。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
phone_no	string	否	否	否	字段名称:手机号后四位 字段说明:当物流公司为顺丰时必传
logistics_code	string	否	否	否	字段名称:物流公司 字段说明:物流公司编码：详情查看
tracking_no	string	否	否	否	物流单号

门店信息

若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
address	string	否	否	否	门店地址
name	string	否	否	否	门店名称
phone_num	string	否	否	否	字段名称:门店凯发k8官方网娱乐官方的联系方式 字段说明:门店的凯发k8官方网娱乐官方的联系方式
ext_info	orderextinfo	是	否	否	扩展参数。该参数用于传入额外信息。
l ext_key	string	否	否	否	store_logo_url key,固定为 store_logo_url
l ext_value	string	否	否	否	store_logo_url value 字段说明:门店logo

待商家确认 (pending)

本文详细介绍通过接口

alipay.merchant.order.sync

同步订单状态-待商家确认 (pending)时需传入的商品信息及扩展字段参数信息。

接口参数 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:c100845251
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)	是	否	订单总金额：某笔交易订单优惠前的总金额，单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
pay_amount	price	选填，建议传入该参数	否	否	用户应付金额：用户最终结算时需要支付金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
discount_amount	price	否	否	否	商户总计优惠金额：代表商户侧给予用户的总计优惠金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】。
logistics_info_list	string	否	否	否
shop_info	ordershopinfo	否	否	否	门店信息。详见下文: 门店信息
item_order_list	itemorderinfo	是	否	否	商品信息列表。详见下文: 商品信息列表
ext_info	orderextinfo	是	是	否	订单扩展字段。详见下文订单扩展字段。

订单扩展字段

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
l ext_key	string	是	否	否	订单状态 key。固定为 merchant_order_status
l ext_value	string	是	是	否	订单状态, 例: pending
l ext_key	string	是	否	否	订单类型 key。固定为 merchant_biz_type。
l ext_value	string	是	否	否	订单类型 value。本业务场景为: jewelry_recycling
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）的各项入参详情如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
nspection_results	string	否	否	否	商品质检结果
offline_recycling_id	string	否	否	否	线下回收到店码
jewelry_type	string	是	否	否	回收珠宝类型
recycling_inspection_fee	string	是	否	否	回收检测费
inspection_report_url	string	否	否	否	质检报告url链接
estimated_recovery_amount	string	否	否	否	字段名称:预估回收价 字段说明:预估回收金额
insurance_fee	string	否	否	否	保价费
user_receiving_name	string	否	否	否	用户收款方式
offline_appointment_time	string	否	否	否	线下回收预约时间
identification_report_id	string	否	否	否	鉴定报告id
user_receiving_account	string	否	否	否	用户收款钱包账号

商品信息列表

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

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
item_name	string	是	否	否	商品名称。建议商品名称格式为：{商家名称} {商品名称}
quantity	number	是	否	否	商品数量。支持两位小数点。注意：与unit_price成对出现，若传了quantity，则需要将unit_price传入
sku_id	string	否	否	否	商家侧商品 sku id
unit_price	price	是	否	否	商品单价。精确到小数点后两位。单位为元注意：与quantity成对出现，若传了unit_price，则需要将quantity传入
unit	string	否	否	否	字段名称:商品规格 字段说明:份、件、斤、kg，默认为份
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	商品图片 value。需传入上传商品文件获取的 material_id

物流信息

若商家想在订单中展示物流信息，可通过物流信息（logistics_info_list）同步。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
phone_no	string	否	否	否	字段名称:手机号后四位 字段说明:当物流公司为顺丰时必传
logistics_code	string	否	否	否	字段名称:物流公司 字段说明:物流公司编码：详情查看
tracking_no	string	否	否	否	物流单号

门店信息

若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
address	string	否	否	否	门店地址
name	string	否	否	否	门店名称
phone_num	string	否	否	否	字段名称:门店凯发k8官方网娱乐官方的联系方式 字段说明:门店的凯发k8官方网娱乐官方的联系方式
ext_info	orderextinfo	是	否	否	扩展参数。该参数用于传入额外信息。
l ext_key	string	否	否	否	store_logo_url key,固定为 store_logo_url
l ext_value	string	否	否	否	store_logo_url value 字段说明:门店logo

待寄出 (to_shipped)

本文详细介绍通过接口

alipay.merchant.order.sync

同步订单状态-待寄出 (to_shipped)时需传入的商品信息及扩展字段参数信息。

接口参数 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:c100845251
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)	是	否	订单总金额：某笔交易订单优惠前的总金额，单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
pay_amount	price	选填，建议传入该参数	否	否	用户应付金额：用户最终结算时需要支付金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
discount_amount	price	否	否	否	商户总计优惠金额：代表商户侧给予用户的总计优惠金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】。
logistics_info_list	string	否	否	否
shop_info	ordershopinfo	否	否	否	门店信息。详见下文: 门店信息
item_order_list	itemorderinfo	是	否	否	商品信息列表。详见下文: 商品信息列表
ext_info	orderextinfo	是	是	否	订单扩展字段。详见下文订单扩展字段。

订单扩展字段

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
l ext_key	string	是	否	否	订单状态 key。固定为 merchant_order_status
l ext_value	string	是	是	否	订单状态, 例: to_shipped
l ext_key	string	是	否	否	订单类型 key。固定为 merchant_biz_type。
l ext_value	string	是	否	否	订单类型 value。本业务场景为: jewelry_recycling
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）的各项入参详情如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
nspection_results	string	否	否	否	商品质检结果
offline_recycling_id	string	否	否	否	线下回收到店码
jewelry_type	string	是	否	否	回收珠宝类型
recycling_inspection_fee	string	是	否	否	回收检测费
inspection_report_url	string	否	否	否	质检报告url链接
estimated_recovery_amount	string	否	否	否	字段名称:预估回收价 字段说明:预估回收金额
insurance_fee	string	否	否	否	保价费
user_receiving_name	string	否	否	否	用户收款方式
offline_appointment_time	string	否	否	否	线下回收预约时间
identification_report_id	string	否	否	否	鉴定报告id
user_receiving_account	string	否	否	否	用户收款钱包账号

商品信息列表

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

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
item_name	string	是	否	否	商品名称。建议商品名称格式为：{商家名称} {商品名称}
quantity	number	是	否	否	商品数量。支持两位小数点。注意：与unit_price成对出现，若传了quantity，则需要将unit_price传入
sku_id	string	否	否	否	商家侧商品 sku id
unit_price	price	是	否	否	商品单价。精确到小数点后两位。单位为元注意：与quantity成对出现，若传了unit_price，则需要将quantity传入
unit	string	否	否	否	字段名称:商品规格 字段说明:份、件、斤、kg，默认为份
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	商品图片 value。需传入上传商品文件获取的 material_id

物流信息

若商家想在订单中展示物流信息，可通过物流信息（logistics_info_list）同步。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
phone_no	string	否	否	否	字段名称:手机号后四位 字段说明:当物流公司为顺丰时必传
logistics_code	string	否	否	否	字段名称:物流公司 字段说明:物流公司编码：详情查看
tracking_no	string	否	否	否	物流单号

门店信息

若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
address	string	否	否	否	门店地址
name	string	否	否	否	门店名称
phone_num	string	否	否	否	字段名称:门店凯发k8官方网娱乐官方的联系方式 字段说明:门店的凯发k8官方网娱乐官方的联系方式
ext_info	orderextinfo	是	否	否	扩展参数。该参数用于传入额外信息。
l ext_key	string	否	否	否	store_logo_url key,固定为 store_logo_url
l ext_value	string	否	否	否	store_logo_url value 字段说明:门店logo

送往回收机构 (to_institution)

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

接口参数 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:c100845251
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)	是	否	订单总金额：某笔交易订单优惠前的总金额，单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
pay_amount	price	选填，建议传入该参数	否	否	用户应付金额：用户最终结算时需要支付金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
discount_amount	price	否	否	否	商户总计优惠金额：代表商户侧给予用户的总计优惠金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】。
logistics_info_list	string	否	否	否
shop_info	ordershopinfo	否	否	否	门店信息。详见下文: 门店信息
item_order_list	itemorderinfo	是	否	否	商品信息列表。详见下文: 商品信息列表
ext_info	orderextinfo	是	是	否	订单扩展字段。详见下文订单扩展字段。

订单扩展字段

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
l ext_key	string	是	否	否	订单状态 key。固定为 merchant_order_status
l ext_value	string	是	是	否	订单状态, 例: to_institution
l ext_key	string	是	否	否	订单类型 key。固定为 merchant_biz_type。
l ext_value	string	是	否	否	订单类型 value。本业务场景为: jewelry_recycling
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）的各项入参详情如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
nspection_results	string	否	否	否	商品质检结果
offline_recycling_id	string	否	否	否	线下回收到店码
jewelry_type	string	是	否	否	回收珠宝类型
recycling_inspection_fee	string	是	否	否	回收检测费
inspection_report_url	string	否	否	否	质检报告url链接
estimated_recovery_amount	string	否	否	否	字段名称:预估回收价 字段说明:预估回收金额
insurance_fee	string	否	否	否	保价费
user_receiving_name	string	否	否	否	用户收款方式
offline_appointment_time	string	否	否	否	线下回收预约时间
identification_report_id	string	否	否	否	鉴定报告id
user_receiving_account	string	否	否	否	用户收款钱包账号

商品信息列表

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

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
item_name	string	是	否	否	商品名称。建议商品名称格式为：{商家名称} {商品名称}
quantity	number	是	否	否	商品数量。支持两位小数点。注意：与unit_price成对出现，若传了quantity，则需要将unit_price传入
sku_id	string	否	否	否	商家侧商品 sku id
unit_price	price	是	否	否	商品单价。精确到小数点后两位。单位为元注意：与quantity成对出现，若传了unit_price，则需要将quantity传入
unit	string	否	否	否	字段名称:商品规格 字段说明:份、件、斤、kg，默认为份
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	商品图片 value。需传入上传商品文件获取的 material_id

物流信息

若商家想在订单中展示物流信息，可通过物流信息（logistics_info_list）同步。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
phone_no	string	否	否	否	字段名称:手机号后四位 字段说明:当物流公司为顺丰时必传
logistics_code	string	否	否	否	字段名称:物流公司 字段说明:物流公司编码：详情查看
tracking_no	string	否	否	否	物流单号

门店信息

若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
address	string	否	否	否	门店地址
name	string	否	否	否	门店名称
phone_num	string	否	否	否	字段名称:门店凯发k8官方网娱乐官方的联系方式 字段说明:门店的凯发k8官方网娱乐官方的联系方式
ext_info	orderextinfo	是	否	否	扩展参数。该参数用于传入额外信息。
l ext_key	string	否	否	否	store_logo_url key,固定为 store_logo_url
l ext_value	string	否	否	否	store_logo_url value 字段说明:门店logo

检测中 (checking)

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

接口参数 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:c100845251
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)	是	否	订单总金额：某笔交易订单优惠前的总金额，单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
pay_amount	price	选填，建议传入该参数	否	否	用户应付金额：用户最终结算时需要支付金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
discount_amount	price	否	否	否	商户总计优惠金额：代表商户侧给予用户的总计优惠金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】。
logistics_info_list	string	否	否	否
shop_info	ordershopinfo	否	否	否	门店信息。详见下文: 门店信息
item_order_list	itemorderinfo	是	否	否	商品信息列表。详见下文: 商品信息列表
ext_info	orderextinfo	是	是	否	订单扩展字段。详见下文订单扩展字段。

订单扩展字段

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
l ext_key	string	是	否	否	订单状态 key。固定为 merchant_order_status
l ext_value	string	是	是	否	订单状态, 例: checking
l ext_key	string	是	否	否	订单类型 key。固定为 merchant_biz_type。
l ext_value	string	是	否	否	订单类型 value。本业务场景为: jewelry_recycling
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）的各项入参详情如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
nspection_results	string	否	否	否	商品质检结果
offline_recycling_id	string	否	否	否	线下回收到店码
jewelry_type	string	是	否	否	回收珠宝类型
recycling_inspection_fee	string	是	否	否	回收检测费
inspection_report_url	string	否	否	否	质检报告url链接
estimated_recovery_amount	string	否	否	否	字段名称:预估回收价 字段说明:预估回收金额
insurance_fee	string	否	否	否	保价费
user_receiving_name	string	否	否	否	用户收款方式
offline_appointment_time	string	否	否	否	线下回收预约时间
identification_report_id	string	否	否	否	鉴定报告id
user_receiving_account	string	否	否	否	用户收款钱包账号

商品信息列表

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

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
item_name	string	是	否	否	商品名称。建议商品名称格式为：{商家名称} {商品名称}
quantity	number	是	否	否	商品数量。支持两位小数点。注意：与unit_price成对出现，若传了quantity，则需要将unit_price传入
sku_id	string	否	否	否	商家侧商品 sku id
unit_price	price	是	否	否	商品单价。精确到小数点后两位。单位为元注意：与quantity成对出现，若传了unit_price，则需要将quantity传入
unit	string	否	否	否	字段名称:商品规格 字段说明:份、件、斤、kg，默认为份
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	商品图片 value。需传入上传商品文件获取的 material_id

物流信息

若商家想在订单中展示物流信息，可通过物流信息（logistics_info_list）同步。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
phone_no	string	否	否	否	字段名称:手机号后四位 字段说明:当物流公司为顺丰时必传
logistics_code	string	否	否	否	字段名称:物流公司 字段说明:物流公司编码：详情查看
tracking_no	string	否	否	否	物流单号

门店信息

若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
address	string	否	否	否	门店地址
name	string	否	否	否	门店名称
phone_num	string	否	否	否	字段名称:门店凯发k8官方网娱乐官方的联系方式 字段说明:门店的凯发k8官方网娱乐官方的联系方式
ext_info	orderextinfo	是	否	否	扩展参数。该参数用于传入额外信息。
l ext_key	string	否	否	否	store_logo_url key,固定为 store_logo_url
l ext_value	string	否	否	否	store_logo_url value 字段说明:门店logo

待确认回收金额 (amount_to_confirmed)

本文详细介绍通过接口

alipay.merchant.order.sync

同步订单状态-待确认回收金额 (amount_to_confirmed)时需传入的商品信息及扩展字段参数信息。

接口参数 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:c100845251
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)	是	否	订单总金额：某笔交易订单优惠前的总金额，单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
pay_amount	price	选填，建议传入该参数	否	否	用户应付金额：用户最终结算时需要支付金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
discount_amount	price	否	否	否	商户总计优惠金额：代表商户侧给予用户的总计优惠金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】。
logistics_info_list	string	否	否	否
shop_info	ordershopinfo	否	否	否	门店信息。详见下文: 门店信息
item_order_list	itemorderinfo	是	否	否	商品信息列表。详见下文: 商品信息列表
ext_info	orderextinfo	是	是	否	订单扩展字段。详见下文订单扩展字段。

订单扩展字段

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
l ext_key	string	是	否	否	订单状态 key。固定为 merchant_order_status
l ext_value	string	是	是	否	订单状态, 例: amount_to_confirmed
l ext_key	string	是	否	否	订单类型 key。固定为 merchant_biz_type。
l ext_value	string	是	否	否	订单类型 value。本业务场景为: jewelry_recycling
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）的各项入参详情如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
nspection_results	string	否	否	否	商品质检结果
offline_recycling_id	string	否	否	否	线下回收到店码
jewelry_type	string	是	否	否	回收珠宝类型
recycling_inspection_fee	string	是	否	否	回收检测费
inspection_report_url	string	否	否	否	质检报告url链接
wyf_recharge_amount	string	否	否	否	无忧付充值金额
estimated_recovery_amount	string	否	否	否	字段名称:预估回收价 字段说明:预估回收金额
wyf_order_identifier	string	否	否	否	字段名称:无忧付订单标识 字段说明:标识是否无忧付订单
insurance_fee	string	否	否	否	保价费
user_receiving_name	string	否	否	否	用户收款方式
offline_appointment_time	string	否	否	否	线下回收预约时间
actual_ecovered_amount	string	否	否	是	实际回收价
identification_report_id	string	否	否	否	鉴定报告id
user_receiving_account	string	否	否	否	用户收款钱包账号

商品信息列表

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

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
item_name	string	是	否	否	商品名称。建议商品名称格式为：{商家名称} {商品名称}
quantity	number	是	否	否	商品数量。支持两位小数点。注意：与unit_price成对出现，若传了quantity，则需要将unit_price传入
sku_id	string	否	否	否	商家侧商品 sku id
unit_price	price	是	否	否	商品单价。精确到小数点后两位。单位为元注意：与quantity成对出现，若传了unit_price，则需要将quantity传入
unit	string	否	否	否	字段名称:商品规格 字段说明:份、件、斤、kg，默认为份
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	商品图片 value。需传入上传商品文件获取的 material_id

物流信息

若商家想在订单中展示物流信息，可通过物流信息（logistics_info_list）同步。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
phone_no	string	否	否	否	字段名称:手机号后四位 字段说明:当物流公司为顺丰时必传
logistics_code	string	否	否	否	字段名称:物流公司 字段说明:物流公司编码：详情查看
tracking_no	string	否	否	否	物流单号

门店信息

若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
address	string	否	否	否	门店地址
name	string	否	否	否	门店名称
phone_num	string	否	否	否	字段名称:门店凯发k8官方网娱乐官方的联系方式 字段说明:门店的凯发k8官方网娱乐官方的联系方式
ext_info	orderextinfo	是	否	否	扩展参数。该参数用于传入额外信息。
l ext_key	string	否	否	否	store_logo_url key,固定为 store_logo_url
l ext_value	string	否	否	否	store_logo_url value 字段说明:门店logo

待打款 (payment_pending)

本文详细介绍通过接口

alipay.merchant.order.sync

同步订单状态-待打款 (payment_pending)时需传入的商品信息及扩展字段参数信息。

接口参数 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:c100845251
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)	是	否	订单总金额：某笔交易订单优惠前的总金额，单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
pay_amount	price	选填，建议传入该参数	否	否	用户应付金额：用户最终结算时需要支付金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
discount_amount	price	否	否	否	商户总计优惠金额：代表商户侧给予用户的总计优惠金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】。
logistics_info_list	string	否	否	否
shop_info	ordershopinfo	否	否	否	门店信息。详见下文: 门店信息
item_order_list	itemorderinfo	是	否	否	商品信息列表。详见下文: 商品信息列表
ext_info	orderextinfo	是	是	否	订单扩展字段。详见下文订单扩展字段。

订单扩展字段

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
l ext_key	string	是	否	否	订单状态 key。固定为 merchant_order_status
l ext_value	string	是	是	否	订单状态, 例: payment_pending
l ext_key	string	是	否	否	订单类型 key。固定为 merchant_biz_type。
l ext_value	string	是	否	否	订单类型 value。本业务场景为: jewelry_recycling
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）的各项入参详情如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
nspection_results	string	否	否	否	商品质检结果
offline_recycling_id	string	否	否	否	线下回收到店码
jewelry_type	string	是	否	否	回收珠宝类型
recycling_inspection_fee	string	是	否	否	回收检测费
inspection_report_url	string	否	否	否	质检报告url链接
wyf_recharge_amount	string	否	否	否	无忧付充值金额
estimated_recovery_amount	string	否	否	否	字段名称:预估回收价 字段说明:预估回收金额
wyf_order_identifier	string	否	否	否	字段名称:无忧付订单标识 字段说明:标识是否无忧付订单
insurance_fee	string	否	否	否	保价费
user_receiving_name	string	否	否	否	用户收款方式
offline_appointment_time	string	否	否	否	线下回收预约时间
actual_ecovered_amount	string	否	否	否	实际回收价
identification_report_id	string	否	否	否	鉴定报告id
warm_reminder	string	否	否	否	字段名称:温馨提示 字段说明:用户引导说明文案
user_receiving_account	string	否	否	否	用户收款钱包账号

商品信息列表

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

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
item_name	string	是	否	否	商品名称。建议商品名称格式为：{商家名称} {商品名称}
quantity	number	是	否	否	商品数量。支持两位小数点。注意：与unit_price成对出现，若传了quantity，则需要将unit_price传入
sku_id	string	否	否	否	商家侧商品 sku id
unit_price	price	是	否	否	商品单价。精确到小数点后两位。单位为元注意：与quantity成对出现，若传了unit_price，则需要将quantity传入
unit	string	否	否	否	字段名称:商品规格 字段说明:份、件、斤、kg，默认为份
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	商品图片 value。需传入上传商品文件获取的 material_id

物流信息

若商家想在订单中展示物流信息，可通过物流信息（logistics_info_list）同步。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
phone_no	string	否	否	否	字段名称:手机号后四位 字段说明:当物流公司为顺丰时必传
logistics_code	string	否	否	否	字段名称:物流公司 字段说明:物流公司编码：详情查看
tracking_no	string	否	否	否	物流单号

门店信息

若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
address	string	否	否	否	门店地址
name	string	否	否	否	门店名称
phone_num	string	否	否	否	字段名称:门店凯发k8官方网娱乐官方的联系方式 字段说明:门店的凯发k8官方网娱乐官方的联系方式
ext_info	orderextinfo	是	否	否	扩展参数。该参数用于传入额外信息。
l ext_key	string	否	否	否	store_logo_url key,固定为 store_logo_url
l ext_value	string	否	否	否	store_logo_url value 字段说明:门店logo

打款失败 (payment_failed)

本文详细介绍通过接口

alipay.merchant.order.sync

同步订单状态-打款失败 (payment_failed)时需传入的商品信息及扩展字段参数信息。

接口参数 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:c100845251
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)	是	否	订单总金额：某笔交易订单优惠前的总金额，单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
pay_amount	price	选填，建议传入该参数	否	否	用户应付金额：用户最终结算时需要支付金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
discount_amount	price	否	否	否	商户总计优惠金额：代表商户侧给予用户的总计优惠金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】。
logistics_info_list	string	否	否	否
shop_info	ordershopinfo	否	否	否	门店信息。详见下文: 门店信息
item_order_list	itemorderinfo	是	否	否	商品信息列表。详见下文: 商品信息列表
ext_info	orderextinfo	是	是	否	订单扩展字段。详见下文订单扩展字段。

订单扩展字段

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
l ext_key	string	是	否	否	订单状态 key。固定为 merchant_order_status
l ext_value	string	是	是	否	订单状态, 例: payment_failed
l ext_key	string	是	否	否	订单类型 key。固定为 merchant_biz_type。
l ext_value	string	是	否	否	订单类型 value。本业务场景为: jewelry_recycling
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）的各项入参详情如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
nspection_results	string	否	否	否	商品质检结果
offline_recycling_id	string	否	否	否	线下回收到店码
jewelry_type	string	是	否	否	回收珠宝类型
recycling_inspection_fee	string	是	否	否	回收检测费
inspection_report_url	string	否	否	否	质检报告url链接
wyf_recharge_amount	string	否	否	否	无忧付充值金额
estimated_recovery_amount	string	否	否	否	字段名称:预估回收价 字段说明:预估回收金额
wyf_order_identifier	string	否	否	否	字段名称:无忧付订单标识 字段说明:标识是否无忧付订单
insurance_fee	string	否	否	否	保价费
user_receiving_name	string	否	否	否	用户收款方式
offline_appointment_time	string	否	否	否	线下回收预约时间
actual_ecovered_amount	string	否	否	是	实际回收价
identification_report_id	string	否	否	否	鉴定报告id
warm_reminder	string	否	否	是	字段名称:温馨提示 字段说明:用户引导说明文案
user_receiving_account	string	否	否	否	用户收款钱包账号

商品信息列表

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

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
item_name	string	是	否	否	商品名称。建议商品名称格式为：{商家名称} {商品名称}
quantity	number	是	否	否	商品数量。支持两位小数点。注意：与unit_price成对出现，若传了quantity，则需要将unit_price传入
sku_id	string	否	否	否	商家侧商品 sku id
unit_price	price	是	否	否	商品单价。精确到小数点后两位。单位为元注意：与quantity成对出现，若传了unit_price，则需要将quantity传入
unit	string	否	否	否	字段名称:商品规格 字段说明:份、件、斤、kg，默认为份
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	商品图片 value。需传入上传商品文件获取的 material_id

物流信息

若商家想在订单中展示物流信息，可通过物流信息（logistics_info_list）同步。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
phone_no	string	否	否	否	字段名称:手机号后四位 字段说明:当物流公司为顺丰时必传
logistics_code	string	否	否	否	字段名称:物流公司 字段说明:物流公司编码：详情查看
tracking_no	string	否	否	否	物流单号

门店信息

若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
address	string	否	否	否	门店地址
name	string	否	否	否	门店名称
phone_num	string	否	否	否	字段名称:门店凯发k8官方网娱乐官方的联系方式 字段说明:门店的凯发k8官方网娱乐官方的联系方式
ext_info	orderextinfo	是	否	否	扩展参数。该参数用于传入额外信息。
l ext_key	string	否	否	否	store_logo_url key,固定为 store_logo_url
l ext_value	string	否	否	否	store_logo_url value 字段说明:门店logo

订单完成 (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相同的两次同步会被幂等处理。
category_id	string	否	否	否	支付宝标准服务类目code,本模板支持类目code:c100845251
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)	是	否	订单总金额：某笔交易订单优惠前的总金额，单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
pay_amount	price	选填，建议传入该参数	否	否	用户应付金额：用户最终结算时需要支付金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
discount_amount	price	否	否	否	商户总计优惠金额：代表商户侧给予用户的总计优惠金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】。
logistics_info_list	string	否	否	否
shop_info	ordershopinfo	否	否	否	门店信息。详见下文: 门店信息
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。本业务场景为: jewelry_recycling
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）的各项入参详情如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
nspection_results	string	否	否	否	商品质检结果
offline_recycling_id	string	否	否	否	线下回收到店码
jewelry_type	string	是	否	否	回收珠宝类型
recycling_inspection_fee	string	是	否	否	回收检测费
inspection_report_url	string	否	否	否	质检报告url链接
wyf_recharge_amount	string	否	否	否	无忧付充值金额
estimated_recovery_amount	string	否	否	否	字段名称:预估回收价 字段说明:预估回收金额
wyf_order_identifier	string	否	否	否	字段名称:无忧付订单标识 字段说明:标识是否无忧付订单
insurance_fee	string	否	否	否	保价费
user_receiving_name	string	否	否	否	用户收款方式
reference_number	string	否	否	否	字段名称:支付宝打款单号 字段说明:202409019273946394729
offline_appointment_time	string	否	否	否	线下回收预约时间
actual_ecovered_amount	string	否	否	是	实际回收价
identification_report_id	string	否	否	否	鉴定报告id
warm_reminder	string	否	否	否	字段名称:温馨提示 字段说明:用户引导说明文案
user_receiving_account	string	否	否	否	用户收款钱包账号

商品信息列表

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

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
item_name	string	是	否	否	商品名称。建议商品名称格式为：{商家名称} {商品名称}
quantity	number	是	否	否	商品数量。支持两位小数点。注意：与unit_price成对出现，若传了quantity，则需要将unit_price传入
sku_id	string	否	否	否	商家侧商品 sku id
unit_price	price	是	否	否	商品单价。精确到小数点后两位。单位为元注意：与quantity成对出现，若传了unit_price，则需要将quantity传入
unit	string	否	否	否	字段名称:商品规格 字段说明:份、件、斤、kg，默认为份
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	商品图片 value。需传入上传商品文件获取的 material_id

物流信息

若商家想在订单中展示物流信息，可通过物流信息（logistics_info_list）同步。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
phone_no	string	否	否	否	字段名称:手机号后四位 字段说明:当物流公司为顺丰时必传
logistics_code	string	否	否	否	字段名称:物流公司 字段说明:物流公司编码：详情查看
tracking_no	string	否	否	否	物流单号

门店信息

若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
address	string	否	否	否	门店地址
name	string	否	否	否	门店名称
phone_num	string	否	否	否	字段名称:门店凯发k8官方网娱乐官方的联系方式 字段说明:门店的凯发k8官方网娱乐官方的联系方式
ext_info	orderextinfo	是	否	否	扩展参数。该参数用于传入额外信息。
l ext_key	string	否	否	否	store_logo_url key,固定为 store_logo_url
l ext_value	string	否	否	否	store_logo_url value 字段说明:门店logo

订单关闭 (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相同的两次同步会被幂等处理。
category_id	string	否	否	否	支付宝标准服务类目code,本模板支持类目code:c100845251
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)	是	否	订单总金额：某笔交易订单优惠前的总金额，单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
pay_amount	price	选填，建议传入该参数	否	否	用户应付金额：用户最终结算时需要支付金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
discount_amount	price	否	否	否	商户总计优惠金额：代表商户侧给予用户的总计优惠金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】。
logistics_info_list	string	否	否	否
shop_info	ordershopinfo	否	否	否	门店信息。详见下文: 门店信息
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。本业务场景为: jewelry_recycling
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）的各项入参详情如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
nspection_results	string	否	否	否	商品质检结果
offline_recycling_id	string	否	否	否	线下回收到店码
jewelry_type	string	是	否	否	回收珠宝类型
recycling_inspection_fee	string	是	否	否	回收检测费
inspection_report_url	string	否	否	否	质检报告url链接
wyf_recharge_amount	string	否	否	否	无忧付充值金额
estimated_recovery_amount	string	否	否	否	字段名称:预估回收价 字段说明:预估回收金额
wyf_order_identifier	string	否	否	否	字段名称:无忧付订单标识 字段说明:标识是否无忧付订单
insurance_fee	string	否	否	否	保价费
user_receiving_name	string	否	否	否	用户收款方式
offline_appointment_time	string	否	否	否	线下回收预约时间
actual_ecovered_amount	string	否	否	否	实际回收价
identification_report_id	string	否	否	否	鉴定报告id
warm_reminder	string	否	否	否	字段名称:温馨提示 字段说明:用户引导说明文案
user_receiving_account	string	否	否	否	用户收款钱包账号

商品信息列表

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

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
item_name	string	是	否	否	商品名称。建议商品名称格式为：{商家名称} {商品名称}
quantity	number	是	否	否	商品数量。支持两位小数点。注意：与unit_price成对出现，若传了quantity，则需要将unit_price传入
sku_id	string	否	否	否	商家侧商品 sku id
unit_price	price	是	否	否	商品单价。精确到小数点后两位。单位为元注意：与quantity成对出现，若传了unit_price，则需要将quantity传入
unit	string	否	否	否	字段名称:商品规格 字段说明:份、件、斤、kg，默认为份
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	商品图片 value。需传入上传商品文件获取的 material_id

物流信息

若商家想在订单中展示物流信息，可通过物流信息（logistics_info_list）同步。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
phone_no	string	否	否	否	字段名称:手机号后四位 字段说明:当物流公司为顺丰时必传
logistics_code	string	否	否	否	字段名称:物流公司 字段说明:物流公司编码：详情查看
tracking_no	string	否	否	否	物流单号

门店信息

若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
address	string	否	否	否	门店地址
name	string	否	否	否	门店名称
phone_num	string	否	否	否	字段名称:门店凯发k8官方网娱乐官方的联系方式 字段说明:门店的凯发k8官方网娱乐官方的联系方式
ext_info	orderextinfo	是	否	否	扩展参数。该参数用于传入额外信息。
l ext_key	string	否	否	否	store_logo_url key,固定为 store_logo_url
l ext_value	string	否	否	否	store_logo_url value 字段说明:门店logo

待付运费 (freight_to_be_paid)

本文详细介绍通过接口

alipay.merchant.order.sync

同步订单状态-待付运费 (freight_to_be_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:c100845251
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)	是	否	订单总金额：某笔交易订单优惠前的总金额，单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
pay_amount	price	选填，建议传入该参数	否	否	用户应付金额：用户最终结算时需要支付金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
discount_amount	price	否	否	否	商户总计优惠金额：代表商户侧给予用户的总计优惠金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】。
logistics_info_list	string	否	否	否
shop_info	ordershopinfo	否	否	否	门店信息。详见下文: 门店信息
item_order_list	itemorderinfo	是	否	否	商品信息列表。详见下文: 商品信息列表
ext_info	orderextinfo	是	是	否	订单扩展字段。详见下文订单扩展字段。

订单扩展字段

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
l ext_key	string	是	否	否	订单状态 key。固定为 merchant_order_status
l ext_value	string	是	是	否	订单状态, 例: freight_to_be_paid
l ext_key	string	是	否	否	订单类型 key。固定为 merchant_biz_type。
l ext_value	string	是	否	否	订单类型 value。本业务场景为: jewelry_recycling
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）的各项入参详情如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
nspection_results	string	否	否	否	商品质检结果
offline_recycling_id	string	否	否	否	线下回收到店码
jewelry_type	string	是	否	是	回收珠宝类型
recycling_inspection_fee	string	是	否	否	回收检测费
inspection_report_url	string	否	否	否	质检报告url链接
wyf_recharge_amount	string	否	否	否	无忧付充值金额
estimated_recovery_amount	string	否	否	否	字段名称:预估回收价 字段说明:预估回收金额
wyf_order_identifier	string	否	否	否	字段名称:无忧付订单标识 字段说明:标识是否无忧付订单
insurance_fee	string	否	否	否	保价费
user_receiving_name	string	否	否	否	用户收款方式
reference_number	string	否	否	否	字段名称:支付宝打款单号 字段说明:202409019273946394729
offline_appointment_time	string	否	否	否	线下回收预约时间
actual_ecovered_amount	string	否	否	否	实际回收价
identification_report_id	string	否	否	否	鉴定报告id
warm_reminder	string	否	否	否	字段名称:温馨提示 字段说明:用户引导说明文案
user_receiving_account	string	否	否	否	用户收款钱包账号

商品信息列表

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

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
item_name	string	是	否	否	商品名称。建议商品名称格式为：{商家名称} {商品名称}
quantity	number	是	否	否	商品数量。支持两位小数点。注意：与unit_price成对出现，若传了quantity，则需要将unit_price传入
sku_id	string	否	否	否	商家侧商品 sku id
unit_price	price	是	否	否	商品单价。精确到小数点后两位。单位为元注意：与quantity成对出现，若传了unit_price，则需要将quantity传入
unit	string	否	否	否	字段名称:商品规格 字段说明:份、件、斤、kg，默认为份
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	商品图片 value。需传入上传商品文件获取的 material_id

物流信息

若商家想在订单中展示物流信息，可通过物流信息（logistics_info_list）同步。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
phone_no	string	否	否	否	字段名称:手机号后四位 字段说明:当物流公司为顺丰时必传
logistics_code	string	否	否	否	字段名称:物流公司 字段说明:物流公司编码：详情查看
tracking_no	string	否	否	否	物流单号

门店信息

若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
address	string	否	否	否	门店地址
name	string	否	否	否	门店名称
phone_num	string	否	否	否	字段名称:门店凯发k8官方网娱乐官方的联系方式 字段说明:门店的凯发k8官方网娱乐官方的联系方式
ext_info	orderextinfo	是	否	否	扩展参数。该参数用于传入额外信息。
l ext_key	string	否	否	否	store_logo_url key,固定为 store_logo_url
l ext_value	string	否	否	否	store_logo_url value 字段说明:门店logo

寄回中 (sending_back)

本文详细介绍通过接口

alipay.merchant.order.sync

同步订单状态-寄回中 (sending_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:c100845251
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)	是	否	订单总金额：某笔交易订单优惠前的总金额，单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
pay_amount	price	选填，建议传入该参数	否	否	用户应付金额：用户最终结算时需要支付金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
discount_amount	price	否	否	否	商户总计优惠金额：代表商户侧给予用户的总计优惠金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】。
logistics_info_list	string	否	否	否
shop_info	ordershopinfo	否	否	否	门店信息。详见下文: 门店信息
item_order_list	itemorderinfo	是	否	否	商品信息列表。详见下文: 商品信息列表
ext_info	orderextinfo	是	是	否	订单扩展字段。详见下文订单扩展字段。

订单扩展字段

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
l ext_key	string	是	否	否	订单状态 key。固定为 merchant_order_status
l ext_value	string	是	是	否	订单状态, 例: sending_back
l ext_key	string	是	否	否	订单类型 key。固定为 merchant_biz_type。
l ext_value	string	是	否	否	订单类型 value。本业务场景为: jewelry_recycling
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）的各项入参详情如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
nspection_results	string	否	否	否	商品质检结果
return_logistics_code	string	否	否	否	字段名称:退回承运物流公司 字段说明:退货承运物流公司
offline_recycling_id	string	否	否	否	线下回收到店码
jewelry_type	string	是	否	否	回收珠宝类型
return_logistics_phone_no	string	否	否	否	字段名称:退回收件人手机号后四位 字段说明:退货收件人手机号后四位
recycling_inspection_fee	string	是	否	否	回收检测费
inspection_report_url	string	否	否	否	质检报告url链接
wyf_recharge_amount	string	否	否	否	无忧付充值金额
estimated_recovery_amount	string	否	否	否	字段名称:预估回收价 字段说明:预估回收金额
wyf_order_identifier	string	否	否	否	字段名称:无忧付订单标识 字段说明:标识是否无忧付订单
insurance_fee	string	否	否	否	保价费
return_logistics_no	string	否	否	否	字段名称:退回物流单号 字段说明:退货物流单号
user_receiving_name	string	否	否	否	用户收款方式
reference_number	string	否	否	否	字段名称:支付宝打款单号 字段说明:202409019273946394729
offline_appointment_time	string	否	否	否	线下回收预约时间
actual_ecovered_amount	string	否	否	否	实际回收价
identification_report_id	string	否	否	否	鉴定报告id
warm_reminder	string	否	否	否	字段名称:温馨提示 字段说明:用户引导说明文案
user_receiving_account	string	否	否	否	用户收款钱包账号

商品信息列表

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

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
item_name	string	是	否	否	商品名称。建议商品名称格式为：{商家名称} {商品名称}
quantity	number	是	否	否	商品数量。支持两位小数点。注意：与unit_price成对出现，若传了quantity，则需要将unit_price传入
sku_id	string	否	否	否	商家侧商品 sku id
unit_price	price	是	否	否	商品单价。精确到小数点后两位。单位为元注意：与quantity成对出现，若传了unit_price，则需要将quantity传入
unit	string	否	否	否	字段名称:商品规格 字段说明:份、件、斤、kg，默认为份
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	商品图片 value。需传入上传商品文件获取的 material_id

物流信息

若商家想在订单中展示物流信息，可通过物流信息（logistics_info_list）同步。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
phone_no	string	否	否	否	字段名称:手机号后四位 字段说明:当物流公司为顺丰时必传
logistics_code	string	否	否	否	字段名称:物流公司 字段说明:物流公司编码：详情查看
tracking_no	string	否	否	否	物流单号

门店信息

若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
address	string	否	否	否	门店地址
name	string	否	否	否	门店名称
phone_num	string	否	否	否	字段名称:门店凯发k8官方网娱乐官方的联系方式 字段说明:门店的凯发k8官方网娱乐官方的联系方式
ext_info	orderextinfo	是	否	否	扩展参数。该参数用于传入额外信息。
l ext_key	string	否	否	否	store_logo_url key,固定为 store_logo_url
l ext_value	string	否	否	否	store_logo_url value 字段说明:门店logo

待收货 (to_be_received)

本文详细介绍通过接口

alipay.merchant.order.sync

同步订单状态-待收货 (to_be_received)时需传入的商品信息及扩展字段参数信息。

接口参数 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:c100845251
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)	是	否	订单总金额：某笔交易订单优惠前的总金额，单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
pay_amount	price	选填，建议传入该参数	否	否	用户应付金额：用户最终结算时需要支付金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
discount_amount	price	否	否	否	商户总计优惠金额：代表商户侧给予用户的总计优惠金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】。
logistics_info_list	string	否	否	否
shop_info	ordershopinfo	否	否	否	门店信息。详见下文: 门店信息
item_order_list	itemorderinfo	是	否	否	商品信息列表。详见下文: 商品信息列表
ext_info	orderextinfo	是	是	否	订单扩展字段。详见下文订单扩展字段。

订单扩展字段

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
l ext_key	string	是	否	否	订单状态 key。固定为 merchant_order_status
l ext_value	string	是	是	否	订单状态, 例: to_be_received
l ext_key	string	是	否	否	订单类型 key。固定为 merchant_biz_type。
l ext_value	string	是	否	否	订单类型 value。本业务场景为: jewelry_recycling
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）的各项入参详情如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
nspection_results	string	否	否	否	商品质检结果
return_logistics_code	string	否	否	否	字段名称:退回承运物流公司 字段说明:退货承运物流公司
offline_recycling_id	string	否	否	否	线下回收到店码
jewelry_type	string	是	否	否	回收珠宝类型
return_logistics_phone_no	string	否	否	否	字段名称:退回收件人手机号后四位 字段说明:退货收件人手机号后四位
recycling_inspection_fee	string	是	否	否	回收检测费
inspection_report_url	string	否	否	否	质检报告url链接
wyf_recharge_amount	string	否	否	否	无忧付充值金额
estimated_recovery_amount	string	否	否	否	字段名称:预估回收价 字段说明:预估回收金额
wyf_order_identifier	string	否	否	否	字段名称:无忧付订单标识 字段说明:标识是否无忧付订单
insurance_fee	string	否	否	否	保价费
return_logistics_no	string	否	否	否	字段名称:退回物流单号 字段说明:退货物流单号
user_receiving_name	string	否	否	否	用户收款方式
offline_appointment_time	string	否	否	否	线下回收预约时间
actual_ecovered_amount	string	否	否	否	实际回收价
identification_report_id	string	否	否	否	鉴定报告id
warm_reminder	string	否	否	否	字段名称:温馨提示 字段说明:用户引导说明文案
user_receiving_account	string	否	否	否	用户收款钱包账号

商品信息列表

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

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
item_name	string	是	否	否	商品名称。建议商品名称格式为：{商家名称} {商品名称}
quantity	number	是	否	否	商品数量。支持两位小数点。注意：与unit_price成对出现，若传了quantity，则需要将unit_price传入
sku_id	string	否	否	否	商家侧商品 sku id
unit_price	price	是	否	否	商品单价。精确到小数点后两位。单位为元注意：与quantity成对出现，若传了unit_price，则需要将quantity传入
unit	string	否	否	否	字段名称:商品规格 字段说明:份、件、斤、kg，默认为份
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	商品图片 value。需传入上传商品文件获取的 material_id

物流信息

若商家想在订单中展示物流信息，可通过物流信息（logistics_info_list）同步。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
phone_no	string	否	否	否	字段名称:手机号后四位 字段说明:当物流公司为顺丰时必传
logistics_code	string	否	否	否	字段名称:物流公司 字段说明:物流公司编码：详情查看
tracking_no	string	否	否	否	物流单号

门店信息

若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
address	string	否	否	否	门店地址
name	string	否	否	否	门店名称
phone_num	string	否	否	否	字段名称:门店凯发k8官方网娱乐官方的联系方式 字段说明:门店的凯发k8官方网娱乐官方的联系方式
ext_info	orderextinfo	是	否	否	扩展参数。该参数用于传入额外信息。
l ext_key	string	否	否	否	store_logo_url key,固定为 store_logo_url
l ext_value	string	否	否	否	store_logo_url value 字段说明:门店logo

待到店 (to_be_delivered)

本文详细介绍通过接口

alipay.merchant.order.sync

同步订单状态-待到店 (to_be_delivered)时需传入的商品信息及扩展字段参数信息。

接口参数 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:c100845251
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)	是	否	订单总金额：某笔交易订单优惠前的总金额，单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
pay_amount	price	选填，建议传入该参数	否	否	用户应付金额：用户最终结算时需要支付金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】注意事项 service_order且不涉及金额可不传入该字段，其他场景必传
discount_amount	price	否	否	否	商户总计优惠金额：代表商户侧给予用户的总计优惠金额（不包含选择支付宝付款时，支付宝给予的优惠减免金额），单位为【元】。
logistics_info_list	string	否	否	否
shop_info	ordershopinfo	否	否	否	门店信息。详见下文: 门店信息
item_order_list	itemorderinfo	是	否	否	商品信息列表。详见下文: 商品信息列表
ext_info	orderextinfo	是	是	否	订单扩展字段。详见下文订单扩展字段。

订单扩展字段

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
l ext_key	string	是	否	否	订单状态 key。固定为 merchant_order_status
l ext_value	string	是	是	否	订单状态, 例: to_be_delivered
l ext_key	string	是	否	否	订单类型 key。固定为 merchant_biz_type。
l ext_value	string	是	否	否	订单类型 value。本业务场景为: jewelry_recycling
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）的各项入参详情如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
nspection_results	string	否	否	否	商品质检结果
offline_recycling_id	string	否	否	是	线下回收到店码
jewelry_type	string	是	否	否	回收珠宝类型
recycling_inspection_fee	string	是	否	否	回收检测费
inspection_report_url	string	否	否	否	质检报告url链接
estimated_recovery_amount	string	否	否	否	字段名称:预估回收价 字段说明:预估回收金额
insurance_fee	string	否	否	否	保价费
user_receiving_name	string	否	否	否	用户收款方式
offline_appointment_time	string	否	否	是	线下回收预约时间
identification_report_id	string	否	否	否	鉴定报告id
warm_reminder	string	否	否	否	字段名称:温馨提示 字段说明:用户引导说明文案
user_receiving_account	string	否	否	否	用户收款钱包账号

商品信息列表

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

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
item_name	string	是	否	否	商品名称。建议商品名称格式为：{商家名称} {商品名称}
quantity	number	是	否	否	商品数量。支持两位小数点。注意：与unit_price成对出现，若传了quantity，则需要将unit_price传入
sku_id	string	否	否	否	商家侧商品 sku id
unit_price	price	是	否	否	商品单价。精确到小数点后两位。单位为元注意：与quantity成对出现，若传了unit_price，则需要将quantity传入
unit	string	否	否	否	字段名称:商品规格 字段说明:份、件、斤、kg，默认为份
ext_info	orderextinfo	是	否	否	商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key	string	是	否	否	商品图片 key。固定为 image_material_id。
l ext_value	string	是	否	否	商品图片 value。需传入上传商品文件获取的 material_id

物流信息

若商家想在订单中展示物流信息，可通过物流信息（logistics_info_list）同步。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
phone_no	string	否	否	否	字段名称:手机号后四位 字段说明:当物流公司为顺丰时必传
logistics_code	string	否	否	否	字段名称:物流公司 字段说明:物流公司编码：详情查看
tracking_no	string	否	否	否	物流单号

门店信息

若商家想在订单中展示自身门店信息，可通过门店信息（shop_info）同步店铺信息。参数说明如下：

参数	参数类型	是否必填	能否更新	是否消息使用字段	参数说明
address	string	否	否	是	门店地址
name	string	否	否	否	门店名称
phone_num	string	否	否	否	字段名称:门店凯发k8官方网娱乐官方的联系方式 字段说明:门店的凯发k8官方网娱乐官方的联系方式
ext_info	orderextinfo	是	否	否	扩展参数。该参数用于传入额外信息。
l ext_key	string	否	否	否	store_logo_url key,固定为 store_logo_url
l ext_value	string	否	否	否	store_logo_url value 字段说明:门店logo