开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
支付产品
私域产品
小程序产品
权限集列表
搜索关键词
搜索直达
收藏
消息
小程序码
小程序服务
订单中心
接入指南
各行业订单同步/查询详情
餐饮
零售批发
商业生活
交通出行
车主生活
教育培训
医疗卫生
酒旅景区
生活缴费
公共管理和社会组织
休闲娱乐
物流运输
网络通讯
api 列表
相关资料
小程序开发管理
生物核身
交易组件
小程序商品
支付有礼
商家粉丝群
营销产品
资金产品
会员产品
信用产品
广告产品
开发 > 服务端 > 私域产品 > 小程序产品 > 权限集列表 > 订单中心 > 接入指南 > 各行业订单同步/查询详情 >  > 社区团购(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(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相同的两次同步会被幂等处理。
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。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185
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(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相同的两次同步会被幂等处理。
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。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185
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(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相同的两次同步会被幂等处理。
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。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185
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(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相同的两次同步会被幂等处理。
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。仅需传入小程序页面路径即可。商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185
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(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相同的两次同步会被幂等处理。
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。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185
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(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相同的两次同步会被幂等处理。
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。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185
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(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相同的两次同步会被幂等处理。
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。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185
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(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相同的两次同步会被幂等处理。
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。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185
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(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相同的两次同步会被幂等处理。
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。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185
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(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相同的两次同步会被幂等处理。
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。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185
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(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相同的两次同步会被幂等处理。
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。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185
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(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相同的两次同步会被幂等处理。
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。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185
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
该文档对你是否有帮助?
当前页面目录
网站地图