开发文档

支付结果

应用场景:

支付完成后,QQ钱包会把相关支付结果和用户信息发送给商户,商户需要接收处理,并返回应答,如果QQ钱包收到商户的应答不是成功或超时,QQ钱包则认为通知失败,会通过一定的策略定期重新发起通知,尽可能提高通知的成功率,但QQ钱包不保证通知最终能成功。

接口地址:

该链接即为商户通过【统一下单】接口中传入的参数notify_url,如果链接无法访问,商户将无法接收到通知

是否需要证书:

接口规则

· 为保证交易安全性,采用HTTPS传输

· 采用POST方法提交

· 统一采用UTF-8字符编码

 更多详情见接口规则


通知参数:

变量名

字段名

字段类型

必须

备注

示例

appid

应用ID

String(32)

腾讯开放平台或QQ互联平台审核通过的应用APPID

1007033799

sub_appid

子商户应用ID

String(32)

腾讯开放平台或QQ互联平台审核通过的应用APPID

1007033790

mch_id

商户号

String(32)

QQ钱包分配的商户号

1900000109

sub_mch_id

子商户号

String(32)

子商户号或商户识别码

19000001099000000101

nonce_str

随机字符串

String(32)

随机字符串,不长于32位。

3e5a036cb4bc3a677a38ad9d69eb3feb

sign

签名

String(128)

商户签名,详见商户签名算法规则 

C380BEC2BFD727A4B6845133519F3AD6

device_info

设备号

String(32)

调用接口提交的终端设备号

013467007045764

trade_type

支付场景

String(16)

MICROPAYAPPJSAPINATIVE

MICROPAY

trade_state

支付状态

String(32)

固定值Success

Success

bank_type

付款银行

String(16)

银行类型,采用字符串类型的银行标识,值列表详见付款银行列表

CCB_DEBIT

fee_type

货币类型

String(16)

默认为人民币:CNY

CNY

total_fee

订单金额

Int

商户订单总金额,单位为分,只能为整数,详见订单金额 

888

cash_fee

用户支付金额

Int

用户本次交易中,实际支付的金额

666

coupon_fee

QQ钱包优惠金额

Int

本次交易中,QQ钱包提供的优惠金额

666

transaction_id

QQ钱包订单号

String(32)

QQ钱包订单号

128355470147160281308949397

out_trade_no

商户订单号

String(32)

商户系统内部的订单号,32个字符内、可包含字母。其它说明见 商户订单号

1283554701201610284030938474

attach

附加数据

String(128)

附加数据,在查询API和支付通知中原样返回,该字段主要用于商户携带订单的自定义数据

说明

time_end

支付完成时间

String(14)

订单支付时间,格式为yyyyMMddHHmmss,如2009122591010秒表示为20091225091010

20141030133525

openid

用户标识

String(128)

用户在商户appid下的唯一标识

oUpF8uMuAJO_M2pxb1Q9zNjWeS6o

sub_openid

子商户用户标识

String(128)

用户在子商户appid下的唯一标识

oUpF8uMuAJO_M2pxb1Q9zNjWeS6o

 示例如下:

<xml>

    <appid><![CDATA[1104606907]]></appid>

    <attach><![CDATA[ATTACHEND=&END]]></attach>

    <bank_type><![CDATA[BALANCE]]></bank_type>

    <cash_fee><![CDATA[1]]></cash_fee>

    <device_info><![CDATA[WP00000001]]></device_info>

    <fee_type><![CDATA[CNY]]></fee_type>

    <mch_id><![CDATA[1900000109]]></mch_id>

    <nonce_str><![CDATA[7b14db232445d79c5c86d22bbd8898d3]]></nonce_str>

    <openid><![CDATA[D60EFFA28D0698EF57CFC9118C149E94]]></openid>

    <out_trade_no><![CDATA[20161025_qpay_unified_order_A]]></out_trade_no>

    <sign><![CDATA[DE4335434F33C065C449E261DCE08BCF]]></sign>

    <time_end><![CDATA[20161025094946]]></time_end>

    <total_fee><![CDATA[1]]></total_fee>

    <trade_state><![CDATA[SUCCESS]]></trade_state>

    <trade_type><![CDATA[NATIVE]]></trade_type>

    <transaction_id><![CDATA[1900000109471610251307259064]]></transaction_id>

</xml>

商户处理后同步返回给QQ钱包参数:

变量名

字段名

类型

必填

描述

示例

return_code

返回状态码

String(16)

SUCCESS/FAILSUCCESS表示商户接收通知成功并校验成功

SUCCESS

return_msg

返回信息

String(128)

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

签名失败

示例如下:

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