查询合单订单

更新时间:2025.01.17

合单支付下单成功后,服务商(合单发起方)可调用该接口查询合单订单的交易状态。

注意:

请勿使用非合单支付的查单接口查询合单订单。

接口说明

支持商户:【普通服务商】

请求方式:【GET】/v3/combine-transactions/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)

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

请求示例

GET

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/combine-transactions/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_payer_info  选填 object

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

属性

sub_orders  选填 array[object]

【子单信息列表】】合单下单时传入的子单信息列表。

属性

scene_info  选填 object

【场景信息】下单时传入的支付场景描述,若下单传入该参数,则原样返回;若下单未传该参数,则不会返回。

属性

combine_out_trade_no  必填 string(32)

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

应答示例

200 OK

1{
2  "combine_appid" : "wxd678efh567hg6787",
3  "combine_mchid" : "1230000109",
4  "combine_payer_info" : {
5    "openid" : "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o"
6  },
7  "sub_orders" : [
8    {
9      "mchid" : "1900000109",
10      "trade_type" : "JSAPI",
11      "trade_state" : "SUCCESS",
12      "bank_type" : "CMC",
13      "attach" : "深圳分店",
14      "success_time" : "2015-05-20T13:29:35.120+08:00",
15      "amount" : {
16        "total_amount" : 10,
17        "payer_amount" : 10,
18        "currency" : "CNY",
19        "payer_currency" : "CNY",
20        "settlement_rate" : 650000000
21      },
22      "transaction_id" : "1009660380201506130728806387",
23      "out_trade_no" : "20150806125346",
24      "sub_mchid" : "1230000109",
25      "sub_appid" : "wxd678efh567hg6999",
26      "sub_openid" : "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
27      "promotion_detail" : [
28        {
29          "coupon_id" : "109519",
30          "name" : "单品惠-6",
31          "scope" : "GLOBAL",
32          "type" : "CASH",
33          "amount" : 100,
34          "stock_id" : "931386",
35          "wechatpay_contribute" : 0,
36          "merchant_contribute" : 0,
37          "other_contribute" : 0,
38          "currency" : "CNY",
39          "goods_detail" : [
40            {
41              "goods_id" : "M1006",
42              "quantity" : 1,
43              "unit_price" : 100,
44              "discount_amount" : 1,
45              "goods_remark" : "商品备注信息"
46            }
47          ]
48        }
49      ]
50    }
51  ],
52  "scene_info" : {
53    "device_id" : "POS1:1"
54  },
55  "combine_out_trade_no" : "1217752501201407033233368018"
56}

 

错误码

公共错误码

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

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

400

INVALID_REQUEST

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

请参阅接口规则检查传入的参数

401

SIGN_ERROR

验证不通过

请参阅签名常见问题排查

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

业务错误码

状态码

错误码

描述

解决方案

400

APPID_MCHID_NOT_MATCH

AppID和mch_id不匹配

请确认AppID和mch_id是否匹配,参考:查询商户号绑定的APPID

400

INVALID_REQUEST

无效请求

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

400

MCH_NOT_EXISTS

商户号不存在

请检查商户号是否正确,商户号获取方法参考:服务商模式开发必要参数说明

400

ORDER_CLOSED

订单已关闭

当前订单已关闭,请重新下单

401

SIGN_ERROR

签名错误

请检查签名参数和方法是否都符合签名算法要求,参考:如何生成签名

403

NOAUTH

商户无权限

请商户联系对接运营申请此接口相关权限,参考:权限申请

403

OUT_TRADE_NO_USED

商户订单号重复

请核实商户订单号是否重复提交

403

RULELIMIT

业务规则限制

因业务规则限制请求频率,请查看接口返回的详细信息

429

FREQUENCY_LIMITED

频率超限

请降低请求接口频率

500

SYSTEMERROR

系统错误

系统异常,请用相同参数重新调用

 

 

反馈
咨询
目录
置顶