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
message	string	Rejection reason text for the request, with or without a dispute. Possible reasons for request rejection: Transaction cancellation without dispute, reasons:declined by timeout – payment timeout exceededdeclined by anti fraud – cancelled by anti-fraud systemdeclined by user – cancelled by the user via the form or APITransaction cancellation with dispute, reasons:payment not found – payment was not foundfake proof – fake receipt (mostly applies to PDFs)invalid proof datetime – receipt date does not match the requestinvalid proof requisites – incorrect payment detailsbank account blocked – bank account is blocked, review period extended
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	Transaction amount specified at creation in the selected currency (immutable)
rate	decimal	Conversion rate currency/USDT
service_commission	decimal	Merchant commission percentage

Headers

Name	Type	Description
Content-Type	string	Always application/json
Signature	string	Signature of the request, generated using your api_key to verify the callback notification was sent by us. You must compare the signature with yours — they must match.

Example Request:

header["Signature"] = ae8b1db2b2bcfab0cc38d22ad580cee5ff536470
{
  "id": "4d003807-1066-4fad-b88f-005c9e6f391c",
  "merchant_id": "string",
  "status": "successed",
  "message": "",
  "currency": "azn",
  "payment_method": "international_azn",
  "rate": 97.08,
  "amount": "1.03",
  "fiat_amount": "100.0",
  "old_fiat_amount": "100.0",
  "service_commission": "6.5",
  "total_amount": "0.96305"
}

Status description:

Name	Type	Description
successed	final	Successfully credited
accepted_successed	final	Successfully completed after dispute confirmation
repeated_accepted_successed	final	Successfully completed after repeated dispute confirmation
failed	final	Rejected due to timeout, credit not found
closed_failed	final	Rejected after dispute was denied
repeated_closed_failed	final	Rejected after repeated dispute was denied