开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
开始使用
ampe
ampe 介绍
ampe 入驻
产品管理
硬件接入
开发指南
运营能力接入
api 列表
常见问题
多端开发
鸿蒙
插件
安全
openid 开发指南
扩展能力
开发 > 指南 > ampe > 社区团购(community_group)
收藏
订阅更新
我的文档
设置
商家需通过 alipay.merchant.order.sync(订单数据同步接口) 订单扩展字段 ext_info#merchant_order_status 参数更新订单状态,社区团购专用状态如下。
订单状态流转说明
订单状态流转图
说明:左侧表示起始状态,右侧表示允许的后置状态。
社区团购.png

入参规则说明
支持跨状态传递,如:wait_pay(待支付)可直接跳转至 finished(订单完成)。
不要求首次同步订单状态必须为 wait_pay(待支付)。
订单状态发生变更后,需要及时同步最新状态。
当前场景定义的订单状态(中文和英文名)如下
注意:不同订单状态,仅是 否发送服务消息 时,用户才能在 消息列表(支付宝凯发k8官方网娱乐官方首页服务提醒入口进入或凯发k8官方网娱乐官方首页底部消息 tab 进入)查看服务订单消息提醒。
状态中文名
状态英文名
是否发送服务消息
待支付
wait_pay

超时取消
closed

支付成功
paid

中心仓配货
centre_delivery

网格仓配送
grid_delivery

团长收货
transit_goods

确认收货
taked_goods

订单完成
finished

申请售后
after_sales

同意退货
agree_return

售后驳回
no_return

已退款
refunded

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



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



支付宝用户 uid。2088 开头的数字。
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相同的两次同步会被幂等处理。
source_app
string



订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其它来源枚举值定义联系支付宝订单中心添加。
item_order_list
itemorderinfo



商品信息列表。详情可查看下文 商品信息列表
ext_info
orderextinfo



订单扩展字段。详情可查看下文 订单扩展字段
trade_no
string



支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。
amount
price
选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)


订单总金额。精确到小数点后两位,单位为元
pay_amount
price
选填,建议传入该参数


实际支付金额。精确到小数点后两位。单位为
discount_amount
price



优惠金额。传入 discount_info_list  时必填。单位为
订单扩展字段
开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
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。本业务场景为:community_group
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) 的各项入参详情如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
address
string



字段名称:自提点地址 字段说明:团点地址
manager
string



字段名称:自提点团长 字段说明:脱敏称呼
end_time
string



字段名称:预计提货结束时间 字段说明:预计提货结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
brand_name
string



字段名称:品牌名 字段说明:盒马集市
start_time
string



字段名称:预计提货开始时间 字段说明:时间点,时间格式为 yyyy-mm-dd hh:mm:ss。
phone
string



字段名称:自提点电话 字段说明:虚拟号或固话
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}
quantity
number



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



商品单价。精确到小数点后两位。单位为 元。
注意:与 quantity 成对出现,若传了unit_price,则需要将 quantity 传入。
ext_info
orderextinfo



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



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



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



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



支付宝用户 uid。2088 开头的数字。
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相同的两次同步会被幂等处理。
source_app
string



订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其它来源枚举值定义联系支付宝订单中心添加。
item_order_list
itemorderinfo



商品信息列表。详情可查看下文 商品信息列表
ext_info
orderextinfo



订单扩展字段。详情可查看下文 订单扩展字段
trade_no
string



支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。
amount
price
选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)


订单总金额。精确到小数点后两位,单位为元
pay_amount
price
选填,建议传入该参数


实际支付金额。精确到小数点后两位。单位为
discount_amount
price



优惠金额。传入 discount_info_list  时必填。单位为
订单扩展字段
开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
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。本业务场景为:community_group
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) 的各项入参详情如下:
参数
参数说明
是否必填
能否更新
是否消息使用字段
参数说明
address
string



字段名称:自提点地址 字段说明:团点地址
manager
string



字段名称自提点团长 字段说明脱敏称呼
end_time
string



字段名称预计提货结束时间 字段说明预计提货结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
brand_name
string



