CREATE

Request

POST https://bovatech.cc/merchant/v1/deposits

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

payeer_identifier*

string

User (payer) identifier as a string in any format

payeer_ip*

string

User (payer) IP address

payeer_type*

string

Primary or secondary traffic. Specify: ftd or trust. trust — the user has made at least 3 deposits and 2 withdrawals. All others are ftd.

currency*

string

payment_method

string

amount*

integer

Amount in the selected currency specified when creating the transaction

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.

redirect_url

string

Redirect URL for returning the user from the payment form after the payment is completed

email

string

Payer's email (if available)

customer_name

string

Payer's name (if available)

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

uuid

string

Transaction ID on the BOVA side

merchant_id

string

Your transaction number

form_url

string

BOVA payment form URL

state

string

Transaction status

created_at

string

Transaction creation date

updated_at

string

Last transaction update date

close_at

string

Transaction timeout closure date

currency

string

Transaction currency

callback_url

string

Callback URL for receiving callback notifications

redirect_url

string

Redirect URL for returning the user from the payment form after the payment is completed

payment_method

string

P2pTransaction or CryptoTransaction

source_transaction

object

Transaction created within the form

email

string

Payer's email

source_transaction - customer_name

string

Payer's name

source_transaction - amount

decimal

Transaction amount in USDT after conversion at the exchange rate

source_transaction - fiat_amount

decimal

Amount in the selected currency specified when creating the transaction

source_transaction - old_fiat_amount

decimal

Amount in the selected currency specified when creating the transaction (immutable)

source_transaction - rate

decimal

Conversion rate currency/USDT

source_transaction - service_commission

decimal

Your commission percentage

source_transaction - total_amount

decimal

Amount to be credited to the balance after deducting the system commission upon transaction completion

source_transaction - payment_method

string

Deposit method

Example Response:

State description:

Name
Type
Description

waiting_payment

internal

Awaiting payment

paid

internal

Marked as paid (by user)

successed

final

Successfully credited (by callback)

accepted_successed

final

Successfully completed after dispute confirmation (by callback)

repeated_accepted_successed

final

Successfully completed after repeated dispute confirmation (by callback)

failed

final

Rejected due to timeout, credit not found (by callback)

closed_failed

final

Rejected after dispute was denied (by callback)

repeated_closed_failed

final

Rejected after repeated dispute was denied (by callback)

reviewing

internal

Transaction has an active dispute under review

repeated_reviewing

internal

Transaction has an active repeated dispute under review

Last updated