CREATE

Request

POST https://bovatech.cc/v1/mass_transactions

JSON Request Params

Name	Type	Description
user_uuid*	string	Token that can be obtained in your personal account (Profile → Integration → User ID)
merchant_id*	string	Your transaction number
currency*	string	Transaction currency: uzs
payment_method*	string	Payment method: card
to_card*	string	Recipient's card number
amount*	integer	Amount in the selected currency specified when creating the payout
callback_url*	string	Callback URL for receiving callback notifications. A POST request is sent with retries if a non-200 HTTP status code is returned.

Headers

Name	Type	Description
Content-Type	string	Always application/json
Signature	string	The signature is calculated for each request using the api_key token issued to you.

Example Request:

{
  "user_uuid": "364dbfc8-ae50-492f-bdd9-748edd84d5c9",
  "to_card": "8600123456789012",
  "amount": 50000,
  "callback_url": "https://webhook.site/f3029e33-db04-40fd-a81e-5cea9a69fc80",
  "merchant_id": "40fd-a81e-f3029e33-5cea9a69fc80",
  "payment_method": "card",
  "currency": "uzs"
}

JSON Response Params:

Name	Type	Description
id	string	Transaction ID on the BOVA side
merchant_id	string	Your transaction number
state	string	Transaction status
created_at	string	Transaction creation date
updated_at	string	Last transaction update date
currency	string	Transaction currency
callback_url	string	Callback URL for receiving callback notifications
amount	decimal	Transaction amount in USDT after conversion at the exchange rate
fiat_amount	decimal	Amount in the selected currency specified when creating the payout
old_fiat_amount	decimal	Amount in the selected currency specified when creating the payout (immutable)
rate	decimal	Conversion rate currency/USDT
commission_type	string	relative – percentage fixed – fixed amount of USDT
service_commission	decimal	Your commission percentage
total_amount	decimal	Amount to be credited to the balance after deducting the system commission upon transaction completion
payment_method	string	Payment method
form_url	string	Link on form

Example Response:

{
  "result_code": "ok",
  "data": {
    "id": "1ab06cdd-24c8-4f59-903b-d31ad75e6ffc",
    "amount": "554.63",
    "commission_type": "relative",
    "service_commission": "3.0",
    "rate": "90.15",
    "fiat_amount": "50000.0",
    "old_fiat_amount": "50000.0",
    "state": "failed",
    "currency": "uzs",
    "created_at": "2024-07-16T16:25:34.125+03:00",
    "updated_at": "2024-07-16T18:19:06.421+03:00",
    "total_amount": "571.2689",
    "account_id": 3456,
    "payment_method": "card",
    "recipient_card": "8600123456789012",
    "form_url": null
  }
}

State description:

Name	Type	Description
created	internal	Payout created, awaiting processing start
processing	internal	Payout is being processed, awaiting finalization
paid	final	Payout completed
failed	final	Payout failed