字段名称:品牌名 字段说明:盒马集市
start_time
string



字段名称:预计提货开始时间 字段说明:时间点,时间格式为 yyyy-mm-dd hh:mm:ss。
phone
string



字段名称:自提点电话 字段说明:虚拟号或固话
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}
quantity
number



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



商品单价。精确到小数点后两位。单位为 元。
注意:与 quantity 成对出现,若传了unit_price,则需要将 quantity 传入。
ext_info
orderextinfo



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



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



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



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



支付宝用户 uid。2088 开头的数字。
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相同的两次同步会被幂等处理。
source_app
string



订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其它来源枚举值定义联系支付宝订单中心添加。
item_order_list
itemorderinfo



商品信息列表。详情可查看下文 商品信息列表
ext_info
orderextinfo



订单扩展字段。详情可查看下文 订单扩展字段
trade_no
string



支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。
amount
price
选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)


订单总金额。精确到小数点后两位,单位为元
pay_amount
price
选填,建议传入该参数


实际支付金额。精确到小数点后两位。单位为
discount_amount
price



优惠金额。传入 discount_info_list  时必填。单位为
订单扩展字段
开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
l ext_key
string



订单状态 key。固定为 merchant_order_status
l ext_value
string



订单状态, 例: paid
l ext_key
string



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



订单类型 value。本业务场景为: community_group
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) 的各项入参详情如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
address
string



字段名称:自提点地址 字段说明:团点地址
manager
string



字段名称:自提点团长 字段说明:脱敏称呼
end_time
string



字段名称:预计提货结束时间 字段说明:预计提货结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
brand_name
string



字段名称:品牌名 字段说明:盒马集市
start_time
string



字段名称:预计提货开始时间 字段说明:时间点,时间格式为 yyyy-mm-dd hh:mm:ss。
phone
string



字段名称:自提点电话 字段说明:虚拟号或固话
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}
quantity
number



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



商品单价。精确到小数点后两位。单位为 元。
注意:与 quantity 成对出现,若传了unit_price,则需要将 quantity 传入。
ext_info
orderextinfo



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



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



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



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



支付宝用户 uid。2088 开头的数字。
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相同的两次同步会被幂等处理。
source_app
string



订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其它来源枚举值定义联系支付宝订单中心添加。
item_order_list
itemorderinfo



商品信息列表。详情可查看下文 商品信息列表
ext_info
orderextinfo



订单扩展字段。详情可查看下文 订单扩展字段
trade_no
string



支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。
amount
price
选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)


订单总金额。精确到小数点后两位,单位为元
pay_amount
price
选填,建议传入该参数


实际支付金额。精确到小数点后两位。单位为
discount_amount
price



优惠金额。传入 discount_info_list  时必填。单位为
订单扩展字段
开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
l ext_key
string



订单状态 key。固定为 merchant_order_status
l ext_value
string



订单状态, 例: centre_delivery
l ext_key
string



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



订单类型 value。本业务场景为: community_group
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) 的各项入参详情如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
address
string



字段名称:自提点地址 字段说明:团点地址
manager
string



字段名称:自提点团长 字段说明:脱敏称呼
end_time
string



字段名称:预计提货结束时间 字段说明:预计提货结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
brand_name
string



字段名称:品牌名 字段说明:盒马集市
start_time
string



字段名称:预计提货开始时间 字段说明:时间点,时间格式为 yyyy-mm-dd hh:mm:ss。
phone
string



字段名称:自提点电话 字段说明:虚拟号或固话
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}
quantity
number



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



商品单价。精确到小数点后两位。单位为 元。
注意:与 quantity 成对出现,若传了unit_price,则需要将 quantity 传入。
ext_info
orderextinfo



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



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



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



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



支付宝用户 uid。2088 开头的数字。
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相同的两次同步会被幂等处理。
source_app
string



订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其它来源枚举值定义联系支付宝订单中心添加。
item_order_list
itemorderinfo



商品信息列表。详情可查看下文 商品信息列表
ext_info
orderextinfo



订单扩展字段。详情可查看下文 订单扩展字段
trade_no
string



支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。
amount
price
选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)


