开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
支付产品
私域产品
小程序产品
权限集列表
搜索关键词
搜索直达
收藏
消息
小程序码
小程序服务
订单中心
接入指南
各行业订单同步/查询详情
餐饮
零售批发
商业生活
交通出行
车主生活
教育培训
医疗卫生
酒旅景区
生活缴费
公共管理和社会组织
休闲娱乐
物流运输
网络通讯
api 列表
相关资料
小程序开发管理
生物核身
交易组件
小程序商品
支付有礼
商家粉丝群
支付宝电子发票
公域产品
营销产品
资金产品
会员产品
信用产品
安全产品
广告产品
开发 > 服务端 > 私域产品 > 小程序产品 > 权限集列表 > 订单中心 > 接入指南 > 各行业订单同步/查询详情 > 车主生活 > 储值动账(通用版)(stored_value_account_n)
收藏
订阅更新
我的文档
设置
接入检测
即可查看检测结果)
若有未通过的接入检测项,接口将无法调通
商家需通过 alipay.merchant.order.sync(订单数据同步接口) 订单扩展字段 ext_info#merchant_order_status 参数更新订单状态,具体状态说明如下。
订单状态流转说明

订单状态说明
支持跨状态传递,如:consume_s (消费成功) 可直接跳转至 timeout_closed (订单超时已关闭) 。
不要求首次同步订单状态必须为 consume_s (消费成功) 。
订单状态发生变更后,需要及时同步最新状态。
当前场景定义的订单状态(中文和英文名)如下:
状态中文名
状态英文名
是否发送服务消息
消费成功
consume_s

已退款
refunded

开卡成功
card_actived

消费失败
un_charge

充值成功
recharge_s

充值待圈存
to_be_loaded

圈存成功
successful_loading

退款待审核
refund_r

余额不足
balance

订单超时已关闭
timeout_closed

注意:不同订单状态,仅 是否发送服务消息 时,用户才能在消息列表(支付宝凯发k8官方网娱乐官方首页服务提醒入口进入或凯发k8官方网娱乐官方首页底部消息tab进入)查看服务订单消息提醒。
状态机流转
订单状态机流转如下(左侧表示起始状态,右侧表示允许的后置状态)
当前状态
允许的后置状态
consume_s(消费成功)
refund_r/退款待审核、 consume_s/消费成功、 to_be_loaded/充值待圈存、 refunded/已退款、 successful_loading/圈存成功、 un_charge/消费失败、 recharge_s/充值成功
refunded(已退款)
refunded/已退款
card_actived(开卡成功)
refund_r/退款待审核、 consume_s/消费成功、 to_be_loaded/充值待圈存、 timeout_closed/订单超时已关闭、 refunded/已退款、 successful_loading/圈存成功、 card_actived/开卡成功、 balance/余额不足、 un_charge/消费失败、 recharge_s/充值成功
un_charge(消费失败)
refund_r/退款待审核、 consume_s/消费成功、 to_be_loaded/充值待圈存、 refunded/已退款、 successful_loading/圈存成功、 balance/余额不足、 un_charge/消费失败、 recharge_s/充值成功
recharge_s(充值成功)
refund_r/退款待审核、 consume_s/消费成功、 to_be_loaded/充值待圈存、 refunded/已退款、 successful_loading/圈存成功、 balance/余额不足、 un_charge/消费失败、 recharge_s/充值成功
to_be_loaded(充值待圈存)
refund_r/退款待审核、 consume_s/消费成功、 to_be_loaded/充值待圈存、 timeout_closed/订单超时已关闭、 refunded/已退款、 successful_loading/圈存成功、 balance/余额不足
successful_loading(圈存成功)
refund_r/退款待审核、 consume_s/消费成功、 refunded/已退款、 successful_loading/圈存成功、 balance/余额不足
refund_r(退款待审核)
refund_r/退款待审核、 refunded/已退款
balance(余额不足)
refund_r/退款待审核、 consume_s/消费成功、 to_be_loaded/充值待圈存、 refunded/已退款、 successful_loading/圈存成功、 balance/余额不足、 un_charge/消费失败、 recharge_s/充值成功
timeout_closed(订单超时已关闭)
所有订单状态
不同状态参数使用说明
消费成功 (consume_s)
本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-消费成功 (consume_s)时需传入的商品信息及扩展字段参数信息。
接口参数 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相同的两次同步会被幂等处理。
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



