开发文档

领取结果通知

| 应用场景

商户给用户转账或者发红包后,用户领红包入账成功,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:数字证书

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>

   <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>