转账单查询
接口说明
查询转账订单。仅查询本地转账记录,不调用通道;需要实时通道状态请走 转账同步。
查询结果基于跨通道公共凭证(转账资金记录),收款人等敏感信息不对外提供;失败单会回填通道侧错误信息。
请求地址
POST /unipay/query/transfer-order
- 认证:RSA 签名(
@PaymentVerify) - 响应:
DaxResult<TransferOrderResult>
请求参数
基础参数同 统一支付 - 基础参数,业务参数:
| 参数 | 类型 | 必填 | 最大长度 | 描述 |
|---|---|---|---|---|
| transferNo | string | 否* | 100 | 平台转账单号 |
| channel | string | 否* | 32 | 转账通道(与商户转账号配对使用) |
| bizTransferNo | string | 否* | 100 | 商户转账号(与转账通道配对使用) |
*定位方式二选一:
transferNo单独可查;bizTransferNo必须配channel(与发起幂等维度「通道+商户转账号+商户号」保持一致,同一商户转账号可在不同通道各存在一笔)。
请求示例
json
{
"mchNo": "M200000001",
"appId": "APP001",
"reqId": "REQ20241201042",
"reqTime": "2024-12-01 12:42:00",
"sign": "Base64签名值",
"channel": "alipay",
"bizTransferNo": "TRANS20241201001"
}响应参数
DaxResult<TransferOrderResult>,data 字段结构:
| 参数 | 类型 | 描述 |
|---|---|---|
| transferNo | string | 平台转账单号 |
| bizTransferNo | string | 商户转账号 |
| outTransferNo | string | 通道转账单号 |
| relationNo | string | 实际上送通道的商户转账号 |
| amount | long | 转账金额(分) |
| currency | string | 币种 |
| channel | string | 转账通道 |
| provider | string | 钱包渠道 |
| status | string | 转账状态(PayFundStatusEnum) |
| title | string | 转账标题 |
| finishTime | string | 转账完成时间(北京时间,yyyy-MM-dd HH:mm:ss) |
| errorMsg | string | 错误信息(失败时从通道转账单回填) |
响应示例
json
{
"code": 0,
"msg": "success",
"data": {
"transferNo": "TF2024120112345700001",
"bizTransferNo": "TRANS20241201001",
"outTransferNo": "20241201110070001500",
"relationNo": "TRANS20241201001",
"amount": 10000,
"currency": "cny",
"channel": "alipay",
"provider": "alipay",
"status": "success",
"title": "佣金结算",
"finishTime": "2024-12-01 12:40:30"
},
"sign": "Base64签名值",
"resTime": "2024-12-01 12:42:00",
"reqId": "REQ20241201042"
}