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_account_number
string
Your Payeer account number
payeer_phone_number
string
Your Payeer phone number
payeer_first_name
string
Your Payeer first name
payeer_last_name
string
Your Payeer last name
payeer_bank_name
string
Name of the bank Payeer: 산업은행, 기업은행, KB국민은행, 수협은행, NH농협은행, 농ᆞ축협, 우리은행, SC제일은행, 한국씨티은행, 대구은행, 부산은행, 광주은행, 제주은행, 전북은행, 경남은행, 새마을금고, 신협, 저축은행, 모건스탠리은행, HSBC은행, 도이치은행, 제이피모간체이스은행, 미즈호은행, 엠유에프지은행, BOA은행, 비엔피파리바은행, 중국공상은행, 중국은행, 산림조합중앙회, 대화은행, 교통은행, 중국건설은행, 우체국, 하나은행, 신한은행, 케이뱅크, 카카오뱅크, 토스혁신준비법인, 유안타증권, KB증권, 미래에셋대우, 삼성증권, 한국투자증권, NH투자증권, 교보증권, 하이투자증권, 현대차증권, 키움증권, 이베스트투자증권, SK증권, 대신증권, 한화투자증권, 하나금융증권, 신한금융투자, DB금융투자, 유진투자증권, 메리츠증권, 카카오페이증권, 부국증권, 신영증권, 케이프투자증권, 한국증권금융
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