订单总金额。精确到小数点后两位,单位为
pay_amount
price
选填,建议传入该参数


实际支付金额。精确到小数点后两位。单位为
discount_amount
price



优惠金额。传入 discount_info_list  时必填。单位为
订单扩展字段
开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
l ext_key
string



订单状态 key。固定为 merchant_order_status
l ext_value
string



订单状态, 例: grid_delivery
l ext_key
string



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



订单类型 value。本业务场景为: community_group
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) 的各项入参详情如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
address
string



字段名称:自提点地址 字段说明:团点地址
manager
string



字段名称:自提点团长 字段说明:脱敏称呼
end_time
string



字段名称:预计提货结束时间 字段说明:预计提货结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
brand_name
string



字段名称:品牌名 字段说明:盒马集市
start_time
string



字段名称:预计提货开始时间 字段说明:时间点,时间格式为 yyyy-mm-dd hh:mm:ss。
phone
string



字段名称:自提点电话 字段说明:虚拟号或固话
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}
quantity
number



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



商品单价。精确到小数点后两位。单位为 元。
注意:与 quantity 成对出现,若传了unit_price,则需要将 quantity 传入。
ext_info
orderextinfo



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



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



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



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



支付宝用户 uid。2088 开头的数字。
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相同的两次同步会被幂等处理。
source_app
string



订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其它来源枚举值定义联系支付宝订单中心添加。
item_order_list
itemorderinfo



商品信息列表。详情可查看下文 商品信息列表
ext_info
orderextinfo



订单扩展字段。详情可查看下文 订单扩展字段
trade_no
string



支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。
amount
price
选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)


订单总金额。精确到小数点后两位,单位为
pay_amount
price
选填,建议传入该参数


实际支付金额。精确到小数点后两位。单位为
discount_amount
price



优惠金额。传入 discount_info_list  时必填。单位为
订单扩展字段
开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
l ext_key
string



订单状态 key。固定为 merchant_order_status
l ext_value
string



订单状态, 例: transit_goods
l ext_key
string



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



订单类型 value。本业务场景为: community_group
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) 的各项入参详情如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
address
string



字段名称:自提点地址 字段说明:团点地址
manager
string



字段名称:自提点团长 字段说明:脱敏称呼
end_time
string



字段名称:预计提货结束时间 字段说明:预计提货结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
brand_name
string



字段名称:品牌名 字段说明:盒马集市
start_time
string



字段名称:预计提货开始时间 字段说明:时间点,时间格式为 yyyy-mm-dd hh:mm:ss。
phone
string



字段名称:自提点电话 字段说明:虚拟号或固话
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}
quantity
number



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



商品单价。精确到小数点后两位。单位为 元。
注意:与 quantity 成对出现,若传了unit_price,则需要将 quantity 传入。
ext_info
orderextinfo



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



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



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



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



支付宝用户 uid。2088 开头的数字。
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相同的两次同步会被幂等处理。
source_app
string



订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其它来源枚举值定义联系支付宝订单中心添加.
item_order_list
itemorderinfo



商品信息列表。详情可查看下文 商品信息列表
ext_info
orderextinfo



订单扩展字段。详情可查看下文 订单扩展字段
trade_no
string



支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。
amount
price
选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)


订单总金额。精确到小数点后两位,单位为
pay_amount
price
选填,建议传入该参数


实际支付金额。精确到小数点后两位。单位为
discount_amount
price



优惠金额。传入 discount_info_list  时必填。单位为
订单扩展字段
开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
l ext_key
string



订单状态 key。固定为 merchant_order_status
l ext_value
string



订单状态, 例: taked_goods
l ext_key
string



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



订单类型 value。本业务场景为: community_group
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) 的各项入参详情如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
address
string



字段名称:自提点地址 字段说明:团点地址
manager
string



字段名称:自提点团长 字段说明:脱敏称呼
end_time
string



字段名称:预计提货结束时间 字段说明:预计提货结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
brand_name
string



字段名称:品牌名 字段说明:盒马集市
start_time
string



字段名称:预计提货开始时间 字段说明:时间点,时间格式为 yyyy-mm-dd hh:mm:ss。
phone
string



