状态中文名

状态英文名

是否为有效订单核心状态

是否发送服务消息

是否发送push

创单成功

create

是

是

否

待支付

wait_pay

否

是

否

已关闭

closed

否

是

是

退款中

refunding

否

否

否

已退款

refunded

否

否

否

已完成

finished

是

是

否

支付完成

paid

否

否

否

已发货

in_delivery

是

是

是

部分退款

refund_part

否

否

否

部分退货

return_part

否

是

是

待发货

to_send_goods

否

否

否

部分发货

partial_delivery

否

是

是

已签收

signed

否

是

是

","id":"tn0ke","rows":14,"cols":5}" id="tn0ke">

当前状态

允许的后置状态

create(创单成功)

closed/已关闭、 to_send_goods/待发货、 return_part/部分退货、 create/创单成功、 wait_pay/待支付、 refund_part/部分退款、 partial_delivery/部分发货、 finished/已完成、 in_delivery/已发货、 refunded/已退款、 paid/支付完成、 signed/已签收、 refunding/退款中

wait_pay(待支付)

closed/已关闭、 to_send_goods/待发货、 return_part/部分退货、 create/创单成功、 wait_pay/待支付、 refund_part/部分退款、 partial_delivery/部分发货、 finished/已完成、 in_delivery/已发货、 refunded/已退款、 paid/支付完成、 signed/已签收、 refunding/退款中

closed(已关闭)

closed/已关闭、 finished/已完成、 refunded/已退款、 refunding/退款中

refunding(退款中)

closed/已关闭、 refund_part/部分退款、 finished/已完成、 refunded/已退款、 return_part/部分退货、 refunding/退款中

refunded(已退款)

closed/已关闭、 finished/已完成、 refunded/已退款

finished(已完成)

closed/已关闭、 refund_part/部分退款、 finished/已完成、 refunded/已退款

paid(支付完成)

refund_part/部分退款、 to_send_goods/待发货、 in_delivery/已发货、 partial_delivery/部分发货、 finished/已完成、 refunded/已退款、 paid/支付完成、 return_part/部分退货、 signed/已签收、 refunding/退款中

in_delivery(已发货)

refund_part/部分退款、 in_delivery/已发货、 finished/已完成、 refunded/已退款、 return_part/部分退货、 signed/已签收、 refunding/退款中

refund_part(部分退款)

refund_part/部分退款、 finished/已完成、 refunded/已退款、 return_part/部分退货

return_part(部分退货)

refund_part/部分退款、 finished/已完成、 refunded/已退款、 return_part/部分退货

to_send_goods(待发货)

refund_part/部分退款、 to_send_goods/待发货、 in_delivery/已发货、 partial_delivery/部分发货、 finished/已完成、 refunded/已退款、 paid/支付完成、 return_part/部分退货、 signed/已签收、 refunding/退款中

partial_delivery(部分发货)

refund_part/部分退款、 to_send_goods/待发货、 partial_delivery/部分发货、 in_delivery/已发货、 finished/已完成、 refunded/已退款、 paid/支付完成、 return_part/部分退货、 signed/已签收、 refunding/退款中

signed(已签收)

refund_part/部分退款、 finished/已完成、 refunded/已退款、 return_part/部分退货、 signed/已签收

","id":"ktlon","rows":14,"cols":2}" id="ktlon">

