用户到账通知
| 应用场景
商户给用户转账后，用户侧入账成功、或异常退款后，QQ钱包会把相关入账或退款结果发送给商户，商户需要接收处理，并返回应答。
如果QQ钱包收到商户的应答不是成功或超时，QQ钱包则认为通知失败，会通过一定的策略定期重新发起通知，尽可能提高通知的成功率，但QQ钱包不保证通知最终能成功。
| 接口地址
该链接是通过：企业付款到余额接口中提交的参数notify_url设置，如果链接无法访问，商户将无法接收到通知。
| 请求方式：POST
是否需要证书：否
| 通知参数
变量名 | 字段名 | 字段类型 | 必填 | 描述 | 示例 |
appid | 应用ID | String(32) | 否 | 应用ID。与调用付款接口时传入的appid保持一致，若未传appid则此字段为空。 | 1007033799 |
mch_id | 商户号 | String(32) | M | QQ钱包分配的商户号 | 1900000109 |
out_trade_no | 商户订单号 | String(36) | M | 外部商户订单号，商户调用发红包接口时传入的mch_billno | 1234567890201712011234567890 |
transaction_id | QQ钱包业务单号 | String(36) | M | QQ钱包订单号 | 19000056310201705061000000101985
|
openid | 收款用户openid | String(128) | 否 | 用户在商户appid下的唯一标识。与调用付款接口时传入的openid保持一致，若未传openid则此字段为空。 | 8876FE1B59DEC9F3ACDDB55835D3BB4B
|
uin | 收款用户QQ号码 | String(64) | 否 | 收款用户的QQ号码。与调用付款接口时传入的uin保持一致，若未传uin则此字段为空。 | 123456789
|
total_fee | 金额 | LONG | M | 商户订单总金额，单位为分，只能为整数 | 100 |
time_end | 时间(红包领取或退款成功时间) |
| M | YYYYMMDDHHMMSS | 20171204183926 |
state | 状态 | String(64) | M | RECEIVED:用户侧入账成功 REFUND:用户侧入账失败，退款成功 TRANSFERING:转账中 | RECEIVED |
refund_reason | 退款原因 | String(64) | O | 退款成功时填出： 1、收款方未实名 2、收款方简化用户余额超限 3、收款方反洗钱拦截
|
收款方未实名 |
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>
<refund_reason><![CDATA[transfer fail]]></refund_reason>
<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>