Skip to content

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

ParameterTypeRequiredDescription
payoutIdstringNoVelora payout ID returned by create payout
merchantOrderIdstringNoMerchant 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

FieldTypeLength / constraintsAlways returnedExampleDescription
codestring≤ 32 charactersYesS0000Payout result code
msgstring≤ 255 charactersYesPayout successfullyPayout result message

data object

FieldTypeLength / constraintsAlways returnedExampleDescription
amountobjectNoPayout amount
statusstringEnumYesSuccessPayout status
createdAtstringISO 8601No2026-08-14T07:53:54+00:00Payout creation time
updatedAtstringISO 8601No2026-08-14T07:54:02+00:00Payout update time
payoutIdstring≤ 64 charactersYespayout_20260814075354206395313Velora payout ID
channelOrderIdstring≤ 64 charactersNo20260814075354PD5630484505007955A05PSP channel order ID
merchantOrderIdstring≤ 64 charactersYesPAYOUT_1786694004469_G61WUSMerchant payout order ID

data.amount object

FieldTypeLength / constraintsAlways returnedExampleDescription
valuestringNumeric stringWith amount200.00Payout amount
currencystring3 characters, ISO-4217With amountRUBThree-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