{
 "shop_info":{
 "ext_info":[
 {
 "ext_key":"org_no",
 "ext_value":"1112"
 }
 ]
 },
 "amount":1.55,
 "order_modified_time":"2024-04-01 16:04:00.202",
 "discount_amount":"10.00",
 "pay_amount":1.55,
 "ext_info":[
 {
 "ext_key":"business_info",
 "ext_value":"{\"medical_trade_type\":\"自费订单: self_pay 医保支付订单: medical_insurance\",\"channel_app_id\":\"xxxx\",\"platform_code\":\"支付宝分配给平台的唯一标识\",\"trade_in\":\"y\",\"isv_id\":\"208888888888888\",\"refund_note\":\"因xxxxxx\",\"alipay_point_amount\":\"200个\",\"medical_trade_no\":\"自费：支付宝交易号，支付宝收单系统生成的订单号 医保直连：支付宝交易号，支付宝收单系统生成的订单号 医保间连：行业侧医保订单号（indi开头）\",\"refund_amount\":\"1000\",\"alipay_member_level\":\"支付宝铂金会员\",\"come_again\":\"alipays://platformapi/startapp?appid=2021002126602599page=/pages/order-details/order-details?ticketorderid=20210376854\",\"product_category\":\"感冒\"}"
 },
 {
 "ext_key":"merchant_biz_type",
 "ext_value":"kx_shopping"
 },
 {
 "ext_key":"merchant_order_status",
 "ext_value":"create"
 },
 {
 "ext_key":"merchant_order_link_page",
 "ext_value":"/pages/order/orderdetail/orderdetail?orderid=202108310xxxxxxx"
 },
 {
 "ext_key":"tiny_app_id",
 "ext_value":"2021000155639062"
 }
 ],
 "buyer_id":"2088202905xxxxxx","buyer_open_id":"074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5",
 "out_biz_no":"20240401160400563307278696",
 "logistics_info_list":[
 {
 "phone_no":"1234",
 "tracking_no":"ems1234567891012",
 "logistics_code":"best"
 }
 ],
 "order_create_time":"2024-04-01 16:04:00",
 "item_order_list":[
 {
 "quantity":"1",
 "item_id":"a12346",
 "item_name":"商品的名称",
 "sku_id":"245542227793809408",
 "unit_price":"1.55",
 "ext_info":[
 {
 "ext_key":"standard_id",
 "ext_value":"1111"
 },
 {
 "ext_key":"image_material_id",
 "ext_value":"2019082600502200000000566463"
 },
 {
 "ext_key":"platform_sku_id",
 "ext_value":"c1234"
 },
 {
 "ext_key":"voucher_no",
 "ext_value":"20221126999991q7p"
 },
 {
 "ext_key":"merchant_item_link_page",
 "ext_value":"alipays://platformapi/startapp?appid=2021002126602599page=/pages/order-details/order-details?ticketorderid=20210376854"
 },
 {
 "ext_key":"hdimageid",
 "ext_value":"12345697"
 },
 {
 "ext_key":"item_category",
 "ext_value":"h2345235"
 },
 {
 "ext_key":"platform_type",
 "ext_value":"service_goods"
 },
 {
 "ext_key":"subject_type",
 "ext_value":"code_69"
 },
 {
 "ext_key":"voucher_id",
 "ext_value":"1234567"
 },
 {
 "ext_key":"platform_item_id",
 "ext_value":"b123"
 }
 ]
 }
 ],
 "source_app":"alipay",
 "service_code":"2021030221000907068818",
 "trade_no":"2021041222001483141400960202",
 "order_type":"service_order"
}

参数

参数类型

是否必填

能否更新

是否消息使用字段

参数说明

out_biz_no

string

是

否

是

外部订单号。由商家自定义。 注意：同一笔订单更新状态时，需与首次同步入参一致。

buyer_id（buyer_open_id）

string

是

否

否

支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认 应用-开发配置-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:c000003408,c000003270,c000003390,c000003488,c000003497,c000003538,c000003543,c000003550,c000003547,c000003561,c000003567,c000003569

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

是

是

否

订单扩展字段。详见下文 订单扩展字段。

","id":"alzas","rows":17,"cols":6,"hideborder":false}" id="alzas">

参数

参数类型

是否必填

能否更新

是否消息使用字段

参数说明

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。本业务场景为: kx_shopping

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。入参详情见下文 业务信息参数

","id":"iwbrx","rows":11,"cols":6}" id="iwbrx">

参数

参数类型

是否必填

能否更新

是否消息使用字段

参数说明

medical_trade_type

string

否

否

否

支付资金类型

channel_app_id

string

否

否

否

宿主appid

come_again

string

否

否

否

字段名称:再来一单
字段说明:商户再来一单的链接

isv_id

string

否

否

否

字段名称:服务商id
字段说明:政策服务商的 pid。

refund_amount

string

否

否

否

退款金额

trade_in

string

否

否

否

字段名称:以旧换新
字段说明:以旧换新的标识，如果是以旧换新商品，带回y

refund_note

string

否

否

否

退款说明

medical_trade_no

string

否

否

否

医药交易单号

alipay_member_level

string

否

否

否

支付宝会员等级

platform_code

string

否

否

否

平台编码

alipay_point_amount

string

否

否

否

字段名称:支付宝会员积分数
字段说明:alipay_point_amount

product_category

string

否

否

否

字段名称:订单主类目
字段说明:商品类目

","id":"fypy2","rows":13,"cols":6}" id="fypy2">

参数

参数类型

是否必填

能否更新

是否消息使用字段

参数说明

item_name

string

是

否

是

商品名称。建议商品名称格式为：{商家名称}+{商品名称}

item_id

string

否

否

否

