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
/
v3
/
transactions
/
deposit
/
qr
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."
}Body
application/json
Data required to generate the deposit QR code.
- Option 1
- Option 2
Response
QR deposit created successfully.