开发文档

关闭订单

应用场景(APPJSAPINATIVE支付使用):

以下情况需要调用关单接口:

1、商户订单支付失败需要生成新单号重新发起支付,要对原订单号调用关单,避免重复支付;

2、系统下单后,用户支付超时,系统退出不再受理,避免用户继续,请调用关单接口;

注意:订单生成后不能马上调用关单接口,最短调用时间间隔为5分钟。 

接口地址:

https://qpay.qq.com/cgi-bin/pay/qpay_close_order.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)

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

C380BEC2BFD727A4B6845133519F3AD6

out_trade_no

商户订单号

String(32)

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

20150806125346

total_fee

订单金额

Int

订单总金额,单位为分,只能为整数,详见交易金额 

888

示例如下:

   <xml>

       <mch_id>1301278501</mch_id>

       <nonce_str>b3dd0d076baf72459d7ebe5eb3422cb1</nonce_str>

       <out_trade_no>2016061235213677</out_trade_no>

       <sign>8bf35c2fd0ca5f0ee0d23a2c0d73f912</sign>

   </xml>

 

返回结果:

变量名

字段名

类型

必填

描述

示例

return_code

返回状态码

String(16)

SUCCESS/FAIL

SUCCESS

return_msg

返回信息

String(128)

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

签名失败

retcode

Q CGI原始错误码

String(16)

原始错误码

10025

retmsg

Q CGI原始错误信息

String(128)

原始错误信息

系统繁忙


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

变量名

字段名

类型

必填

描述

示例

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

sign

商户签名算法规则

String(128)

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

C380BEC2BFD727A4B6845133519F3AD6

result_code

业务结果

String(32)

SUCCESS/FAIL

SUCCESS

err_code

错误代码

String(32)

详情见错误代码 

SYSTEMERROR 

err_code_des

错误代码描述

String(128)

错误返回的信息描述

系统繁忙 

nonce_str

随机字符串

String(32)

随机字符串,不长于32

3e5a036cb4bc3a677a38ad9d69eb3feb

示例如下:

   <xml>

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

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

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

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

       <nonce_str><![CDATA[775bfd4126b2eb8e2e70dda568e3fa31]]></nonce_str>

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

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

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

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

   </xml>


错误码:

错误码

描述

原因

解决办法

SYSTEMERROR

系统错误

系统错误

请立即调用被扫订单结果查询API,查询当前订单状态,并根据订单的状态决定下一步的操作。

ORDERPAID

订单已支付

订单已支付,不能发起关单

订单已支付,不能发起关单,请当作已支付的正常交易

ORDERNOTEXIST

订单不存在

订单系统不存在此订单

不需要关单,当作未提交的支付的订单

ORDERCLOSED

订单已关闭

订单已关闭,无法重复关闭

订单已关闭,无需继续调用

PARAM_ERROR

参数错误

请求参数未按指引进行填写

请根据接口返回的详细信息检查您的程序

REQUIRE_POST_METHOD

请使用post方法

未使用post传递参数

请检查请求参数是否通过post方法提交,不要使用GET

SIGNERROR

签名错误

参数签名结果不正确

请检查签名参数和方法是否都符合签名算法要求

XML_FORMAT_ERROR

XML格式错误

XML格式错误


请检查XML参数格式是否正确