字段名称:自提点电话 字段说明:虚拟号或固话
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}
quantity
number



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



商品单价。精确到小数点后两位。单位为 元。
注意:与 quantity 成对出现,若传了unit_price,则需要将 quantity 传入。
ext_info
orderextinfo



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



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



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



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



支付宝用户 uid。2088 开头的数字。
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相同的两次同步会被幂等处理。
source_app
string



订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其它来源枚举值定义联系支付宝订单中心添加.
item_order_list
itemorderinfo



商品信息列表。详情可查看下文 商品信息列表
ext_info
orderextinfo



订单扩展字段。详情可查看下文 订单扩展字段
trade_no
string



支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。
amount
price
选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)


订单总金额。精确到小数点后两位,单位为
pay_amount
price
选填,建议传入该参数


实际支付金额。精确到小数点后两位。单位为
discount_amount
price



优惠金额。传入 discount_info_list  时必填。单位为
订单扩展字段
开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
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。本业务场景为: community_group
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) 的各项入参详情如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
address
string



字段名称:自提点地址 字段说明:团点地址
manager
string



字段名称:自提点团长 字段说明:脱敏称呼
end_time
string



字段名称:预计提货结束时间 字段说明:预计提货结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
brand_name
string



字段名称:品牌名 字段说明:盒马集市
start_time
string



字段名称:预计提货开始时间 字段说明:时间点,时间格式为 yyyy-mm-dd hh:mm:ss。
phone
string



字段名称:自提点电话 字段说明:虚拟号或固话
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}
quantity
number



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



商品单价。精确到小数点后两位。单位为 元。
注意:与 quantity 成对出现,若传了unit_price,则需要将 quantity 传入。
ext_info
orderextinfo



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



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



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



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



支付宝用户 uid。2088 开头的数字。
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相同的两次同步会被幂等处理。
source_app
string



订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其它来源枚举值定义联系支付宝订单中心添加。
item_order_list
itemorderinfo



商品信息列表。详情可查看下文 商品信息列表
ext_info
orderextinfo



订单扩展字段。详情可查看下文 订单扩展字段
trade_no
string



支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。
amount
price
选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)


订单总金额。精确到小数点后两位,单位为
pay_amount
price
选填,建议传入该参数


实际支付金额。精确到小数点后两位。单位为
discount_amount
price



优惠金额。传入 discount_info_list  时必填。单位为
订单扩展字段
开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
l ext_key
string



订单状态 key。固定为 merchant_order_status
l ext_value
string



订单状态, 例: after_sales
l ext_key
string



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



订单类型 value。本业务场景为: community_group
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) 的各项入参详情如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
address
string



字段名称:自提点地址 字段说明:团点地址
manager
string



字段名称:自提点团长 字段说明:脱敏称呼
end_time
string



字段名称:预计提货结束时间 字段说明:预计提货结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
brand_name
string



字段名称:品牌名 字段说明:盒马集市
start_time
string



字段名称:预计提货开始时间 字段说明:时间点,时间格式为 yyyy-mm-dd hh:mm:ss。
phone
string



字段名称:自提点电话 字段说明:虚拟号或固话
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}
quantity
number



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



商品单价。精确到小数点后两位。单位为 元。
注意:与 quantity 成对出现,若传了unit_price,则需要将 quantity 传入。
ext_info
orderextinfo



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



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



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



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



支付宝用户 uid。2088 开头的数字。
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相同的两次同步会被幂等处理。
source_app
string



订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其它来源枚举值定义联系支付宝订单中心添加。
item_order_list
itemorderinfo



商品信息列表。详情可查看下文 商品信息列表
ext_info
orderextinfo



订单扩展字段。详情可查看下文 订单扩展字段
trade_no
string



支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。
amount
price
选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)


订单总金额。精确到小数点后两位,单位为
pay_amount
price
选填,建议传入该参数


实际支付金额。精确到小数点后两位。单位为
discount_amount
price



优惠金额。传入 discount_info_list  时必填。单位为
订单扩展字段
开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
l ext_key
string



订单状态 key。固定为 merchant_order_status
l ext_value
string



