开发文档

订单查询

应用场景:

该接口提供所有手Q钱包订单的查询,商户可以通过该接口主动查询订单状态,完成下一步的业务逻辑。
需要调用查询接口的情况:

◆  当商户后台、网络、服务器等出现异常,商户系统最终未接收到支付通知;

◆  调用支付接口后,返回系统错误或未知交易状态情况;

◆  调用 qpay_micro_pay.cgi  提交付款码支付接口,返回USERPAYING 的状态;

◆  调用 qpay_reverse.cgi 撤销订单接口之前,需确认支付状态;

接口地址:

https://qpay.qq.com/cgi-bin/pay/qpay_order_query.cgi

是否需要证书:

接口规则

· 为保证交易安全性,采用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)

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

5K8264ILTKCH16CQ2502SI8ZNMTM67VS

transaction_id

QQ钱包订单号 

String(32)

二选一

QQ钱包订单号,优先使用请求30天或更久之前支付的订单时,此参数不能为空。

1353933301461607211903715555

out_trade_no

商户订单号

String(32)

二选一

商户系统内部的订单号,32个字符内、可包含字母,说明见商户订单号,当没传入transaction_id时必须传该参数

20150806125346

示例如下:

   <xml>

       <appid>1104606907</appid>

       <mch_id>1900000109</mch_id>

       <nonce_str>f61bf55a116ef0c822122956de9b6e93</nonce_str>

       <out_trade_no>1242016071230000008947</out_trade_no>

       <sign>276911cbd39896dc436eb104c10404d4</sign>

       <ver>1.0</ver>

    </xml>

 

返回结果:

变量名

字段名

类型

必填

描述

示例

return_code

返回状态码

String(16)

SUCCESS/FAIL 此字段是通信标识,非交易标识,交易是否成功需要查看trade_state来判断

SUCCESS

return_msg

返回信息

String(128)

返回信息,如非空,为错误原因 

签名失败

retcode

Q CGI原始错误码

String(16)

原始错误码

10025

retmsg

Q CGI原始错误信息

String(128)

原始错误信息

系统繁忙

 

下列字段,在return_code为成功时有返回:

变量名

字段名

类型

必填

描述

示例

appid

Q商户公众号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

sign

商户签名算法规则

String(128)

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

5K8264ILTKCH16CQ2502SI8ZNMTM67VS

result_code

业务结果

String(32)

SUCCESS/FAIL

SUCCESS

err_code

错误代码

String(32)

详情见错误代码 

SYSTEMERROR 

err_code_des

错误代码描述

String(128)

错误返回的信息描述

系统繁忙 

nonce_str

随机字符串

String(32)

随机字符串,不长于32

3e5a036cb4bc3a677a38ad9d69eb3feb 

 

下列字段,在result_code为成功时有返回:

变量名

字段名

类型

必填

描述

示例

device_info

设备号

String(32)

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

013467007045764

trade_type

支付场景

String(16)

MICROPAYAPPJSAPINATIVE

MICROPAY

trade_state

交易状态

String(32)

SUCCESS 支付成功  

REFUND 转入退款

REVOKED订单已撤销

CLOSED 订单已关闭 

USERPAYING 用户支付中  

SUCCESS

bank_type

付款银行

String(16)

银行类型,采用字符串类型的银行标识

CCB_DEBIT

fee_type

货币类型

String(16)

默认为人民币:CNY

CNY

total_fee

订单金额

Int

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

888

cash_fee

用户支付金额

Int

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

888

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

trade_state_desc

交易状态描述

String(256)

对当前查询订单状态的描述和下一步操作的指引

支付失败,请重新下单支付

openid

用户标识

String(128)

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

oUpF8uMuAJO_M2pxb1Q9zNjWeS6o

sub_openid

子商户用户标识

String(128)

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

oUpF8uMuAJO_M2pxb1Q9zNjWeS6o

示例如下:

  <xml>

      <retcode><![CDATA[0]]></retcode>

      <retmsg><![CDATA[ok]]></retmsg>

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

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

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

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

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

      <nonce_str><![CDATA[235172f93045bc978cfef418e151cc0c]]></nonce_str>

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

      <out_trade_no><![CDATA[1242016071230000008947]]></out_trade_no>

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

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

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

      <sign><![CDATA[505c28fd7e91c4ac8ebc3ec379750590]]></sign>

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

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

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

      <trade_state_desc><![CDATA[交易成功]]></trade_state_desc>

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

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

  </xml>


错误码:

错误码

描述

原因

解决办法

ORDERNOTEXIST

此交易订单号不存在

查询系统中不存在此交易订单号

请商户检查需要查询的订单号是否正确 , 根据实际的情况判断,是否要关闭订单,禁止用户进行支付。

SYSTEMERROR

系统错误

系统错误

系统异常,请参数不变,重新调用该API