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

payment_method*

string

bik*

string

to_card*

string

recipient_first_name*

string

recipient_last_name*

string

bank_name*

string

Use a bank code from the provided list:

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:

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

bik

string

Bank branch

to_card

string

Account number

recipient_first_name

string

Richard

recipient_last_name

string

Kim

bank_name

string

Bank name

form_url

string

Link on form

Example Response:

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

Last updated