领取结果通知
| 应用场景
商户给用户转账或者发红包后,用户领红包入账成功,QQ钱包会把相关入账结果发送给商户,商户需要接收处理,并返回应答。超时或异常退款的情况需要商户主动调用查单接口获取结果。
| 接口地址
该链接是通过:创建企业红包接口中提交的参数notify_url设置,如果链接无法访问,商户将无法接收到通知。
| 请求方式:POST
是否需要证书:否
| 通知参数
变量名 | 字段名 | 字段类型 | 必填 | 描述 | 示例 |
appid | 应用ID | String(32) | 否 | 商户在创建企业红包接口中传入的appid | 1007033799 |
mch_id | 商户号 | String(32) | M | QQ钱包分配的商户号 | 1900000109 |
out_trade_no | 商户订单号 | String(36) | M | 外部商户订单号,商户调用发红包接口时传入的mch_billno | 1234567890201712011234567890 |
transaction_id | QQ钱包业务单号 | String(36) | M | 企业红包业务:该字段为该笔企业红包的红包单号:listid 企业付款业务:该字段为QQ钱包订单号 | 19000056310201705061000000101985
|
openid | 收款用户 | String(128) | M | 用户在商户appid下的唯一标识(没有appid话该值为uin) | 8876FE1B59DEC9F3ACDDB55835D3BB4B
|
total_fee | 金额 | LONG | M | 商户订单总金额,单位为分,只能为整数,详见交易金额 | 100 |
time_end | 时间(红包领取或退款成功时间) |
| M | YYYY-MM-DD HHMMSS | 2017-12-04 18:39:26 |
state | 状态 | INT | M | 1:入账成功;2:退款 | 1 |
attach | 商户附加数据 |
| O | 原值返回商户请求时的数据 | QQ支付 |
sign | 签名 | String(128) | M | 商户签名 | 5K8264ILTKCH16CQ2502SI8ZNMTM67VS
|
sign_type | 签名类型 | String(16) | M | RSA2048:数字证书 MD5:MD5签名 | MD5 |
示例如下:
<xml>
<mch_id><![CDATA[1104606907]]></mch_id>
<mch_billno><![CDATA[29840058602]]></mch_billno>
<listid><![CDATA[10000436560988432048]]></listid>
<recv_uin><![CDATA[2344546]]></recv_uin>
<total_fee><![CDATA[10]]></total_fee>
<time_end><![CDATA[20161025094946]]></time_end>
<state><![CDATA[RECEIVED]]></state>
<sign><![CDATA[DE4335434F33C065C449E261DCE08BCF]]></sign>
<sign_type><![CDATA[MD5]]></sign_type>
</xml>
| 商户处理后同步返回给QQ钱包参数
变量名 | 字段名 | 类型 | 必填 | 描述 | 示例 |
return_code | 返回状态码 | String(16) | M | SUCCESS/FAIL,SUCCESS表示商户接收通知成功并校验成功 | SUCCESS |
return_msg | 返回信息 | String(128) | O | 返回信息,如非空,为错误原因:签名失败。参数格式校验错误 | 签名失败 |
<xml>
<return_code>SUCCESS</return_code>
</xml>