跳转到内容

代收查询

API TEST CONSOLE

模拟请求

TEST ONLY

测试环境下配置参数并发送请求

POST/trade/payment/query

请求鉴权

待配置

私钥仅在浏览器内用于生成 authorization,不会随请求发送或保存

请求头

请求参数 application/json

响应结果

Response
发送请求后,响应状态、耗时和 JSON 将显示在这里。

认证信息仅保留在当前页面内存中,不会写入本地存储。

复制 cURL 不会发送请求

POST/trade/payment/query

请求头

公共请求头。

请求参数

字段类型必填最大长度说明
merchantOrderNoString是32商户订单号

请求示例

{
"merchantOrderNo": "ORDER202609170001"
}

响应参数

字段类型必填最大长度说明
codeint是-状态码,非 200 代表异常
dataObject是-响应体
data.merchantOrderNoString是24商户订单号
data.tradeNoString是32平台单号
data.transactionAmountString是-收款金额
data.statusString是24订单状态
data.paymentTypeString是24支付方式
data.failMsgString否200订单失败原因
data.paymentInfoString否200支付信息
data.serviceAmountString否24服务费用
data.voucherAddressString否-凭证地址
data.paymentStatementsList否-代收流水集合
data.paymentStatements.paymentSingleOrderNoString否32代收单次支付流水号
data.paymentStatements.paymentAmountString否-实际收款金额
data.paymentStatements.paymentStatusString否24订单状态
data.paymentStatements.serviceAmountString否-服务费用
data.paymentStatements.serviceRateString否-服务费率
data.paymentStatements.immServiceString否-固收
data.paymentStatements.completeTimeString否-订单完成时间(国家当地时间)
msgString否-异常信息
tidString是-traceId

订单状态

状态说明
INIT受理中
PAYING交易中
SUCCESS已完成
FAIL已失败
REFUND已退款

响应示例

{
"code": 200,
"data": {
"merchantOrderNo": "ORDER202609170001",
"tradeNo": "VS2608270002KH0000000000040059",
"transactionAmount": "100.00",
"status": "SUCCESS",
"paymentType": "KHQR",
"serviceAmount": "1.00",
"voucherAddress": "https://merchant.example/vouchers/ORDER202609170001.pdf",
"completeTime": "2026-09-17 15:30:00"
},
"msg": "success",
"tid": "747bbf80261844ed85b809212aab0d81"
}