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: rub
payment_method*	string	Payment method: card card_fast sbp sbp_fast account_number sber_sbor sim
to_card*	string	Payout destination detail: If card – recipient's card number If card_fast – recipient's card number If sbp – recipient's phone number in format [phone] If sbp_fast – recipient's phone number in format [phone] If account_number – recipient's account number If sber_sbor – fill "none" If sim – recipient's phone number in format [phone]
sbp_bank_name	string	Required for sbp and sbp_fast methods. NSPK bank code. Get the full list at: https://qr.nspk.ru/proxyapp/c2bmembers.json Example codes: 100000000111 – Sberbank 100000000004 – Tinkoff Bank 110000000005 – VTB 100000000001 – Gazprombank 100000000008 – Alfa-Bank 100000000013 – Sovcombank 100000000015 – Bank Otkritie 100000000016 – Post Bank 100000000273 – Ozon Bank 100000000150 – Yandex Bank 100000000284 – Tochka Bank 100000000059 – Center-Invest Bank
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",
  "amount": 50000,
  "to_card": "4111111111111111",
  "callback_url": "https://webhook.site/f3029e33-db04-40fd-a81e-5cea9a69fc80",
  "merchant_id": "40fd-a81e-f3029e33-5cea9a69fc80",
  "payment_method": "card",
  "currency": "rub"
}

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": "rub",
    "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",
    "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