商户总计优惠金额:代表商户侧给予用户的总计优惠金额 (不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】。




item_order_list
itemorderinfo



商品信息列表。详见下文: 商品信息列表
ext_info
orderextinfo



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



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



订单状态, 例: consume_s
l ext_key
string



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



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



字段名称:卡余额
字段说明:本次从卡内消费的金额,阿拉伯数字,单位元,小数点后两位。或者是其他剩余卡权益的相关信息
license_plate_number
string



公共交通车牌号
cardid
string



字段名称:乘车卡号
字段说明:用户乘车使用的卡编号
details
string



字段名称:卡权益详情
字段说明:本卡的权益
reminder
string



字段名称:温馨提示
字段说明:用户温馨提示/说明文案
card_category
string



字段名称:卡类别字段说明:刷卡代付场景下的卡类别
vehicle_type
string



字段名称:交通工具类型
字段说明:出行搭乘的交通工具类型
consumption_project
string



字段名称:消费项目
字段说明:本次消费的项目名称
public_transit_routes
string



字段名称:公共交通线路
字段说明:公共交通线路号/名称
schoolid
string



字段名称:学校库id
字段说明:特殊场景下需要返佣的服务商pid
card_name
string



字段名称:卡名称
字段说明:绑定卡片名称
consumption_amount
string



字段名称:消费金额
字段说明:本次从卡内消费的金额,阿拉伯数字,单位元,小数点后两位。或是其他类型的消费场景信息
rebate_pid
string



字段名称:服务商pid
字段说明:特殊场景下需要返佣的服务商pid
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}
ext_info
orderextinfo



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



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



商品图片 value。需传入 上传商品文件 获取的 material_id
l ext_key
string



商品描述 key。固定为 goodsdesc。
l ext_value
string



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



外部订单号。由商家自定义。
注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id
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相同的两次同步会被幂等处理。
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



商户总计优惠金额:代表商户侧给予用户的总计优惠金额 (不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】。



item_order_list
itemorderinfo



商品信息列表。详见下文: 商品信息列表
ext_info
orderextinfo



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



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



订单状态, 例: refunded
l ext_key
string



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



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



字段名称:学校库id
字段说明:特殊场景下需要返佣的服务商pid
cardid
string



字段名称:乘车卡号
字段说明:用户乘车使用的卡编号
refund_amount
string



字段名称:退款金额
字段说明:本次从退款的金额,阿拉伯数字,单位元,小数点后两位。
details
string



字段名称:卡权益详情
字段说明:本卡的权益
rebate_pid
string



字段名称:服务商pid
字段说明:特殊场景下需要返佣的服务商pid
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}
ext_info
orderextinfo



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



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



商品图片 value。需传入 上传商品文件 获取的 material_id
开卡成功 (card_actived)
本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-开卡成功 (card_actived)时需传入的商品信息及扩展字段参数信息。
接口参数 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相同的两次同步会被幂等处理。
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



商户总计优惠金额:代表商户侧给予用户的总计优惠金额 (不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】。



item_order_list
itemorderinfo



商品信息列表。详见下文: 商品信息列表
ext_info
orderextinfo



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



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



订单状态, 例: card_actived
l ext_key
string



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



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



字段名称:温馨提示
字段说明:用户温馨提示/说明文案
bind_card_instructions
string



绑卡说明
card_balance
string



字段名称:卡余额
字段说明:本次从卡内消费的金额,阿拉伯数字,单位元,小数点后两位。或者是其他剩余卡权益的相关信息
bind_card_time
string



字段名称:绑卡时间
字段说明:绑定卡片时间,时间格式为 yyyy-mm-dd hh:mm:ss。
cardid
string



字段名称:乘车卡号
字段说明:用户乘车使用的卡编号
card_name
string



字段名称:卡名称
字段说明:绑定卡片名称
details
string



字段名称:卡权益详情
字段说明:本卡的权益
rebate_pid
string



字段名称:服务商pid
字段说明:特殊场景下需要返佣的服务商pid
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}
ext_info
orderextinfo



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



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



商品图片 value。需传入 上传商品文件 获取的 material_id
消费失败 (un_charge)
本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-消费失败 (un_charge)时需传入的商品信息及扩展字段参数信息。
接口参数 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相同的两次同步会被幂等处理。
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



商户总计优惠金额:代表商户侧给予用户的总计优惠金额 (不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】。



item_order_list
itemorderinfo



商品信息列表。详见下文: 商品信息列表
ext_info
orderextinfo



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



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



订单状态, 例: un_charge
l ext_key
string



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



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



字段名称:消费项目
字段说明:本次消费的项目名称
card_balance
string



字段名称:卡余额
字段说明:本次从卡内消费的金额,阿拉伯数字,单位元,小数点后两位。或者是其他剩余卡权益的相关信息
cardid
string



字段名称:乘车卡号
字段说明:用户乘车使用的卡编号
consumption_amount
string



字段名称:消费金额
字段说明:本次从卡内消费的金额,阿拉伯数字,单位元,小数点后两位。或是其他类型的消费场景信息
rebate_pid
string



字段名称:服务商pid
字段说明:特殊场景下需要返佣的服务商pid
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}
ext_info
orderextinfo



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



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



