curl --request POST \
  --url https://sandbox-rampa.mesadepagos.com/api/v3/transactions/deposit/qr \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "fundingSource": "balance",
  "referenceId": "ORDER-1001",
  "fiatCurrency": "BOB",
  "fiatAmount": 100
}
'

{
  "transactionId": "550e8400-e29b-41d4-a716-446655440000",
  "type": "deposit_express",
  "transactionStatus": "pending_transaction",
  "requestedCryptoAmount": "10",
  "calculatedFiatAmount": "69.60",
  "exchangeRate": "6.96",
  "asset": "USDC",
  "country": "BO",
  "countryName": "Bolivia",
  "qrCodeBase64": "iVBORw0KGgoAAAANSUhEUgAA...",
  "referenceId": "ORDER-1001",
  "fiatCurrency": "BOB",
  "feeAmount": "0.00"
}

{
  "statusCode": 400,
  "error": "Bad Request",
  "message": [
    {
      "path": [
        "fiatAmount"
      ],
      "message": "The value was rejected by the payment provider."
    }
  ]
}

{
  "statusCode": 401,
  "message": "Unauthorized"
}

{
  "statusCode": 404,
  "code": "TRANSACTION_NOT_FOUND",
  "message": "The transaction was not found."
}

{
  "statusCode": 422,
  "code": "INSUFFICIENT_FUNDS",
  "message": "There are insufficient funds to complete this transaction."
}

{
  "statusCode": 500,
  "code": "INTERNAL_SERVER_ERROR",
  "message": "An unexpected internal server error occurred. Please try again later."
}

{
  "statusCode": 503,
  "code": "PAYMENT_PROVIDER_UNAVAILABLE",
  "message": "The payment provider is temporarily unavailable. Please try again later."
}

Payin

Crear deposito QR

Crea una transaccion de payin por QR y devuelve la imagen QR en base64. La confirmacion del pago se notifica por webhook (transaction_updated).

Campos segun fundingSource

Campo	balance	conversion
fiatAmount	Requerido	Opcional
cryptoAmount	Opcional	Requerido
depositAddress	Opcional	Requerido y no vacio

Siempre se requieren fundingSource, referenceId y fiatCurrency (BOB). asset y blockchain son opcionales en ambos casos y usan USDC y Polygon por defecto. country usa BO y qrExpirationTime usa 00:15:00 por defecto.

Los campos opcionales pueden omitirse, pero si se envian deben cumplir sus validaciones; no se acepta null. Con conversion, fiatAmount se calcula a partir de cryptoAmount, el tipo de cambio y las comisiones, aunque se envie fiatAmount.

POST

transactions

deposit

curl --request POST \
  --url https://sandbox-rampa.mesadepagos.com/api/v3/transactions/deposit/qr \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "fundingSource": "balance",
  "referenceId": "ORDER-1001",
  "fiatCurrency": "BOB",
  "fiatAmount": 100
}
'

{
  "transactionId": "550e8400-e29b-41d4-a716-446655440000",
  "type": "deposit_express",
  "transactionStatus": "pending_transaction",
  "requestedCryptoAmount": "10",
  "calculatedFiatAmount": "69.60",
  "exchangeRate": "6.96",
  "asset": "USDC",
  "country": "BO",
  "countryName": "Bolivia",
  "qrCodeBase64": "iVBORw0KGgoAAAANSUhEUgAA...",
  "referenceId": "ORDER-1001",
  "fiatCurrency": "BOB",
  "feeAmount": "0.00"
}

{
  "statusCode": 400,
  "error": "Bad Request",
  "message": [
    {
      "path": [
        "fiatAmount"
      ],
      "message": "The value was rejected by the payment provider."
    }
  ]
}

{
  "statusCode": 401,
  "message": "Unauthorized"
}

{
  "statusCode": 404,
  "code": "TRANSACTION_NOT_FOUND",
  "message": "The transaction was not found."
}

{
  "statusCode": 422,
  "code": "INSUFFICIENT_FUNDS",
  "message": "There are insufficient funds to complete this transaction."
}

