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

Create QR deposit

Creates a QR payin transaction and returns the QR image in base64. Payment confirmation is notified by webhook (transaction_updated).

Fields by fundingSource

Field	balance	conversion
fiatAmount	Required	Optional
cryptoAmount	Optional	Required
depositAddress	Optional	Required and non-empty

fundingSource, referenceId and fiatCurrency (BOB) are always required. asset and blockchain are optional in both cases and default to USDC and Polygon. country defaults to BO and qrExpirationTime defaults to 00:15:00.

Optional fields may be omitted, but must pass their validations when provided; null is not accepted. With conversion, fiatAmount is calculated from cryptoAmount, the exchange rate and fees, even if fiatAmount is provided.

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."
}

Authorizations

Authorization

string

header

required

JWT obtained from /v2/auth/login or /v3/auth/login

Body

application/json

Data required to generate the deposit QR code.

Option 1
Option 2

fundingSource

enum<string>

required

Source of funds used for the operation.

Available options:

balance

Example:

"balance"

referenceId

string

required

Partner external reference.

Required string length: 1 - 100

Example:

"ORDER-1001"

fiatCurrency

enum<string>

required

QR fiat currency.

Available options:

BOB

Example:

"BOB"

fiatAmount

number

required

Fiat amount of the QR. Required with fundingSource "balance"; optional with "conversion". Must be greater than 0 and a multiple of 0.01.

Required range: x > 0Must be a multiple of 0.01

Example:

100

country

enum<string>

default:BO

Country where the QR code is generated.

Available options:

BO

Example:

"BO"

cryptoAmount

number

Crypto amount to credit. Required with fundingSource "conversion"; optional with "balance". Must be greater than 0.

Required range: x > 0

Example:

10

asset

enum<string>

default:USDC

Crypto asset used for the transaction.

Available options:

USDC,

USDT

Example:

"USDC"

blockchain

enum<string>

default:Polygon

Blockchain of the asset.

Available options:

Polygon,

Ethereum,

TRON

Example:

"Polygon"

depositAddress

string

Destination crypto address. Required and non-empty with fundingSource "conversion"; optional with "balance".

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"

transactionStatus

string

required

Initial transaction status.

Example:

"pending_transaction"

requestedCryptoAmount

string

required

Requested crypto amount.

Example:

"10"

calculatedFiatAmount

string

required

Fiat amount calculated for the QR code.

Example:

"69.60"

exchangeRate

string

required

Applied exchange rate.

Example:

"6.96"

asset

string

required

Transaction asset.

Example:

"USDC"

country

string

required

Country code.

Example:

"BO"

countryName

string

required

Country name.

Example:

"Bolivia"

qrCodeBase64

string

required

Base64-encoded QR image.

Example:

"iVBORw0KGgoAAAANSUhEUgAA..."

referenceId

string

required

External reference sent by the partner.

Example:

"ORDER-1001"

fiatCurrency

string

required

QR fiat currency.

Example:

"BOB"

feeAmount

string

Fee applied to the operation.

Example:

"0.00"

Login

Quotes

Queries

Payin

Payout

Virtual accounts

Create QR deposit

Fields by fundingSource

Authorizations

Body

Response