Skip to content

转账单查询

更新时间:2026/9/11 20:21:59

接口说明

查询转账订单。仅查询本地转账记录,不调用通道;需要实时通道状态请走 转账同步

查询结果基于跨通道公共凭证(转账资金记录),收款人等敏感信息不对外提供;失败单会回填通道侧错误信息。

请求地址

POST /unipay/query/transfer-order

  • 认证:RSA 签名(@PaymentVerify
  • 响应:DaxResult<TransferOrderResult>

请求参数

基础参数同 统一支付 - 基础参数,业务参数:

参数类型必填最大长度描述
transferNostring否*100平台转账单号
channelstring否*32转账通道(与商户转账号配对使用)
bizTransferNostring否*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 字段结构:

参数类型描述
transferNostring平台转账单号
bizTransferNostring商户转账号
outTransferNostring通道转账单号
relationNostring实际上送通道的商户转账号
amountlong转账金额(分)
currencystring币种
channelstring转账通道
providerstring钱包渠道
statusstring转账状态(PayFundStatusEnum
titlestring转账标题
finishTimestring转账完成时间(北京时间,yyyy-MM-dd HH:mm:ss
errorMsgstring错误信息(失败时从通道转账单回填)

响应示例

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"
}

官方网站 · 基于 GNU LGPL v3.0 协议开源