商家侧商品 spu 编码。

quantity

number

否

否

否

商品数量。支持两位小数点。 注意：与unit_price成对出现，若传了quantity，则需要将unit_price传入

sku_id

string

否

否

否

商家侧商品 sku id

unit_price

price

否

否

否

商品单价。精确到小数点后两位。单位为元

注意：与quantity成对出现，若传了unit_price，则需要将quantity传入

+ ext_info

orderextinfo

是

否

否

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

l ext_key

string

否

否

否

standard_id key,固定为 standard_id

l ext_value

string

否

否

否

standard_id value
字段说明:商品标品id

l ext_key

string

是

否

否

商品图片 key。固定为 image_material_id。

l ext_value

string

是

否

否

商品图片 value。需传入 上传商品文件

获取的 material_id

l ext_key

string

否

否

否

platform_sku_id key,固定为 platform_sku_id

l ext_value

string

否

否

否

platform_sku_id value
字段说明:平台侧如商品库的商品单品信息

l ext_key

string

否

否

否

voucher_no key,固定为 voucher_no

l ext_value

string

否

否

否

voucher_no value
字段说明:支付宝支付劵返回的唯一值，使用支付劵的订单场景必填，如年画、福气店等。

l ext_key

string

否

否

否

商品详情页 key。固定为 merchant_item_link_page。

l ext_value

string

否

否

否

商品详情页 value。仅需传入小程序页面地址，支付宝会自动根据该笔交易对应的 appid 来拼接商品详情页跳转链接。

l ext_key

string

否

否

否

hdimageid key,固定为 hdimageid

l ext_value

string

否

否

否

hdimageid value
字段说明:五福年画商品必传id

l ext_key

string

否

否

否

item_category key,固定为 item_category

l ext_value

string

否

否

否

item_category value
字段说明:商品类目

l ext_key

string

否

否

否

platform_type key,固定为 platform_type

l ext_value

string

否

否

否

platform_type value
字段说明:平台类别，枚举值：如商品库service_goods、

l ext_key

string

否

否

否

subject_type key,固定为 subject_type

l ext_value

string

否

否

否

subject_type value
字段说明:商品标品类型

l ext_key

string

否

否

否

voucher_id key,固定为 voucher_id

l ext_value

string

否

否

否

voucher_id value
字段说明:支付宝劵平台返还的唯一值，使用在会员频道的权益商品场景。支付宝会员频道订单必填。

l ext_key

string

否

否

否

platform_item_id key,固定为 platform_item_id

l ext_value

string

否

否

否

platform_item_id value
字段说明:平台侧如商品库的商品品类

","id":"dcwvd","rows":29,"cols":6,"hideborder":false}" id="dcwvd">

参数

参数类型

是否必填

能否更新

是否消息使用字段

参数说明

phone_no

string

否

否

否

字段名称:手机号后四位
字段说明:当物流公司为顺丰时必传

logistics_code

string

否

否

否

字段名称:物流公司

字段说明:物流公司编码，详情可查看 。

tracking_no

string

否

否

否

物流单号

","id":"avrsv","rows":4,"cols":6,"hideborder":false}" id="avrsv">

参数

参数类型

是否必填

能否更新

是否消息使用字段

参数说明

+ ext_info

orderextinfo

是

否

否

扩展参数。该参数用于传入额外信息。

l ext_key

string

否

否

否

org_no key,固定为 org_no

l ext_value

string

否

否

否

org_no value
字段说明:定点医疗机构编码

","id":"qsdpa","rows":4,"cols":6}" id="qsdpa">

