Skip to main content
POST
/
v2
/
transactions
/
deposit
/
qr
Crear depósito QR
curl --request POST \
  --url https://sandbox-rampa.mesadepagos.com/api/v2/transactions/deposit/qr \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "cryptoAmount": 10,
  "fiatCurrency": "BOB",
  "referenceId": "ORDER-1001",
  "country": "BO",
  "depositAddress": "0x0000000000000000000000000000000000000000",
  "fundingSource": "conversion",
  "asset": "USDC",
  "blockchain": "Polygon",
  "description": "Pago orden 1001",
  "qrExpirationTime": "00:15:00"
}
'
{
  "transactionId": "550e8400-e29b-41d4-a716-446655440000",
  "type": "deposit_express",
  "referenceId": "ORDER-1001",
  "country": "BO",
  "countryName": "Bolivia",
  "requestedCryptoAmount": "10",
  "asset": "USDC",
  "calculatedFiatAmount": "69.60",
  "fiatCurrency": "BOB",
  "exchangeRate": "6.96",
  "qrCodeBase64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...",
  "transactionStatus": "pending_transaction",
  "feeAmount": "0.00"
}

Authorizations

​
Authorization
string
header
required

JWT obtenido desde /v2/auth/login

Body

application/json

Datos necesarios para generar el QR de depósito.

​
cryptoAmount
number
required

Monto crypto solicitado para el depósito.

Required range: x >= 0
Example:

10

​
fiatCurrency
enum<string>
required

Moneda fiat del QR.

Available options:
BOB,
USD
Example:

"BOB"

​
referenceId
string
required

Referencia externa del partner.

Required string length: 1 - 100
Example:

"ORDER-1001"

​
country
enum<string>
required

País donde se genera el QR.

Available options:
BO
Example:

"BO"

​
depositAddress
string
required

Dirección crypto de destino para el depósito.

Example:

"0x0000000000000000000000000000000000000000"

​
fundingSource
enum<string>
required

Origen de fondos usado para la operación.

Available options:
balance,
conversion
Example:

"conversion"

​
asset
enum<string>
default:USDC

Asset crypto usado para la transacción.

Available options:
USDC,
USDT
Example:

"USDC"

​
blockchain
enum<string>
default:Polygon

Blockchain del asset.

Available options:
Polygon,
Ethereum,
TRON
Example:

"Polygon"

​
description
string

Descripción visible para conciliación.

Maximum string length: 60
Example:

"Pago orden 1001"

​
qrExpirationTime
string
default:00:15:00

Tiempo de expiracion del QR en formato HH:MM:SS.

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

"00:15:00"

Response

Depósito QR creado exitosamente.

​
transactionId
string
required

Identificador único de la transacción.

Example:

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

​
type
enum<string>
required

Tipo de transacción creada.

Available options:
deposit_express
Example:

"deposit_express"

​
referenceId
string
required

Referencia externa enviada por el partner.

Example:

"ORDER-1001"

​
country
string
required

Código del país.

Example:

"BO"

​
countryName
string
required

Nombre del país.

Example:

"Bolivia"

​
requestedCryptoAmount
string
required

Monto crypto solicitado.

Example:

"10"

​
asset
string
required

Asset de la transacción.

Example:

"USDC"

​
calculatedFiatAmount
string
required

Monto fiat calculado para el QR.

Example:

"69.60"

​
fiatCurrency
string
required

Moneda fiat del QR.

Example:

"BOB"

​
exchangeRate
string
required

Tipo de cambio aplicado.

Example:

"6.96"

​
qrCodeBase64
string
required

Imagen QR codificada en base64.

Example:

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

​
transactionStatus
string
required

Estado inicial de la transacción.

Example:

"pending_transaction"

​
feeAmount
string

Fee aplicado a la operación.

Example:

"0.00"