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)
reviewing
internal
Transaction has an active dispute under review
repeated_reviewing
internal
Transaction has an active repeated dispute under review
Last updated