还款单查询

更新时间:2025.06.19
||

商户通过还款单查询订单API查询订单状态,完成下一步的业务逻辑。

需要调用查询接口的情况:

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

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

  3. 调用关单或撤销接口API之前,需确认支付状态。

接口说明

支持商户:【平台商户】

请求方式:【GET】/v3/repayment/combine-transactions/partner/out-trade-no/{combine_out_trade_no}

请求域名:【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

     【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点 ,指引点击查看

请求参数

Header  HTTP头参数

 Authorization  必填 string

请参考签名认证生成认证信息


 Accept  必填 string

请设置为application/json


path  路径参数

 combine_out_trade_no  必填   string(32)

【还款单订单号】 商户系统内部对交易单定义的订单号,要求32个字符内,只能是数字、大小写字母_-|*@ ,且在同一个商户号下唯一。

请求示例

curl
Java
Go

GET

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/repayment/combine-transactions/partner/out-trade-no/P20150806125346 \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" 
5

应答参数
折叠全部参数

200 OK

 combine_appid  必填   string(32)

【还款服务商APPID】 下单时传入的还款服务商的APPID。


 combine_mchid  必填   string(32)

【还款服务商商户号】 下单时传入的还款服务商商户号。


 combine_out_trade_no  必填   string(32)

【还款单订单号】 下单时传入的还款商户订单号。


 combine_transaction_id  必填   string(32)

【还款单微信支付订单号】 微信支付系统生成的交易单订单号


 combine_payer_info  选填   object

【还款支付者信息】 还款订单支付者的信息,支付成功后返回。

属性

 openid  选填   string(128)

【用户服务商标识】 实际支付的用户在combine_appid下对应的openid


 sub_orders  选填   array[object]

【还款明细单信息列表】 最多支持子单条数:10

属性

 mchid  必填   string(32)

【还款单发起商户号】 还款单发起方商户号,即合作伙伴商户号


 sub_mchid  选填   string(32)

【子商户号(也叫特约商户号)】 还款下单时传入的子商户号。


 out_trade_no  必填   string(32)

【还款明细单订单号】 还款下单时传入的还款明细单订单号。


 transaction_id  选填   string(32)

【还款明细单微信支付订单号】 微信支付侧为每个子单分配的唯一标识,订单支付成功后返回。


 trade_type  选填   string(16)

【交易类型】 当前订单的交易类型,支付成功后返回,枚举值:REPAYMENT:还款支付


 trade_state  必填   string(32)

【交易状态】 交易状态,交易状态,详细业务流转状态处理请参考开发指引-订单状态流转图。枚举值:

  • SUCCESS:支付成功

  • NOTPAY:未支付

  • CLOSED:已关闭


 bank_type  选填   string(32)

【付款银行】 用户支付方式,订单支付成功后返回,
1、使用银行卡支付,例如工商银行借记卡,该字段返回 ICBC_DEBIT,更多银行类型请参考《银行类型对照表》。
2、使用非银行卡支付,例如余额/零钱通等,该字段统一返回OTHERS


 attach  选填   string(128)

【商户数据包】 服务商下单时传入的自定义数据包,用户不可见,长度不超过128字符,若下单传入该参数,则订单支付成功后此接口和回调通知接口以及交易账单中会原样返回;若下单未传该参数,则不会返回。


 success_time  选填   string(32)

【支付完成时间】 1、定义:用户完成订单支付的时间。
2、格式:遵循rfc3339标准格式:yyyy-MM-DDTHH:mm:ss+TIMEZONEyyyy-MM-DD 表示年月日;T 字符用于分隔日期和时间部分;HH:mm:ss 表示具体的时分秒;TIMEZONE 表示时区(例如,+08:00 对应东八区时间,即北京时间)。
示例:2015-05-20T13:29:35+08:00 表示北京时间2015年5月20日13点29分35秒。


 amount  选填   object

【子单金额信息】 子订单收款金额信息,订单支付成功后返回。

属性

 total_amount  必填   integer

【标价金额】 子单金额,单位为分,整型。


 payer_amount  必填   integer

【用户支付金额】 用户支付金额,整型,单位为分。


 currency  必填   string(16)

【标价币种】 下单时传入的标价币种。


 payer_currency  必填   string(16)

【现金支付币种】 用户实际支付的币种,符合ISO 4217标准的三位字母代码。例如:CNY,代表人民币。

应答示例

200 OK

1{
2  "combine_appid" : "wxd678efh567hg6787",
3  "combine_mchid" : "1230000109",
4  "combine_out_trade_no" : "P20150806125346",
5  "combine_transaction_id" : "1217752501201407033233368018",
6  "combine_payer_info" : {
7    "openid" : "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o"
8  },
9  "sub_orders" : [
10    {
11      "mchid" : "1230000109",
12      "sub_mchid" : "1900000109",
13      "out_trade_no" : "20150806125346",
14      "transaction_id" : "1009660380201506130728806387",
15      "trade_type" : "JSAPI",
16      "trade_state" : "SUCCESS",
17      "bank_type" : "CMC",
18      "attach" : "深圳分店",
19      "success_time" : "2015-05-20T13:29:35.120+08:00",
20      "amount" : {
21        "total_amount" : 10,
22        "payer_amount" : 10,
23        "currency" : "CNY",
24        "payer_currency" : "CNY"
25      }
26    }
27  ]
28}
29

 

错误码

以下是本接口返回的错误码列表。详细错误码规则,请参考微信支付接口规则-错误码和错误提示

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

请根据错误提示正确传入参数

400

INVALID_REQUEST

HTTP 请求不符合微信支付 APIv3 接口规则

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

 

 

元宝AI
反馈
目录
置顶