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
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": "uzs",
  "payment_method": "card",
  "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