CREATE
Request
POST https://bovatech.cc/merchant/v1/deposits
POST https://bovatech.cc/merchant/v1/depositsJSON Request Params
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
payeer_bank_name
string
For the click ARS method:
"mercado_pago" | "claropay"
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
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:
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:
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)
expired
final
Declined due to timeout, requisites were not issued within 30 minutes
reviewing
internal
Transaction has an active dispute under review
repeated_reviewing
internal
Transaction has an active repeated dispute under review
Last updated