CREATE

Request

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

JSON Request Params

Name
Type
Description

user_uuid*

string

A 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 either ftd or trust. trust – the user has made at least 3 deposits and 2 withdrawals. All others are considered 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 notifications. A POST request with retry logic 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 computed for each request using the API key token provided to you.

Example Request:

JSON Response Params:

Name
Type
Description

id

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

payment_method

string

Deposit method

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

email

string

Payer's email

customer_name

string

Payer's name

amount

decimal

Transaction amount in USDT after conversion at the exchange rate

fiat_amount

decimal

Amount in the selected currency specified when creating the transaction

old_fiat_amount

decimal

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

rate

decimal

Conversion rate currency/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

resipient_card

object

Details of the payment credentials for H2H usage

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