通用场景
订单结果通知
公共请求参数
| 参数 | 类型 | 是否必选 | 最大长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
| notify_id | string | 必选 | 50 | 通知id | 5608cccc09ddb39d41c2e3c06e3d9fejh2 |
| utc_timestamp | string | 必选 | 13 | 消息发送时的服务端时间 | 1514210452731 |
| msg_method | string | 必选 | 100 | 消息接口名称 | alipay.open.mini.order.changed |
| app_id | string | 必选 | 20 | 消息接受方的应用id | 2014060600164699 |
| version | string | 必选 | 5 | 版本号(1.1版本为标准消息) | 1.0或者1.1 |
| biz_content | string | 必选 | 消息报文 | 参见消息属性 | |
| sign | string | 必选 | 签名 | wco t3d8kg71dtlkwn7r9pzuoxeabjwp8/fousxcuskxsovyxbpsaidpryscjhcjmaglncjokjqlj28/asl93jotw39fx6i07lxhnbpknezalwmvpdnqui01hzszf9v1i6ggzjbiad5lg8bzttxzoj87ub2i9guj3nr/nuc9vey= | |
| sign_type | string | 必选 | 10 | 签名类型 | rsa2 |
| charset | string | 必选 | 10 | 编码集，该字符集为验签和解密所需要的字符集 | utf-8 |
消息属性
out_order_id｜商户订单号必选string(64)
【描述】商户订单号，创建订单请求由商户传入
【示例值】6823789339978248
order_id｜交易组件订单号必选string(128)
【描述】交易组件订单号
【示例值】2015042321001004720200028594
status｜交易状态必选string(64)
【描述】交易状态
【枚举值】
支付成功: paid
售后退款: refund_closed
已发货: delivered
【示例值】paid
operate_app_id｜开发者应用id必选string(64)
【描述】开发者应用id
【示例值】2019212310120031
auth_app_id｜授权方应用id必选string(64)
【描述】授权方应用id
【示例值】2020121313012901
total_amount｜订单金额必选string(11)
【描述】订单金额，单位：元,精确到小数点后两位
【示例值】12.12
receipt_amount｜实收金额必选string(11)
【描述】实收金额，单位：元，精确到小数点后两位。该金额为本笔交易，商户账户能够实际收到的金额
【示例值】88.88
secure_reason｜安全处置原因必选string(100)
【描述】平台处置退款原因
【示例值】投诉退款
group_buy_info｜拼团信息必选groupbuyinfo
【描述】拼团信息
group_id｜团id必选string(64)
【描述】团id
【示例值】12345
group_status｜团状态必选string(10)
【描述】拼团状态
【枚举值】
拼团失败: 0
拼团中: 1
拼团成功: 2
【示例值】0
以下参数 二选一 传入
user_id｜买家支付宝用户idstring(32)
【描述】买家支付宝用户id
新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认 应用-开发配置-openid配置管理 已启用。无该配置项，可查看openid配置申请。
【示例值】2088***
open_id｜用户openidstring(128)
【描述】买家open_id 详情可查看 openid简介
【示例值】074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5
trade_no｜支付宝交易号可选string(64)
【描述】支付宝交易号
【示例值】2013112011001004330000121536
voucher_detail_list｜券明细可选voucherdetailinfodto[]
【描述】券明细
id｜券id可选string(64)
【描述】券id
【示例值】2015102600073002039000002d5o
name｜券名称可选string(64)
【描述】券名称
【示例值】xx超市5折优惠
type｜优惠券类型可选string(500)
【描述】券类型
【枚举值】
全场代金券: alipay_fix_voucher
折扣券: alipay_discount_voucher
单品优惠券: alipay_item_voucher
【示例值】alipay_fix_voucher
amount｜优惠券金额可选string(64)
【描述】优惠券金额，单位：元，精确到小数点后两位。
【示例值】10.00
merchant_contribute｜商户出资金额可选string(11)
【描述】商户出资，单位为元,精确到小数点后两位
【示例值】9.00
other_contribute｜其他出资可选string(64)
【描述】其他出资，非交易商家，单位为元
【示例值】88.88
memo｜备注信息可选string(128)
【描述】备注信息
【示例值】备注信息
template_id｜券模板id可选string(64)
【描述】券模板id
【示例值】20171030000730015359000emzp0
purchase_merchant_contribute｜商户出资可选string(11)
【描述】购买该张券的资金中商户出资的部分，单位：元，精确到小数点后两位
【示例值】1.03
purchase_ant_contribute｜内部出资可选string(11)
【描述】购买该张券时内部出资的部分（包含支付宝/口碑出资的部分），单位：元，精确到小数点后两位
【示例值】1.03
purchase_buyer_contribute｜买家出资可选string(11)
【描述】购买该张券的资金中买家自己出资的部分，单位：元，精确到小数点后两位
【示例值】1.03
other_contribute_detail｜其他出资方明细可选contributedetailinfo[]
【描述】其他出资方明细
contribute_type｜其它出资方类型可选string(32)
【描述】出资方类型，如品牌商出资、支付宝平台出资...
【枚举值】
品牌商: brand
支付宝: platform
商户: merchant
【示例值】brand
contribute_amount｜其它出资方金额可选string(11)
【描述】其它出资方金额，单位：元，精确到小数点后两位
【示例值】8.00
settle_type｜账期标识可选string(64)
【描述】账期标识
【枚举值】
即时到账: normal
账期结算: extended
【示例值】normal
消息示例
默认示例
curl -x post 'notify_url' \
--header 'content-type: application/x-www-form-urlencoded; charset=utf-8' \
--data-urlencode 'charset=utf-8' \
--data-urlencode 'biz_content={
"out_order_id":"6823789339978248",
"user_id":"2088***",
"open_id":"074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5",
"order_id":"2015042321001004720200028594",
"trade_no":"2013112011001004330000121536",
"status":"paid",
"operate_app_id":"2019212310120031",
"auth_app_id":"2020121313012901",
"total_amount":"12.12",
"receipt_amount":"88.88",
"secure_reason":"投诉退款",
"group_buy_info":{
"group_status":"0",
"group_id":"12345"
},
"voucher_detail_list":[
{
"purchase_ant_contribute":"1.03",
"amount":"10.00",
"other_contribute_detail":[
{
"contribute_amount":"8.00",
"contribute_type":"brand"
}
],
"merchant_contribute":"9.00",
"purchase_buyer_contribute":"1.03",
"name":"xx超市5折优惠",
"memo":"备注信息",
"purchase_merchant_contribute":"1.03",
"other_contribute":"88.88",
"template_id":"20171030000730015359000emzp0",
"id":"2015102600073002039000002d5o",
"type":"alipay_fix_voucher"
}
],
"settle_type":"normal"
}' \
--data-urlencode 'utc_timestamp=${now}' \
--data-urlencode 'sign=${sign}' \
--data-urlencode 'app_id=${appid}' \
--data-urlencode 'version=1.1' \
--data-urlencode 'sign_type=rsa2' \
--data-urlencode 'notify_id=${notify_id}' \
--data-urlencode 'msg_method=alipay.open.mini.order.changed'说明：notify_url是开发者在开放平台控制台上设置的应用网关地址
通知应答
| 响应报文 | 描述 | 是否重试 | 是否区分大小写 |
|---|---|---|---|
| success | 消息处理成功 | 否 | 否 |
| fail | 消息处理失败 | 是 | 否 |
说明：消息服务会根据响应报文判断商户系统是否已经成功处理消息。如果http同步响应报文返回 success 字符串，消息服务则认为消息已经处理成功，停止投递，如果返回 fail ，表示消息获取失败，支付宝会根据投递重试策略重新发送消息到应用网关地址；
投递重试策略：一般情况下，25 小时以内完成 8 次通知，除了第一次是实时投递外，后续的每次重试都会间隔一段时间，间隔频率一般是：2m、10m、10m、1h、2h、6h、15h（第二次消息投递是在第一次投递失败后的 2 分钟；第三次投递是在第二次投递失败后的 10 分钟，以此类推）
接口工具
消息服务文档
获取sdk