{
 "shop_info":{
 "ext_info":[
 {
 "ext_key":"org_no",
 "ext_value":"1112"
 }
 ]
 },
 "amount":1.55,
 "order_modified_time":"2024-04-01 16:04:00.205",
 "discount_amount":"10.00",
 "pay_amount":1.55,
 "ext_info":[
 {
 "ext_key":"business_info",
 "ext_value":"{\"medical_trade_type\":\"自费订单: self_pay 医保支付订单: medical_insurance\",\"channel_app_id\":\"xxxx\",\"platform_code\":\"支付宝分配给平台的唯一标识\",\"trade_in\":\"y\",\"isv_id\":\"208888888888888\",\"refund_note\":\"因xxxxxx\",\"alipay_point_amount\":\"200个\",\"medical_trade_no\":\"自费：支付宝交易号，支付宝收单系统生成的订单号 医保直连：支付宝交易号，支付宝收单系统生成的订单号 医保间连：行业侧医保订单号（indi开头）\",\"refund_amount\":\"1000\",\"alipay_member_level\":\"支付宝铂金会员\",\"come_again\":\"alipays://platformapi/startapp?appid=2021002126602599page=/pages/order-details/order-details?ticketorderid=20210376854\",\"product_category\":\"感冒\"}"
 },
 {
 "ext_key":"merchant_biz_type",
 "ext_value":"kx_shopping"
 },
 {
 "ext_key":"merchant_order_status",
 "ext_value":"wait_pay"
 },
 {
 "ext_key":"merchant_order_link_page",
 "ext_value":"/pages/order/orderdetail/orderdetail?orderid=202108310xxxxxxx"
 },
 {
 "ext_key":"tiny_app_id",
 "ext_value":"2021000155639062"
 }
 ],
 "buyer_id":"2088202905xxxxxx","buyer_open_id":"074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5",
 "out_biz_no":"20240401160400117364052166",
 "logistics_info_list":[
 {
 "phone_no":"1234",
 "tracking_no":"ems1234567891012",
 "logistics_code":"best"
 }
 ],
 "order_create_time":"2024-04-01 16:04:00",
 "item_order_list":[
 {
 "quantity":"1",
 "item_id":"a12346",
 "item_name":"商品的名称",
 "sku_id":"245542227793809408",
 "unit_price":"1.55",
 "ext_info":[
 {
 "ext_key":"standard_id",
 "ext_value":"1111"
 },
 {
 "ext_key":"image_material_id",
 "ext_value":"2019082600502200000000566463"
 },
 {
 "ext_key":"platform_sku_id",
 "ext_value":"c1234"
 },
 {
 "ext_key":"voucher_no",
 "ext_value":"20221126999991q7p"
 },
 {
 "ext_key":"merchant_item_link_page",
 "ext_value":"alipays://platformapi/startapp?appid=2021002126602599page=/pages/order-details/order-details?ticketorderid=20210376854"
 },
 {
 "ext_key":"hdimageid",
 "ext_value":"12345697"
 },
 {
 "ext_key":"item_category",
 "ext_value":"h2345235"
 },
 {
 "ext_key":"platform_type",
 "ext_value":"service_goods"
 },
 {
 "ext_key":"subject_type",
 "ext_value":"code_69"
 },
 {
 "ext_key":"voucher_id",
 "ext_value":"1234567"
 },
 {
 "ext_key":"platform_item_id",
 "ext_value":"b123"
 }
 ]
 }
 ],
 "source_app":"alipay",
 "service_code":"2021030221000907068818",
 "trade_no":"2021041222001483141400960202",
 "order_type":"service_order"
}

参数

参数类型

是否必填

能否更新

是否消息使用字段

参数说明

out_biz_no

string

是

否

是

外部订单号。由商家自定义。 注意：同一笔订单更新状态时，需与首次同步入参一致。

buyer_id（buyer_open_id）

string

是

否

否

支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认 应用-开发配置-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:c000003408,c000003270,c000003390,c000003488,c000003497,c000003538,c000003543,c000003550,c000003547,c000003561,c000003567,c000003569

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

是

是

否

订单扩展字段。详见下文 订单扩展字段。

","id":"dwlsa","rows":17,"cols":6,"hideborder":false}" id="dwlsa">

参数

参数类型

是否必填

能否更新

是否消息使用字段

参数说明

l ext_key

string

是

否

否

订单状态 key。固定为 merchant_order_status

l ext_value

string

是

是

否

订单状态, 例: wait_pay

l ext_key

string

是

否

否

订单类型 key。固定为 merchant_biz_type。

l ext_value

string

是

否

否

订单类型 value。本业务场景为: kx_shopping

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。入参详情见下文 业务信息参数

","id":"xowez","rows":11,"cols":6}" id="xowez">

参数

参数类型

是否必填

能否更新

是否消息使用字段

参数说明

medical_trade_type

string

否

否

否

支付资金类型

channel_app_id

string

否

否

否

宿主appid

come_again

string

否

否

否

字段名称:再来一单
字段说明:商户再来一单的链接

isv_id

string

否

否

否

字段名称:服务商id
字段说明:政策服务商的 pid。

refund_amount

string

否

否

否

退款金额

trade_in

string

否

否

否

字段名称:以旧换新
字段说明:以旧换新的标识，如果是以旧换新商品，带回y

refund_note

string

否

否

否

退款说明

medical_trade_no

string

否

否

否

医药交易单号

alipay_member_level

string

否

否

否

支付宝会员等级

platform_code

