跳转到内容

代收查询

请求地址

methodurl
POST/api/pay/payment/query/v1

头部信息(header)

header参数入参参数描述
timestamp请求时间戳
nonce随机值
countryID
app_codeapp编号

请求参数

字段类型必需长度描述
merchantOrderNoStringyes32商户订单号
signStringyes签名
请求示例
{
"merchantOrderNo": "OrderNoExample",
"sign": "YOUR_SIGN"
}

返回参数

参数类型必需长度描述
merchantOrderNoStringyes32商户订单号
tradeNoStringyes平台订单号
paymentTypeIntyes1代收方式
transactionAmountStringyes订单交易金额
amountStringyes收款金额
statusStringyes1-支付中,2-成功 ,3-失败
serviceAmountStringyes服务费用 eg:18.02
paymentInfoStringyes主要付款信息,返回的是实际用于付款的信息
errorMessageStringno订单失败错误信息
channelStringno支付方式扩展字段
statementListObjectno代收流水信息
— paymentSingleOrderNoStringyes单次支付流水号
— paymentStatementAmountStringyes单次代收金额
— paymentStatementStatusIntyes单次代收交易状态: 2-代收成功
— paymentStatementStatusNameStringyes交易状态名称
— serviceAmountStringyes服务费用 = 固收金额 + 交易金额 * 服务费率
— serviceRateStringyes服务费率
— immServiceStringyes固收金额
— paymentTypeIntyes真实支付方式
— completeTimeStringyes该流水的完成时间 当前国家时区 yyyy-MM-dd HH:mm:ss格式
返回示例
{
"code": 200,
"data": {
"merchantOrderNo": "OrderNoExample",
"amount": "60000.00",
"transactionAmount": "60000.00",
"tradeNo": "TS2501010001ID0000000000000000",
"paymentType": 502,
"paymentInfo": "https://www.paymentLinkExample.com",
"status": 2,
"serviceAmount": "605.00",
"channel": "DANA",
"statementList": [
{
"paymentSingleOrderNo": "TSOPaymentOrderNoExample",
"paymentStatementAmount": "60000.00",
"paymentStatementStatus": 2,
"paymentStatementStatusName": "代收成功",
"completeTime": "2025-01-01 00:00:00",
"serviceAmount": "605.00",
"serviceRate": "0.0100",
"immService": "5.00",
"paymentType": 502
}
]
},
"msg": "success",
"traceId": "0801113131dd4951a36d19022a31b303.94.17423567008990449"
}