Skip to main content
POST
Create QR deposit

Authorizations

Authorization
string
header
required

JWT obtained from /v2/auth/login

Body

application/json

Data required to generate the deposit QR code.

fiatCurrency
enum<string>
required

QR fiat currency.

Available options:
BOB,
USD
Example:

"BOB"

referenceId
string
required

Partner external reference.

Required string length: 1 - 100
Example:

"ORDER-1001"

country
enum<string>
required

Country where the QR code is generated.

Available options:
BO
Example:

"BO"

fundingSource
enum<string>
required

Source of funds used for the operation.

Available options:
balance,
conversion
Example:

"conversion"

cryptoAmount
number

Crypto amount requested for the deposit. Required when fundingSource is "conversion".

Required range: x >= 0
Example:

10

fiatAmount
number

Fiat amount requested for the deposit. Required when fundingSource is "balance".

Required range: x >= 0
Example:

100

asset
enum<string>
default:USDC

Crypto asset used for the transaction. Required when fundingSource is "conversion".

Available options:
USDC,
USDT
Example:

"USDC"

blockchain
enum<string>
default:Polygon

Asset blockchain. Required when fundingSource is "conversion".

Available options:
Polygon,
Ethereum,
TRON
Example:

"Polygon"

depositAddress
string

Destination crypto address for the deposit. Required when fundingSource is "conversion".

Example:

"0x0000000000000000000000000000000000000000"

description
string

Description displayed for reconciliation.

Maximum string length: 60
Example:

"Payment for order 1001"

qrExpirationTime
string
default:00:15:00

QR code expiration time in HH:MM:SS format.

Pattern: ^([01]\d|2[0-3]):[0-5]\d:[0-5]\d$
Example:

"00:15:00"

Response

QR deposit created successfully.

transactionId
string
required

Unique transaction identifier.

Example:

"550e8400-e29b-41d4-a716-446655440000"

type
enum<string>
required

Created transaction type.

Available options:
deposit_express
Example:

"deposit_express"

referenceId
string
required

External reference sent by the partner.

Example:

"ORDER-1001"

country
string
required

Country code.

Example:

"BO"

countryName
string
required

Country name.

Example:

"Bolivia"

requestedCryptoAmount
string
required

Requested crypto amount.

Example:

"10"

asset
string
required

Transaction asset.

Example:

"USDC"

calculatedFiatAmount
string
required

Fiat amount calculated for the QR code.

Example:

"69.60"

fiatCurrency
string
required

QR fiat currency.

Example:

"BOB"

exchangeRate
string
required

Applied exchange rate.

Example:

"6.96"

qrCodeBase64
string
required

Base64-encoded QR image.

Example:

"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."

transactionStatus
string
required

Initial transaction status.

Example:

"pending_transaction"

feeAmount
string

Fee applied to the operation.

Example:

"0.00"