string

否

否

否

平台编码

alipay_point_amount

string

否

否

否

字段名称:支付宝会员积分数
字段说明:alipay_point_amount

product_category

string

否

否

否

字段名称:订单主类目
字段说明:商品类目

","id":"0oa6g","rows":13,"cols":6}" id="0oa6g">

参数

参数类型

是否必填

能否更新

是否消息使用字段

参数说明

item_name

string

是

否

是

商品名称。建议商品名称格式为：{商家名称}+{商品名称}

item_id

string

否

否

否

商家侧商品 spu 编码。

quantity

number

否

否

否

商品数量。支持两位小数点。 注意：与unit_price成对出现，若传了quantity，则需要将unit_price传入

sku_id

string

否

否

否

商家侧商品 sku id

unit_price

price

否

否

否

商品单价。精确到小数点后两位。单位为元

注意：与quantity成对出现，若传了unit_price，则需要将quantity传入

+ ext_info

orderextinfo

是

否

否

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

l ext_key

string

否

否

否

standard_id key,固定为 standard_id

l ext_value

string

否

否

否

standard_id value
字段说明:商品标品id

l ext_key

string

是

否

否

商品图片 key。固定为 image_material_id。

l ext_value

string

是

否

否

商品图片 value。需传入 上传商品文件

获取的 material_id

l ext_key

string

否

否

否

platform_sku_id key,固定为 platform_sku_id

l ext_value

string

否

否

否

platform_sku_id value
字段说明:平台侧如商品库的商品单品信息

l ext_key

string

否

否

否

voucher_no key,固定为 voucher_no

l ext_value

string

否

否

否

voucher_no value
字段说明:支付宝支付劵返回的唯一值，使用支付劵的订单场景必填，如年画、福气店等。

l ext_key

string

否

否

否

商品详情页 key。固定为 merchant_item_link_page。

l ext_value

string

否

否

否

商品详情页 value。仅需传入小程序页面地址，支付宝会自动根据该笔交易对应的 appid 来拼接商品详情页跳转链接。

l ext_key

string

否

否

否

hdimageid key,固定为 hdimageid

l ext_value

string

否

否

否

hdimageid value
字段说明:五福年画商品必传id

l ext_key

string

否

否

否

item_category key,固定为 item_category

l ext_value

string

否

否

否

item_category value
字段说明:商品类目

l ext_key

string

否

否

否

platform_type key,固定为 platform_type

l ext_value

string

否

否

否

platform_type value
字段说明:平台类别，枚举值：如商品库service_goods、

l ext_key

string

否

否

否

subject_type key,固定为 subject_type

l ext_value

string

否

否

否

subject_type value
字段说明:商品标品类型

l ext_key

string

否

否

否

voucher_id key,固定为 voucher_id

l ext_value

string

否

否

否

voucher_id value
字段说明:支付宝劵平台返还的唯一值，使用在会员频道的权益商品场景。支付宝会员频道订单必填。

l ext_key

string

否

否

否

platform_item_id key,固定为 platform_item_id

l ext_value

string

否

否

否

platform_item_id value
字段说明:平台侧如商品库的商品品类

","id":"j6jjm","rows":29,"cols":6,"hideborder":false}" id="j6jjm">

参数

参数类型

是否必填

能否更新

是否消息使用字段

参数说明

phone_no

string

否

否

否

字段名称:手机号后四位
字段说明:当物流公司为顺丰时必传

logistics_code

string

否

否

否

字段名称:物流公司

字段说明:物流公司编码，详情可查看 。

tracking_no

string

否

否

否

物流单号

","id":"0r5l8","rows":4,"cols":6,"hideborder":false}" id="0r5l8">

参数

参数类型

是否必填

能否更新

是否消息使用字段

参数说明

+ ext_info

orderextinfo

是

否

否

扩展参数。该参数用于传入额外信息。

l ext_key

string

否

否

否

org_no key,固定为 org_no

l ext_value

string

否

否

否

org_no value
字段说明:定点医疗机构编码

","id":"h6aal","rows":4,"cols":6}" id="h6aal">