订单状态, 例: agree_return
l ext_key
string



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



订单类型 value。本业务场景为: community_group
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) 的各项入参详情如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
address
string



字段名称:自提点地址 字段说明:团点地址
manager
string



字段名称:自提点团长 字段说明:脱敏称呼
end_time
string



字段名称:预计提货结束时间 字段说明:预计提货结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
brand_name
string



字段名称:品牌名 字段说明:盒马集市
start_time
string



字段名称:预计提货开始时间 字段说明:时间点,时间格式为 yyyy-mm-dd hh:mm:ss。
phone
string



字段名称:自提点电话 字段说明:虚拟号或固话
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}
quantity
number



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



商品单价。精确到小数点后两位。单位为 元。
注意:与 quantity 成对出现,若传了unit_price,则需要将 quantity 传入。
ext_info
orderextinfo



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



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



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



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



支付宝用户 uid。2088 开头的数字。
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相同的两次同步会被幂等处理。
source_app
string



订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其它来源枚举值定义联系支付宝订单中心添加.
item_order_list
itemorderinfo



商品信息列表。详情可查看下文 商品信息列表
ext_info
orderextinfo



订单扩展字段。详情可查看下文 订单扩展字段
trade_no
string



支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。
amount
price
选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)


订单总金额。精确到小数点后两位,单位为元
pay_amount
price
选填,建议传入该参数


实际支付金额。精确到小数点后两位。单位为
discount_amount
price



优惠金额。传入 discount_info_list  时必填。单位为
订单扩展字段
开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
l ext_key
string



订单状态 key。固定为 merchant_order_status
l ext_value
string



订单状态, 例:no_return
l ext_key
string



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



订单类型 value。本业务场景为:community_group
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) 的各项入参详情如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
address
string



字段名称:自提点地址 字段说明:团点地址
manager
string



字段名称:自提点团长 字段说明:脱敏称呼
end_time
string



字段名称:预计提货结束时间 字段说明:预计提货结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
brand_name
string



字段名称:品牌名 字段说明:盒马集市
start_time
string



字段名称:预计提货开始时间 字段说明:时间点,时间格式为 yyyy-mm-dd hh:mm:ss。
phone
string



字段名称:自提点电话 字段说明:虚拟号或固话
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}
quantity
number



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



商品单价。精确到小数点后两位。单位为 元。
注意:与 quantity 成对出现,若传了unit_price,则需要将 quantity 传入。
ext_info
orderextinfo



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



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



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



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



支付宝用户 uid。2088 开头的数字。
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相同的两次同步会被幂等处理。
source_app
string



订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其它来源枚举值定义联系支付宝订单中心添加.
item_order_list
itemorderinfo



商品信息列表。详情可查看下文 商品信息列表
ext_info
orderextinfo



订单扩展字段。详情可查看下文 订单扩展字段
trade_no
string



支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。
amount
price
选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)


订单总金额。精确到小数点后两位,单位为
pay_amount
price
选填,建议传入该参数


实际支付金额。精确到小数点后两位。单位为
discount_amount
price



优惠金额。传入 discount_info_list  时必填。单位为
订单扩展字段
开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
l ext_key
string



订单状态 key。固定为 merchant_order_status
l ext_value
string



订单状态, 例: refunded
l ext_key
string



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



订单类型 value。本业务场景为: community_group
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) 的各项入参详情如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
address
string



字段名称:自提点地址 字段说明:团点地址
manager
string



字段名称:自提点团长 字段说明:脱敏称呼
end_time
string



字段名称:预计提货结束时间 字段说明:预计提货结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。
brand_name
string



字段名称:品牌名 字段说明:盒马集市
start_time
string



字段名称:预计提货开始时间 字段说明:时间点,时间格式为 yyyy-mm-dd hh:mm:ss。
phone
string



字段名称:自提点电话 字段说明:虚拟号或固话
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}
quantity
number



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



商品单价。精确到小数点后两位。单位为 元。
注意:与 quantity 成对出现,若传了unit_price,则需要将 quantity 传入。
ext_info
orderextinfo



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



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



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