开发文档

用户到账通知

| 应用场景

商户给用户转账后,用户侧入账成功、或异常退款后,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:数字证书

MD5MD5签名

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/FAILSUCCESS表示商户接收通知成功并校验成功

SUCCESS

return_msg

返回信息

String(128)

O

返回信息,如非空,为错误原因:签名失败。参数格式校验错误

签名失败

示例如下:

<xml>

<return_code>SUCCESS</return_code>
</xml>