{
 "shop_info":{
 "ext_info":[
 {
 "ext_key":"org_no",
 "ext_value":"1112"
 }
 ]
 },
 "amount":1.55,
 "order_modified_time":"2024-04-01 16:04:00.208",
 "discount_amount":"10.00",
 "pay_amount":1.55,
 "ext_info":[
 {
 "ext_key":"business_info",
 "ext_value":"{\"medical_trade_type\":\"自费订单: self_pay 医保支付订单: medical_insurance\",\"channel_app_id\":\"xxxx\",\"platform_code\":\"支付宝分配给平台的唯一标识\",\"trade_in\":\"y\",\"isv_id\":\"208888888888888\",\"refund_note\":\"因xxxxxx\",\"alipay_point_amount\":\"200个\",\"medical_trade_no\":\"自费：支付宝交易号，支付宝收单系统生成的订单号 医保直连：支付宝交易号，支付宝收单系统生成的订单号 医保间连：行业侧医保订单号（indi开头）\",\"refund_amount\":\"1000\",\"alipay_member_level\":\"支付宝铂金会员\",\"come_again\":\"alipays://platformapi/startapp?appid=2021002126602599page=/pages/order-details/order-details?ticketorderid=20210376854\",\"product_category\":\"感冒\"}"
 },
 {
 "ext_key":"merchant_biz_type",
 "ext_value":"kx_shopping"
 },
 {
 "ext_key":"merchant_order_status",
 "ext_value":"closed"
 },
 {
 "ext_key":"merchant_order_link_page",
 "ext_value":"/pages/order/orderdetail/orderdetail?orderid=202108310xxxxxxx"
 },
 {
 "ext_key":"tiny_app_id",
 "ext_value":"2021000155639062"
 }
 ],
 "buyer_id":"2088202905xxxxxx","buyer_open_id":"074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5",
 "out_biz_no":"20240401160400156629464986",
 "logistics_info_list":[
 {
 "phone_no":"1234",
 "tracking_no":"ems1234567891012",
 "logistics_code":"best"
 }
 ],
 "order_create_time":"2024-04-01 16:04:00",
 "item_order_list":[
 {
 "quantity":"1",
 "item_id":"a12346",
 "item_name":"商品的名称",
 "sku_id":"245542227793809408",
 "unit_price":"1.55",
 "ext_info":[
 {
 "ext_key":"standard_id",
 "ext_value":"1111"
 },
 {
 "ext_key":"image_material_id",
 "ext_value":"2019082600502200000000566463"
 },
 {
 "ext_key":"platform_sku_id",
 "ext_value":"c1234"
 },
 {
 "ext_key":"voucher_no",
 "ext_value":"20221126999991q7p"
 },
 {
 "ext_key":"merchant_item_link_page",
 "ext_value":"alipays://platformapi/startapp?appid=2021002126602599page=/pages/order-details/order-details?ticketorderid=20210376854"
 },
 {
 "ext_key":"hdimageid",
 "ext_value":"12345697"
 },
 {
 "ext_key":"item_category",
 "ext_value":"h2345235"
 },
 {
 "ext_key":"platform_type",
 "ext_value":"service_goods"
 },
 {
 "ext_key":"subject_type",
 "ext_value":"code_69"
 },
 {
 "ext_key":"voucher_id",
 "ext_value":"1234567"
 },
 {
 "ext_key":"platform_item_id",
 "ext_value":"b123"
 }
 ]
 }
 ],
 "source_app":"alipay",
 "service_code":"2021030221000907068818",
 "trade_no":"2021041222001483141400960202",
 "order_type":"service_order"
}

参数

参数类型

是否必填

能否更新

是否消息使用字段

参数说明

out_biz_no

string

是

否

否

外部订单号。由商家自定义。 注意：同一笔订单更新状态时，需与首次同步入参一致。

buyer_id（buyer_open_id）

string

是

否

否

支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认 应用-开发配置-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:c000003408,c000003270,c000003390,c000003488,c000003497,c000003538,c000003543,c000003550,c000003547,c000003561,c000003567,c000003569

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

是

是

否

订单扩展字段。详见下文 订单扩展字段。

","id":"gu3fx","rows":17,"cols":6,"hideborder":false}" id="gu3fx">

参数

参数类型

是否必填

能否更新

是否消息使用字段

参数说明

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。本业务场景为: kx_shopping

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。入参详情见下文 业务信息参数

","id":"3ztw0","rows":11,"cols":6}" id="3ztw0">

参数

参数类型

是否必填

能否更新

是否消息使用字段

参数说明

medical_trade_type

string

否

否

否

支付资金类型

channel_app_id

string

否

否

否

宿主appid

come_again

string

否

否

否

字段名称:再来一单
字段说明:商户再来一单的链接

isv_id

string

否

否

否

字段名称:服务商id
字段说明:政策服务商的 pid。

refund_amount

string

否

否

否

退款金额

trade_in

string

否

否

否

