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

to_card*

string

Recipient's account number

bank_name*

string

Bank code from the provided list:

1 - ABN AMRO 2 - BANK OF AMERICA 3 - BNK SECURITIES CO 4 - BNP Paribas 5 - BNPPKR 6 - BOOKOOK 7 - Bank of Korea 8 - Barclays 9 - Busan Bank 10 - China Construction Bank 11 - Citibank Korea 12 - Credit Union 13 - DAESHIN 14 - DB FINANCIAL INVESTMENT CO., LTD 15 - DEUTSCHE BANK 16 - DMS Bank 17 - Daegu Bank 18 - HANKOOK 19 - HANWHA 20 - HITOOJA 21 - HSBC 22 - Hana Financial Investment 23 - Hyundai Motor Securities 24 - IBK 25 - ING 26 - Industrial & Commercial Bank of China 27 - JPMORGAN CHASE 28 - Jeju Bank 29 - Jeonbuk Bank 30 - K Bank 31 - KB Securities 32 - KDB 33 - KEB Hana Bank 34 - KIWOOM 35 - KOREAN FEDERATION OF COMMUNITY CREDIT COOPERATIVES 36 - KTB Investment 37 - KYOBO TRADE 38 - Kakao Bank 39 - Kookmin Bank 40 - Korea Development Bank 41 - Korea Foss Securities 42 - Kwangju Bank 43 - Kyungnam Bank 44 - MERITZ 45 - MIRAEASSET DAEWOO 46 - NH INVESTMENT 47 - National Agricultural Cooperative Federation 48 - Nonghyup Bank 49 - Post Bank 50 - SAMSUNG 51 - SANLIM 52 - SC First Bank 53 - SHINYOUNG 54 - SKTRADE 55 - Saemaeul Bank 56 - Shinhan Bank 57 - Shinhan Investment Corp 58 - Standard Chartered Bank 59 - Suhyup Bank 60 - Woori Bank 61 - YOUJIN TRADE 62 - YUANTA 63 - dmsgod Mutual Savings Bank 64 - eBEST Investment Securities Co, Ltd 65 - kakaopay securities

recipient_first_name*

string

Recipient's first name

recipient_last_name*

string

Recipient's last name

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

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