Payout Callback

When a payout status changes, Velora sends an asynchronous notification to the notifyUrl supplied when the payout was created.

Notification

• Method: POST
• URL: The merchant-provided notifyUrl
• Content-Type: application/json
• Signature verification: See Authentication and verify the raw request body

Notification example

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

Notification fields

Field	Type	Length / constraints	Always returned	Description
data	object	—	Yes	Payout order and channel-processing information
result	object	—	Yes	Payout processing result

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

result object

Field	Type	Length / constraints	Always returned	Example	Description
msg	string	≤ 255 characters	Yes	Payout successfully	Payout result message
code	string	≤ 32 characters	Yes	S0000	Payout result code

Acknowledgement example

After verifying and processing the callback, return HTTP 200 with the following acknowledgement body:

{
  "code": "SUCCESS"
}