字段名称:以旧换新
字段说明:以旧换新的标识，如果是以旧换新商品，带回y

refund_note

string

否

否

否

退款说明

medical_trade_no

string

否

否

否

医药交易单号

alipay_member_level

string

否

否

否

支付宝会员等级

platform_code

string

否

否

否

平台编码

alipay_point_amount

string

否

否

否

字段名称:支付宝会员积分数
字段说明:alipay_point_amount

product_category

string

否

否

否

字段名称:订单主类目
字段说明:商品类目

","id":"nvabx","rows":13,"cols":6}" id="nvabx">

参数

参数类型

是否必填

能否更新

是否消息使用字段

参数说明

item_name

string

是

否

是

商品名称。建议商品名称格式为：{商家名称}+{商品名称}

item_id

string

否

否

否

商家侧商品 spu 编码。

quantity

number

否

否

否

商品数量。支持两位小数点。 注意：与unit_price成对出现，若传了quantity，则需要将unit_price传入

sku_id

string

否

否

否

商家侧商品 sku id

unit_price

price

否

否

否

商品单价。精确到小数点后两位。单位为元

注意：与quantity成对出现，若传了unit_price，则需要将quantity传入

+ ext_info

orderextinfo

是

否

否

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

l ext_key

string

否

否

否

standard_id key,固定为 standard_id

l ext_value

string

否

否

否

standard_id value
字段说明:商品标品id

l ext_key

string

是

否

否

商品图片 key。固定为 image_material_id。

l ext_value

string

是

否

否

商品图片 value。需传入 上传商品文件

获取的 material_id

l ext_key

string

否

否

否

platform_sku_id key,固定为 platform_sku_id

l ext_value

string

否

否

否

platform_sku_id value
字段说明:平台侧如商品库的商品单品信息

l ext_key

string

否

否

否

voucher_no key,固定为 voucher_no

l ext_value

string

否

否

否

voucher_no value
字段说明:支付宝支付劵返回的唯一值，使用支付劵的订单场景必填，如年画、福气店等。

l ext_key

string

否

否

否

商品详情页 key。固定为 merchant_item_link_page。

l ext_value

string

否

否

否

商品详情页 value。仅需传入小程序页面地址，支付宝会自动根据该笔交易对应的 appid 来拼接商品详情页跳转链接。

l ext_key

string

否

否

否

hdimageid key,固定为 hdimageid

l ext_value

string

否

否

否

hdimageid value
字段说明:五福年画商品必传id

l ext_key

string

否

否

否

item_category key,固定为 item_category

l ext_value

string

否

否

否

item_category value
字段说明:商品类目

l ext_key

string

否

否

否

platform_type key,固定为 platform_type

l ext_value

string

否

否

否

platform_type value
字段说明:平台类别，枚举值：如商品库service_goods、

l ext_key

string

否

否

否

subject_type key,固定为 subject_type

l ext_value

string

否

否

否

subject_type value
字段说明:商品标品类型

l ext_key

string

否

否

否

voucher_id key,固定为 voucher_id

l ext_value

string

否

否

否

voucher_id value
字段说明:支付宝劵平台返还的唯一值，使用在会员频道的权益商品场景。支付宝会员频道订单必填。

l ext_key

string

否

否

否

platform_item_id key,固定为 platform_item_id

l ext_value

string

否

否

否

platform_item_id value
字段说明:平台侧如商品库的商品品类

","id":"g44ws","rows":29,"cols":6,"hideborder":false}" id="g44ws">

参数

参数类型

是否必填

能否更新

是否消息使用字段

参数说明

phone_no

string

否

否

否

字段名称:手机号后四位
字段说明:当物流公司为顺丰时必传

logistics_code

string

否

否

否

字段名称:物流公司

字段说明:物流公司编码，详情可查看 。

tracking_no

string

否

否

否

物流单号

","id":"cytxz","rows":4,"cols":6,"hideborder":false}" id="cytxz">

参数

参数类型

是否必填

能否更新

是否消息使用字段

参数说明

+ ext_info

orderextinfo

是

否

否

扩展参数。该参数用于传入额外信息。

l ext_key

string

否

否

否

org_no key,固定为 org_no

l ext_value

string

否

否

否

org_no value
字段说明:定点医疗机构编码

","id":"izxwg","rows":4,"cols":6}" id="izxwg">

