Query Payout
Query the current status of a payout for order polling, reconciliation, or order repair.
Request
- Method:
POST - Path:
/api/v1/payout/orderQuery - Content-Type:
application/json - Authentication: See Authentication
Request fields
| Parameter | Type | Required | Description |
|---|---|---|---|
payoutId | string | No | Velora payout ID returned by create payout |
merchantOrderId | string | No | Merchant order ID supplied when creating the payout; ≤ 64 characters |
Use either payoutId or merchantOrderId to query the order.
Request examples
Query by platform payout ID:
json
{
"payoutId": "payout_20260814075354206395313"
}Or query by merchant order ID:
json
{
"merchantOrderId": "PAYOUT_1786694004469_G61WUS"
}Response fields
The response matches the payout callback: result contains the payout outcome, and data contains payout order details.
result object
| Field | Type | Length / constraints | Always returned | Example | Description |
|---|---|---|---|---|---|
code | string | ≤ 32 characters | Yes | S0000 | Payout result code |
msg | string | ≤ 255 characters | Yes | Payout successfully | Payout result message |
data object
| Field | Type | Length / constraints | Always returned | Example | Description |
|---|---|---|---|---|---|
amount | object | — | No | — | Payout amount |
status | string | Enum | Yes | Success | Payout status |
createdAt | string | ISO 8601 | No | 2026-08-14T07:53:54+00:00 | Payout creation time |
updatedAt | string | ISO 8601 | No | 2026-08-14T07:54:02+00:00 | Payout update time |
payoutId | string | ≤ 64 characters | Yes | payout_20260814075354206395313 | Velora payout ID |
channelOrderId | string | ≤ 64 characters | No | 20260814075354PD5630484505007955A05 | PSP channel order ID |
merchantOrderId | string | ≤ 64 characters | Yes | PAYOUT_1786694004469_G61WUS | Merchant payout order ID |
data.amount object
| Field | Type | Length / constraints | Always returned | Example | Description |
|---|---|---|---|---|---|
value | string | Numeric string | With amount | 200.00 | Payout amount |
currency | string | 3 characters, ISO-4217 | With amount | RUB | Three-letter currency code |
Response example
json
{
"data": {
"amount": {
"value": "200.00",
"currency": "RUB"
},
"status": "Success",
"createdAt": "2026-08-14T07:53:54+00:00",
"updatedAt": "2026-08-14T07:54:02+00:00",
"payoutId": "payout_20260814075354206395313",
"channelOrderId": "20260814075354PD5630484505007955A05",
"merchantOrderId": "PAYOUT_1786694004469_G61WUS"
},
"result": {
"msg": "Payout successfully",
"code": "S0000"
}
}See also
- Create payout: Initiate a payout
- Payout callback: Async notification and signature verification