{
  "statusCode": 500,
  "code": "INTERNAL_SERVER_ERROR",
  "message": "An unexpected internal server error occurred. Please try again later."
}

{
  "statusCode": 503,
  "code": "PAYMENT_PROVIDER_UNAVAILABLE",
  "message": "The payment provider is temporarily unavailable. Please try again later."
}

Autorizaciones

Authorization

string

header

requerido

JWT obtenido desde /v2/auth/login o /v3/auth/login

Cuerpo

application/json

Datos necesarios para generar el QR de deposito.

Option 1
Option 2

fundingSource

enum<string>

requerido

Origen de fondos usado para la operacion.

Opciones disponibles:

balance

Ejemplo:

"balance"

referenceId

string

requerido

Referencia externa del partner.

Required string length: 1 - 100

Ejemplo:

"ORDER-1001"

fiatCurrency

enum<string>

requerido

Moneda fiat del QR.

Opciones disponibles:

BOB

Ejemplo:

"BOB"

fiatAmount

number

requerido

Monto fiat del QR. Requerido con fundingSource "balance"; opcional con "conversion". Debe ser mayor que 0 y multiplo de 0.01.

Rango requerido: x > 0Debe ser un múltiplo de 0.01

Ejemplo:

100

country

enum<string>

predeterminado:BO

Pais donde se genera el QR.

Opciones disponibles:

BO

Ejemplo:

"BO"

cryptoAmount

number

Monto crypto a acreditar. Requerido con fundingSource "conversion"; opcional con "balance". Debe ser mayor que 0.

Rango requerido: x > 0

Ejemplo:

10

asset

enum<string>

predeterminado:USDC

Asset crypto usado para la transaccion.

Opciones disponibles:

USDC,

USDT

Ejemplo:

"USDC"

blockchain

enum<string>

predeterminado:Polygon

Blockchain del asset.

Opciones disponibles:

Polygon,

Ethereum,

TRON

Ejemplo:

"Polygon"

depositAddress

string

Direccion crypto de destino. Requerida y no vacia con fundingSource "conversion"; opcional con "balance".

Ejemplo:

"0x0000000000000000000000000000000000000000"

description

string

Descripcion visible para conciliacion.

Maximum string length: 60

Ejemplo:

"Pago orden 1001"

qrExpirationTime

string

predeterminado: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$

Ejemplo:

"00:15:00"

Respuesta

Deposito QR creado exitosamente.

transactionId

string

requerido

Identificador unico de la transaccion.

Ejemplo:

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

type

enum<string>

requerido

Tipo de transaccion creada.

Opciones disponibles:

deposit_express

Ejemplo:

"deposit_express"

transactionStatus

string

requerido

Estado inicial de la transaccion.

Ejemplo:

"pending_transaction"

requestedCryptoAmount

string

requerido

Monto crypto solicitado.

Ejemplo:

"10"

calculatedFiatAmount

string

requerido

Monto fiat calculado para el QR.

Ejemplo:

"69.60"

exchangeRate

string

requerido

Tipo de cambio aplicado.

Ejemplo:

"6.96"

asset

string

requerido

Asset de la transaccion.

Ejemplo:

"USDC"

country

string

requerido

Codigo del pais.

Ejemplo:

"BO"

countryName

string

requerido

Nombre del pais.

Ejemplo:

"Bolivia"

qrCodeBase64

string

requerido

Imagen QR codificada en base64.

Ejemplo:

"iVBORw0KGgoAAAANSUhEUgAA..."

referenceId

string

requerido

Referencia externa enviada por el partner.

Ejemplo:

"ORDER-1001"

fiatCurrency

string

requerido

Moneda fiat del QR.

Ejemplo:

"BOB"

feeAmount

string

Fee aplicado a la operacion.

Ejemplo:

"0.00"

Login

Quotes

Consultas

Payin

Payout

Virtual accounts

Crear deposito QR

Campos segun fundingSource

Autorizaciones

Cuerpo

Respuesta