{
 "shop_info":{
 "ext_info":[
 {
 "ext_key":"org_no",
 "ext_value":"1112"
 }
 ]
 },
 "amount":1.55,
 "order_modified_time":"2024-04-01 16:04:00.210",
 "discount_amount":"10.00",
 "pay_amount":1.55,
 "ext_info":[
 {
 "ext_key":"business_info",
 "ext_value":"{\"medical_trade_type\":\"自费订单: self_pay 医保支付订单: medical_insurance\",\"channel_app_id\":\"xxxx\",\"platform_code\":\"支付宝分配给平台的唯一标识\",\"trade_in\":\"y\",\"isv_id\":\"208888888888888\",\"refund_note\":\"因xxxxxx\",\"alipay_point_amount\":\"200个\",\"medical_trade_no\":\"自费：支付宝交易号，支付宝收单系统生成的订单号 医保直连：支付宝交易号，支付宝收单系统生成的订单号 医保间连：行业侧医保订单号（indi开头）\",\"refund_amount\":\"1000\",\"alipay_member_level\":\"支付宝铂金会员\",\"come_again\":\"alipays://platformapi/startapp?appid=2021002126602599page=/pages/order-details/order-details?ticketorderid=20210376854\",\"product_category\":\"感冒\"}"
 },
 {
 "ext_key":"merchant_biz_type",
 "ext_value":"kx_shopping"
 },
 {
 "ext_key":"merchant_order_status",
 "ext_value":"refunding"
 },
 {
 "ext_key":"merchant_order_link_page",
 "ext_value":"/pages/order/orderdetail/orderdetail?orderid=202108310xxxxxxx"
 },
 {
 "ext_key":"tiny_app_id",
 "ext_value":"2021000155639062"
 }
 ],
 "buyer_id":"2088202905xxxxxx","buyer_open_id":"074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5",
 "out_biz_no":"20240401160400728552917737",
 "logistics_info_list":[
 {
 "phone_no":"1234",
 "tracking_no":"ems1234567891012",
 "logistics_code":"best"
 }
 ],
 "order_create_time":"2024-04-01 16:04:00",
 "item_order_list":[
 {
 "quantity":"1",
 "item_id":"a12346",
 "item_name":"商品的名称",
 "sku_id":"245542227793809408",
 "unit_price":"1.55",
 "ext_info":[
 {
 "ext_key":"standard_id",
 "ext_value":"1111"
 },
 {
 "ext_key":"image_material_id",
 "ext_value":"2019082600502200000000566463"
 },
 {
 "ext_key":"platform_sku_id",
 "ext_value":"c1234"
 },
 {
 "ext_key":"voucher_no",
 "ext_value":"20221126999991q7p"
 },
 {
 "ext_key":"merchant_item_link_page",
 "ext_value":"alipays://platformapi/startapp?appid=2021002126602599page=/pages/order-details/order-details?ticketorderid=20210376854"
 },
 {
 "ext_key":"hdimageid",
 "ext_value":"12345697"
 },
 {
 "ext_key":"item_category",
 "ext_value":"h2345235"
 },
 {
 "ext_key":"platform_type",
 "ext_value":"service_goods"
 },
 {
 "ext_key":"subject_type",
 "ext_value":"code_69"
 },
 {
 "ext_key":"voucher_id",
 "ext_value":"1234567"
 },
 {
 "ext_key":"platform_item_id",
 "ext_value":"b123"
 }
 ]
 }
 ],
 "source_app":"alipay",
 "service_code":"2021030221000907068818",
 "trade_no":"2021041222001483141400960202",
 "order_type":"service_order"
}

参数

参数类型

是否必填

能否更新

是否消息使用字段

参数说明

out_biz_no

string

是

否

否

外部订单号。由商家自定义。 注意：同一笔订单更新状态时，需与首次同步入参一致。

buyer_id（buyer_open_id）

string

是

否

否

支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认 应用-开发配置-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:c000003408,c000003270,c000003390,c000003488,c000003497,c000003538,c000003543,c000003550,c000003547,c000003561,c000003567,c000003569

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

是

是

否

订单扩展字段。详见下文 订单扩展字段。

","id":"rh98j","rows":17,"cols":6,"hideborder":false}" id="rh98j">

参数

参数类型

是否必填

能否更新

是否消息使用字段

参数说明

l ext_key

string

是

否

否

订单状态 key。固定为 merchant_order_status

l ext_value

string

是

是

否

订单状态, 例: refunding

l ext_key

string

是

否

否

订单类型 key。固定为 merchant_biz_type。

l ext_value

string

是

否

否

订单类型 value。本业务场景为: kx_shopping

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。入参详情见下文 业务信息参数

","id":"xmahx","rows":11,"cols":6}" id="xmahx">