支付结果
应用场景:
支付完成后,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) | 是 | 子商户号或商户识别码 | 1900000109或9000000101 |
nonce_str | 随机字符串 | String(32) | 是 | 随机字符串,不长于32位。 | 3e5a036cb4bc3a677a38ad9d69eb3feb |
sign | 签名 | String(128) | 是 | 商户签名,详见商户签名算法规则 | C380BEC2BFD727A4B6845133519F3AD6 |
device_info | 设备号 | String(32) | 否 | 调用接口提交的终端设备号 | 013467007045764 |
trade_type | 支付场景 | String(16) | 是 | MICROPAY、APP、JSAPI、NATIVE | 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,如2009年12月25日9点10分10秒表示为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>
<sub_appid><![CDATA[1104606907]]></sub_appid>
<sub_mch_id><![CDATA[9040000001]]></sub_mch_id>
<sub_openid><![CDATA[D60EFFA28D0698EF57CFC9118C149E94]]></sub_openid>
<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/FAIL,SUCCESS表示商户接收通知成功并校验成功 | SUCCESS |
return_msg | 返回信息 | String(128) | 否 | 返回信息,如非空,为错误原因:签名失败。参数格式校验错误 | 签名失败 |
<xml>
<return_code>SUCCESS</return_code>
</xml>