4.1.5业务状态变更通知


使用场景:订单结果通知
接口编号:alipay.open.mini.order.changed
请求参数(bizdata):

参数 参数名称 取值 可空 类型 备注
out_order_id 商户订单号

由商家自定义

64个字符以内

仅支持字母、数字、下划线且需保证在商户端不重复

String(32)  
order_id 交易组件订单号

【描述】交易组件订单号

order_id和out_order_id二选一

【示例值】2015042321001004720200028594

String(128)  
trade_no 支付宝交易号   string(64)  
status 交易状态

【描述】交易状态

【枚举值】

支付成功: PAID

售后退款: REFUND_CLOSED

已发货: DELIVERED

已使用: DELIVERED_USED

确认收货: RECEIVED_CONFIRM

待支付: WAIT_PAY

超时关闭: TIMEOUT_CLOSED

交易撤销: CANCEL_CLOSED

string(64)  
operate_app_id 开发者应用ID   string(64)  
auth_app_id 授权方应用ID   string(64)  
total_amount 订单金额

【描述】订单金额

单位:元

精确到小数点后两位

【示例值】12.12

string(11)  
receipt_amount 实收金额

【描述】实收金额

单位:元

精确到小数点后两位

该金额为本笔交易

商户账户能够实际收到的金额

【示例值】88.88

string(11)  
secure_reason 安全处置原因

【描述】平台处置退款原因

【示例值】投诉退款

string(100)  
group_buy_info 拼团信息

【描述】拼团信息

详见本接口下方

数组类字段说明:

group_buy_info的明细字段

object[group_buy_info]  
user_id 买家支付宝用户ID   string(32)

user_id

open_id

二选一传入

必传

open_id 用户openId   string(128)
settle_type 账期标识

【描述】账期标识

【枚举值】

即时到账: normal

账期结算: extended

【示例值】normal

string(64)  
voucher_detail_list 券明细

【描述】券明细

详见本接口下方

数组类字段说明:

voucher_detail_list的明细字段

object[voucher_detail_list]  

通知应答:

参数 参数名称 是否重试 是否区分大小写
success 消息处理成功
fail 消息处理失败

说明:消息服务会根据响应报文判断商户系统是否已经成功处理消息。如果HTTP同步响应报文返回 success 字符串,消息服务则认为消息已经处理成功,停止投递,如果返回 fail ,表示消息获取失败,支付宝会根据投递重试策略重新发送消息到应用网关地址;
投递重试策略:一般情况下,25 小时以内完成 8 次通知,除了第一次是实时投递外,后续的每次重试都会间隔一段时间,间隔频率一般是:2m、10m、10m、1h、2h、6h、15h(第二次消息投递是在第一次投递失败后的 2 分钟;第三次投递是在第二次投递失败后的 10 分钟,以此类推)。

数组类字段说明
1.group_buy_info的详细字段

字段ID 字段名称 取值 可空 类型 备注
group_id 团ID   string(64)  
group_status 团状态

【描述】拼团状态

【枚举值】

拼团失败: 0

拼团中: 1

拼团成功: 3

待成团: 4

string(10)  

2.voucher_detail_list券明细的明细字段

字段ID 字段名称 取值 可空 类型 备注
id 券id 【描述】券id string(64)  
name 券名称 【描述】券名称 string(64)  
type

优惠券类

【描述】券类型

【枚举值】

全场代金券: ALIPAY_FIX_VOUCHER

折扣券: ALIPAY_DISCOUNT_VOUCHER

单品优惠券: ALIPAY_ITEM_VOUCHER

现金抵价券: ALIPAY_CASH_VOUCHER

商家全场券: ALIPAY_BIZ_VOUCHER

string(500)  
amount

优惠券

【描述】优惠券金额

单位:元

精确到小数点后两位

【示例值】10.00

string(64)  
merchant_contribute

商户出资

金额

【描述】商户出资

单位为元

精确到小数点后两位

【示例值】9.00

string(11)  
other_contribute 其他出资

【描述】其他出资,非交易商家

单位为元

【示例值】88.88

string(64)  
memo 备注信息 【描述】备注信息 string(128)  
template_id 券模板id 【描述】券模板id string(64)  
purchase_merchant_contribute 商户出资

【描述】

购买该张券的资金中商户出资的部分

单位:元

精确到小数点后两位

【示例值】1.03

string(11)  
purchase_ant_contribute 内部出资

【描述】

购买该张券时内部出资的部分

(包含支付宝/口碑出资的部分)

单位:元

精确到小数点后两位

【示例值】1.03

string(11)  
purchase_buyer_contribute 买家出资

【描述】

购买该张券的资金中买家自己出资的部分

单位:元

精确到小数点后两位

【示例值】1.03

string(11)  
other_contribute_detail

其他出资

方明细

【描述】其他出资方明细 object[other_contribute_detail]  

2-1)other_contribute_detail的明细字段

字段ID 字段名称 取值 可空 类型 备注
contribute_type 其它出资方类型

【描述】出资方类型

如品牌商出资、支付宝平台出资

【枚举值】

支付宝: PLATFORM

商户: MERCHANT

用户出资: USER

第三方机构: OTHER

string(32)  
contribute_amount 其它出资方金额

【描述】其它出资方金额

单位:元

精确到小数点后两位

【示例值】8.00

string(11)  

样例报文:
appid=00007751&bizdata=%7B%22voucher_detail_list%22%3A%5B%5D%2C%22total_amount%22%3A%2210%22%2C%22open_id%22%3A%220883cFGaAab_fBEtKjki0gYRk21tsDa30R4zTol_uT1ywc7%22%2C%22out_order_id%22%3A%22oid1721181456516%22%2C%22operate_app_id%22%3A%222021004147673402%22%2C%22trade_no%22%3A%22ZMCB99202407170000880068128921%22%2C%22auth_app_id%22%3A%222021004147673402%22%2C%22order_id%22%3A%222024071701502300000008830039515021%22%2C%22status%22%3A%22PAID%22%7D&cusid=990603054996018&event_type=alipay.open.mini.order.changed&id=2024071700262100407056304184007114&sign=DHMILbrVeu4P8cfsgDTBqIukc2%2B%2FxjSp98fcmvqHCt2LsYx5l0E930GP%2B4FGg0emkY9CutlaUkyvlIL2sDUGGJsaIqQD4YRiJRgPZ47aPIbYEOTeCGhfCXj4DFSW5ovgBY09NF6xdSmv4mKBnNcy8K5goyeW34Yv23l6%2B1PDAzs%3D&signtype=RSA


yinjr 2024年7月26日 16:40 收藏文档