CALLBACKS

Example of a callback notification

POST

JSON Request Params

Name	Type	Description
id	string	Transaction ID on the BOVA side
merchant_id	string	Your transaction number
status	string	Transaction status
currency	string	Transaction currency
payment_method	string	Payment method
bik	string	Bank branch
to_card	string	Account number
recipient_first_name	string	Richard
recipient_last_name	string	Kim
bank_name	string	Bank name
amount	decimal	Transaction amount in USDT after conversion at the exchange rate
fiat_amount	decimal	Actual credited amount in the transaction currency upon successful completion
old_fiat_amount	decimal	Amount in the selected currency specified when creating the payout (immutable)
rate	decimal	Conversion rate currency/USDT
service_commission	decimal	Your commission percentage
reсipient_card_number_type	string	imps

Headers

Name	Type	Description
Content-Type	string	Always application/json
Signature	string	Signature of the request, generated using your api_key to identify that the callback notification was sent by us. You must verify the signature on your side — it must match.

Example Request:

header["Signature"] = ae8b1db2b2bcfab0cc38d22ad580cee5ff536470
{
  "id": "1ab06cdd-24c8-4f59-903b-d31ad75e6ffc",
  "merchant_id": "40fd-a81e-f3029e33-5cea9a69fc80",
  "status": "paid",
  "currency": "jpy",
  "payment_method": "account_number",
  "bik": "M1DS1",
  "to_card": "213123-1231d-12",
  "recipient_first_name": "Richard",
  "recipient_last_name": "Kim",
  "bank_name": "Bank name",
  "rate": 90.15,
  "amount": "554.63",
  "fiat_amount": "50000.0",
  "old_fiat_amount": "50000.0",
  "service_commission": "3.0",
  "total_amount": "571.2689"
}

Status description:

Name	Type	Description
paid	final	Payout completed
failed	final	Payout failed