使用场景:订单结果通知
接口编号: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