付款凭证查询
接口信息
- 路径:
/api/v1/txn/queryVoucher - 方法: POST
- Content-Type: application/json
业务说明
- 用于获取付款成功后的电子回单
- 可通过requestId或payoutId查询
- 交易成功后保存凭证用于对账和存档
请求参数
Headers
请求头
| 参数名 | 值 | 必填 | 说明 |
|---|---|---|---|
| Content-Type | application/json | 是 | 请求体类型 |
Request Body
主要参数
| 参数名 | 类型 | 说明 | 必填 |
|---|---|---|---|
| merchantNo | string | 商户号(由oneway提供) | M |
| requestId | string | 业务流水号 | C,若payoutId为空,则此字段必填 |
| payoutId | integer | 付款流水ID | C,若requestId为空,则此字段必填 |
| sign | string | 签名 | M |
请求示例
json
{
"merchantNo": 801129,
"payoutId": 1984136974445449216,
"sign": "d2ea92efff636320122021f65b613201403f6d34334cfbc7e589ce9f84228ab3"
}响应结果
响应头 Headers
| 参数名 | 值 | 必填 | 说明 |
|---|---|---|---|
| content-type | application/json;charset=UTF-8 | 否 | 响应体类型 |
响应参数
响应字段
| 参数名 | 类型 | 说明 |
|---|---|---|
| respCode | string | 响应码 |
| respMsg | string | 响应信息 |
| data | object | 响应数据 |
| └─merchantNo | string | 商户号 |
| └─requestId | string | 业务流水号 |
| └─payoutId | integer | 付款流水ID |
| └─url | string | 凭证url |
响应示例
json
{
"respCode": "20000",
"respMsg": null,
"data": {
"merchantNo": "801129",
"requestId": "CYPW20251031055450",
"payoutId": "1984136974445449216",
"url": "https://ronhandevopsdiag.blob.core.windows.net/overt/collect/download/center/1984136974445449216.pdf"
}
}