商品图片 value。需传入 上传商品文件 获取的 material_id
充值成功 (recharge_s)
本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-充值成功 (recharge_s)时需传入的商品信息及扩展字段参数信息。
接口参数 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相同的两次同步会被幂等处理。
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



商户总计优惠金额:代表商户侧给予用户的总计优惠金额 (不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】。



item_order_list
itemorderinfo



商品信息列表。详见下文: 商品信息列表
ext_info
orderextinfo



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



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



订单状态, 例: recharge_s
l ext_key
string



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



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



字段名称:充值金额
字段说明:本次充值的金额,阿拉伯数字,单位元,小数点后两位。或者是对应的其他权益信息
card_balance
string



字段名称:卡余额
字段说明:本次从卡内消费的金额,阿拉伯数字,单位元,小数点后两位。或者是其他剩余卡权益的相关信息
recharge_time
string



字段名称:充值时间
字段说明:具体充值时间,时间格式为 yyyy-mm-dd hh:mm:ss。
schoolid
string



字段名称:学校库id
字段说明:特殊场景下需要返佣的服务商pid
cardid
string



字段名称:乘车卡号
字段说明:用户乘车使用的卡编号
details
string



字段名称:卡权益详情
字段说明:本卡的权益
rebate_pid
string



字段名称:服务商pid
字段说明:特殊场景下需要返佣的服务商pid
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}
ext_info
orderextinfo



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



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



商品图片 value。需传入 上传商品文件 获取的 material_id
l ext_key
string



商品描述 key。固定为 goodsdesc。
l ext_value
string



商品描述 value。
充值待圈存 (to_be_loaded)
本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-充值待圈存 (to_be_loaded)时需传入的商品信息及扩展字段参数信息。
接口参数 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相同的两次同步会被幂等处理。
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



商户总计优惠金额:代表商户侧给予用户的总计优惠金额 (不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】。



item_order_list
itemorderinfo



商品信息列表。详见下文: 商品信息列表
ext_info
orderextinfo



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



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



订单状态, 例: to_be_loaded
l ext_key
string



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



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



字段名称:充值金额
字段说明:本次充值的金额,阿拉伯数字,单位元,小数点后两位。或者是对应的其他权益信息
card_balance
string



字段名称:卡余额
字段说明:本次从卡内消费的金额,阿拉伯数字,单位元,小数点后两位。或者是其他剩余卡权益的相关信息
recharge_time
string



字段名称:充值时间
字段说明:具体充值时间,时间格式为 yyyy-mm-dd hh:mm:ss。
schoolid
string



字段名称:学校库id
字段说明:特殊场景下需要返佣的服务商pid
cardid
string



字段名称:乘车卡号
字段说明:用户乘车使用的卡编号
details
string



字段名称:卡权益详情
字段说明:本卡的权益
rebate_pid
string



字段名称:服务商pid
字段说明:特殊场景下需要返佣的服务商pid
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}
ext_info
orderextinfo



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



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



商品图片 value。需传入 上传商品文件 获取的 material_id
圈存成功 (successful_loading)
本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-圈存成功 (successful_loading)时需传入的商品信息及扩展字段参数信息。
接口参数 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相同的两次同步会被幂等处理。
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



商户总计优惠金额:代表商户侧给予用户的总计优惠金额 (不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】。



item_order_list
itemorderinfo



商品信息列表。详见下文: 商品信息列表
ext_info
orderextinfo



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



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



订单状态, 例: successful_loading
l ext_key
string



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



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



字段名称:充值金额
字段说明:本次充值的金额,阿拉伯数字,单位元,小数点后两位。或者是对应的其他权益信息
card_balance
string



字段名称:卡余额
字段说明:本次从卡内消费的金额,阿拉伯数字,单位元,小数点后两位。或者是其他剩余卡权益的相关信息
schoolid
string



字段名称:学校库id
字段说明:特殊场景下需要返佣的服务商pid
cardid
string



字段名称:乘车卡号
字段说明:用户乘车使用的卡编号
refund_amount
string



字段名称:退款金额
字段说明:本次从退款的金额,阿拉伯数字,单位元,小数点后两位。
details
string



字段名称:卡权益详情
字段说明:本卡的权益
rebate_pid
string



字段名称:服务商pid
字段说明:特殊场景下需要返佣的服务商pid
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}
ext_info
orderextinfo



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



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



商品图片 value。需传入 上传商品文件 获取的 material_id
l ext_key
string



商品描述 key。固定为 goodsdesc。
l ext_value
string



