4.1.2 交易查询 - 汇联开放平台

1.功能说明：
（1）针对已发起的交易，可通过该接口发起交易结果查询
（2）建议查询频率：10秒一次

2. 适用场景：
（1）付款码支付，发起支付请求后，未得到交易终态
（2）发起支付请求后，未收到交易结果通知
（3）发起支付请求后，返回系统错误或未知交易状态
（4）调用交易关闭接口之前，调用查询接口确认状态

请求参数

Body 参数application/json

appId

string

应用APPID

必需

商户应用APPID

subSn

string | null

子商户编码

可选

非必传项，目前仅代理商/服务商可传，普通商户和平台商户请勿传入

timestamp

string

时间戳

必需

请求时间戳单位秒，要求timestamp与当前时间间隔在60秒以内

requestId

string

请求id

必需

请求唯一标识，无其他意义，必须每一次请求不允许重复，用于定位问题

signType

string

签名方式

必需

固定值：RSA2

bizContent

object

请求参数

必需

由于工具限制，该字段必须转为JSON 格式字符串，请注意

mchOrderNo

string

商户单号

可选

与平台单号必传一项

payOrderNo

string

平台单号

可选

与商户单号必传一项

sign

string

签名

必需

参照签名方法

示例

{
    "appId": "APP_8428691003",
    "subSn": null,
    "timestamp": "1736152440",
    "requestId": "6f424365-9206-4030-9bca-813cb85fb04f",
    "signType": "RSA2",
    "bizContent": {
        "mchOrderNo": "a64159d9-b425-408b-80b3-e19c2503666b",
        "payOrderNo": "nisi sint ipsum ullamco"
    },
    "sign": "H6oAMOljItjCsEC72RmZ/s9VFg/BFZbv3oPtUKjoM7w3jeNgCLOrFASD0o3Qbesnd9xkCbT62IJt/sNBvs47ja02X2QGBYg5+aXIZ6zn6Uu+HegqdMYBTtjrY3t2sBHVr+QK5mZo59Ic7baVEz4NTBkS/BPbtlrwIvbcqq9quSZ5vCyBt/nkXUNy0JgxtzCofwT8I4pKWUQcWovI+AIt/a0wW8VOcoKA+vif4DmiNK0BitypOYpr4aFDZodj8DYdBRXQFA12KRCk1q3HERvQSLE33FAg+xF+LOKy2zLucqdjgzBSwne0CVOhjKDXU9EdQO1bH+fRam9A83HT0sUJsw=="
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200OK

application/json

Body

code

integer

请求状态

必需

返回200=成功，其他状态均为失败

data

object

返回数据体

可选

mchOrderNo

string

商户订单号

必需

payOrderNo

string

平台订单号

必需

channelOrderNo

string

渠道订单号

可选

第三方渠道订单号

instOrderNo

string

支付机构订单号

可选

微信支付宝等平台订单号

payDataType

string

支付数据类型

可选

pay_url-支付链接，data-数据体，none-空支付参数

payInfo

string

跳转支付数据

可选

state

string

订单状态

必需

只有条码支付才会返回，条码订单状态，订单状态，1=初始化，2=支付中，3=支付成功，4=已撤销，5=订单关闭 6=订单关闭中 7=支付失败

amount

string

订单金额

必需

单位元

payAmount

string

实际支付金额

可选

单位元

payType

string

支付类型

必需

WECHAT: 微信 ALIPAY: 支付宝 UNION_PAY: 云闪付 DIGITAL: 数字人民币

paySubType

string

支付方式

必需

NATIVE :扫码支付； SCAN : 反扫支付； JSAPI :微信JSAPI、支付宝JSAPI支付、银联JSAPI支付； SIMPLE :简易支付； MINI_APP :微信小程序支付、支付宝小程序支付； H5 :h5 支付； APP :APP 支付； PC :支付宝PC支付

sceneType

integer

场景类型

可选

1 线下 2 线上不传默认线下

providerCode

string

服务商编码

可选

channelCode

string

通道编码

可选

subChannelId

string

子通道id

可选

feeAmount

string

平台扣手续费

可选

feeRate

string

平台扣手续费率

可选

channelFeeAmount

string

通道扣手续费

可选

channelFeeRate

string

通道扣手续费率

可选

settlementAmount

string

实际记账金额

可选

即 amount-feeAmount-channelFeeAmount

subject

string

商品标题

可选

description

string

商品描述

可选

successTime

integer

支付成功时间

可选

单位毫秒

fundFreezeStat

integer

资金冻结状态

可选

1：冻结，0：解冻，仅微信小程序被管控的商户号才会返回

freezeTime

integer

资金冻结时间

可选

仅微信小程序被管控的商户号才会返回

unfreezeAmt

string

资金解冻金额

可选

仅微信小程序被管控的商户号才会返回，单位元

unfreezeTime

integer

资金解冻时间

可选

仅微信小程序被管控的商户号才会返回

msg

string

返回信息

必需

appId

string

应用APPID

可选

string

商户编码

可选

sign

string

签名

可选

timestamp

string

时间戳

可选

signType

string

签名方式目前仅支持RSA2

可选

示例

{
    "code": 200,
    "data": {
        "mchOrderNo": "eu in laborum ex",
        "payOrderNo": "cillum id",
        "channelOrderNo": "adipisicing cillum dolor occaecat",
        "instOrderNo": "nisi",
        "payDataType": "pariatur exercitation mollit sed laboris",
        "payInfo": "irure incididunt consectetur",
        "state": "四川省",
        "amount": "798.95",
        "payAmount": "628.59",
        "payType": "aliqua fugiat",
        "paySubType": "Lorem dolor cupidatat nulla voluptate",
        "sceneType": 13,
        "providerCode": "8",
        "channelCode": "50",
        "subChannelId": "77",
        "feeAmount": "570.19",
        "feeRate": "nulla ullamco cupidatat",
        "channelFeeAmount": "869.35",
        "channelFeeRate": "nulla in",
        "settlementAmount": "535.99",
        "subject": "consectetur",
        "description": "论史验造流治。立改消系方组。",
        "successTime": 1739265622362
    },
    "msg": "adipisicing do in tempor mollit",
    "appId": "94",
    "sn": "proident sed",
    "sign": "occaecat ad minim nulla sed",
    "timestamp": "1736152491",
    "signType": "occaecat qui minim in fugiat"
}

🟢201Created

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found