Query Transfer Order

Updated: 9/11/26, 8:21:59 PM

Description

Query a transfer order. Reads the local record only, without calling the channel; for real-time channel status use Sync Transfer.

The result is a snapshot based on the cross-channel fund record; sensitive payee information is not exposed. Failed orders include the channel-side error message.

Request

POST /unipay/query/transfer-order

Auth: RSA signature (@PaymentVerify)
Response: DaxResult<TransferOrderResult>

Parameters

Common params same as Pay - Common Parameters. Business parameters:

Parameter	Type	Required	Max	Description
transferNo	string	No*	100	Platform transfer number
channel	string	No*	32	Transfer channel (paired with merchant transfer number)
bizTransferNo	string	No*	100	Merchant transfer number (paired with channel)

*One of two locating modes: transferNo alone; or bizTransferNo together with channel (matching the initiation idempotency key "channel + bizTransferNo + mchNo" — the same merchant transfer number can exist once per channel).

Request Example

json

{
  "mchNo": "M200000001",
  "appId": "APP001",
  "reqId": "REQ20241201042",
  "reqTime": "2024-12-01 12:42:00",
  "sign": "Base64Signature",
  "channel": "alipay",
  "bizTransferNo": "TRANS20241201001"
}

Response

DaxResult<TransferOrderResult>, the data field:

Parameter	Type	Description
transferNo	string	Platform transfer number
bizTransferNo	string	Merchant transfer number
outTransferNo	string	Channel transfer number
relationNo	string	Merchant transfer number actually submitted to the channel
amount	long	Transfer amount in cents
currency	string	Currency
channel	string	Transfer channel
provider	string	Wallet provider
status	string	Transfer status (PayFundStatusEnum)
title	string	Transfer title
finishTime	string	Transfer finish time (Beijing time, `yyyy-MM-dd HH:mm:ss`)
errorMsg	string	Error message (backfilled from the channel transfer order on failure)

Response Example

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": "Commission settlement",
    "finishTime": "2024-12-01 12:40:30"
  },
  "sign": "Base64Signature",
  "resTime": "2024-12-01 12:42:00",
  "reqId": "REQ20241201042"
}

Query Transfer Order ​

Description ​

Request ​

Parameters ​

Request Example ​

Response ​

Response Example ​