商品描述 value。
退款待审核 (refund_r)
本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-退款待审核 (refund_r)时需传入的商品信息及扩展字段参数信息。
接口参数 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相同的两次同步会被幂等处理。
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



商户总计优惠金额:代表商户侧给予用户的总计优惠金额 (不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】。



item_order_list
itemorderinfo



商品信息列表。详见下文: 商品信息列表
ext_info
orderextinfo



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



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



订单状态, 例: refund_r
l ext_key
string



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



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



字段名称:卡余额
字段说明:本次从卡内消费的金额,阿拉伯数字,单位元,小数点后两位。或者是其他剩余卡权益的相关信息
unbind_time
string



字段名称:解绑时间
字段说明:解绑时间,时间格式为 yyyy-mm-dd hh:mm:ss。
schoolid
string



字段名称:学校库id
字段说明:特殊场景下需要返佣的服务商pid
cardid
string



字段名称:乘车卡号
字段说明:用户乘车使用的卡编号
refund_amount
string



字段名称:退款金额
字段说明:本次从退款的金额,阿拉伯数字,单位元,小数点后两位。
unbind_instructions
string



解绑说明
details
string



字段名称:卡权益详情
字段说明:本卡的权益
rebate_pid
string



字段名称:服务商pid
字段说明:特殊场景下需要返佣的服务商pid
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}
ext_info
orderextinfo



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



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



商品图片 value。需传入 上传商品文件 获取的 material_id
余额不足 (balance)
本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-余额不足 (balance)时需传入的商品信息及扩展字段参数信息。
接口参数 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相同的两次同步会被幂等处理。
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



商户总计优惠金额:代表商户侧给予用户的总计优惠金额 (不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】。



item_order_list
itemorderinfo



商品信息列表。详见下文: 商品信息列表
ext_info
orderextinfo



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



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



订单状态, 例: balance
l ext_key
string



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



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



字段名称:卡余额字段说明:本次从卡内消费的金额,阿拉伯数字,单位元,小数点后两位。或者是其他剩余卡权益的相关信息
schoolid
string



字段名称:学校库id
字段说明:特殊场景下需要返佣的服务商pid
cardid
string



字段名称:乘车卡号
字段说明:用户乘车使用的卡编号
details
string



字段名称:卡权益详情
字段说明:本卡的权益
rebate_pid
string



字段名称:服务商pid
字段说明:特殊场景下需要返佣的服务商pid
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}
ext_info
orderextinfo



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



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



商品图片 value。需传入 上传商品文件 获取的 material_id
订单超时已关闭 (timeout_closed)
本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-订单超时已关闭 (timeout_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相同的两次同步会被幂等处理。
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



商户总计优惠金额:代表商户侧给予用户的总计优惠金额 (不包含选择支付宝付款时,支付宝给予的优惠减免金额),单位为【元】。



item_order_list
itemorderinfo



商品信息列表。详见下文: 商品信息列表
ext_info
orderextinfo



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



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



订单状态, 例: timeout_closed
l ext_key
string



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



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



字段名称:充值金额
字段说明:本次充值的金额,阿拉伯数字,单位元,小数点后两位。或者是对应的其他权益信息
card_balance
string



字段名称:卡余额
字段说明:本次从卡内消费的金额,阿拉伯数字,单位元,小数点后两位。或者是其他剩余卡权益的相关信息
consumption_time
string



字段名称:消费时间
字段说明:消费时间,时间格式为 yyyy-mm-dd hh:mm:ss。
cardid
string



字段名称:乘车卡号
字段说明:用户乘车使用的卡编号
refund_amount
string



字段名称:退款金额
字段说明:本次从退款的金额,阿拉伯数字,单位元,小数点后两位。
details
string



字段名称:卡权益详情
字段说明:本卡的权益
discount_explanation
string



字段名称:折扣说明
字段说明:折扣说明文案
consumption_project
string



字段名称:消费项目
字段说明:本次消费的项目名称
recharge_time
string



字段名称:充值时间
字段说明:具体充值时间,时间格式为 yyyy-mm-dd hh:mm:ss。
schoolid
string



字段名称:学校库id
字段说明:特殊场景下需要返佣的服务商pid
consumption_amount
string



字段名称:消费金额
字段说明:本次从卡内消费的金额,阿拉伯数字,单位元,小数点后两位。或是其他类型的消费场景信息
card_reader
string



字段名称:刷卡终端
字段说明:刷卡终端的设备信息
rebate_pid
string



字段名称:服务商pid
字段说明:特殊场景下需要返佣的服务商pid
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
参数类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}
ext_info
orderextinfo



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



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



商品图片 value。需传入 上传商品文件 获取的 material_id
l ext_key
string



商品描述 key。固定为 goodsdesc。
l ext_value
string



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