Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mesadepagos.com/llms.txt

Use this file to discover all available pages before exploring further.

El modulo Payout permite enviar pagos de salida por ACH o procesar pagos mediante QR.

​
Endpoints

NombreMetodoRuta
Payout ACHPOST/v2/transactions/payouts/bank
Payout QRPOST/v2/transactions/payouts/qr
Validacion QRPOST/v2/transactions/payouts/validate/qr
Lista de BancosGET/v2/transactions/payouts/bank/banks

​
Payout ACH

Disponible para cuentas bancarias de los siguientes paises:
CodigoPais
BOBolivia
BRBrasil
COColombia
CLChile
PEPeru
El campo transaction.country debe enviarse con uno de esos codigos ISO alpha-2. 
{
  "funding_source": "conversion",
  "external_reference": "550e8400-e29b-41d4-a716-446655440000",
  "asset_deposit": "USDC",
  "refund_address": "0x0000000000000000000000000000000000000000",
  "blockchain": "Polygon",
  "transaction": {
    "country": "BO",
    "entity_type": "individual",
    "amount": 100.5,
    "bank_code": "101",
    "description": "Pago proveedor",
    "destination_account": "1234567890",
    "first_name": "Juan",
    "last_name": "Perez",
    "document_type": "national_id",
    "destination_id_number": "1234567",
    "currency_type": "BOB"
  }
}

​
Response

{
  "transaction_id": "550e8400-e29b-41d4-a716-446655440001",
  "external_reference": "550e8400-e29b-41d4-a716-446655440000",
  "deposit_address": "0x0000000000000000000000000000000000000000",
  "amount_deposit": "14.44",
  "transactions": [
    {
      "transaction_id": "550e8400-e29b-41d4-a716-446655440002",
      "status": "pending_transaction",
      "message": "Transaction created"
    }
  ]
}

​
Payout QR

Usa este endpoint para procesar un QR de payout. 
{
  "asset_deposit": "USDC",
  "blockchain": "Polygon",
  "funding_source": "conversion",
  "image": "qr-text-or-image-payload",
  "external_reference": "ORDER-QR-1001",
  "amount": 100
}

​
Response

{
  "external_reference": "ORDER-QR-1001",
  "amount_deposit": "14.44",
  "deposit_address": "0x0000000000000000000000000000000000000000",
  "transactions": {
    "transaction_id": "550e8400-e29b-41d4-a716-446655440002",
    "status": "pending_transaction",
    "message": "Payout QR processed successfully"
  }
}

​
Validacion QR

Usa este endpoint para decodificar una imagen QR en base64 y validar su informacion. 
{
  "image": "iVBORw0KGgoAAAANSUhEUgAA..."
}

​
Response Exitoso

{
  "code": 200,
  "message": "QR code scanned successfully",
  "details": {
    "titularDestino": "Juan Perez",
    "cuentaDestino": "1234567890",
    "ciNitDestino": "1234567",
    "nombreBancoDestino": "Banco Ejemplo",
    "codigoBancoDestino": "101",
    "moneda": "BOB",
    "monto": 100.5,
    "glosa": "Pago proveedor",
    "numeroReferencia": "123456789",
    "fechaVencimiento": "2026-05-13T23:59:59.000Z"
  }
}

​
Response Cuando el QR No Puede Procesarse

{
  "code": null,
  "message": "The provided QR code is invalid or could not be processed."
}

​
Lista de Bancos

GET /v2/transactions/payouts/bank/banks?country=BO

​
Query Params

CampoTipoRequeridoDefaultDescripcion
countrystringNoBOCodigo ISO alpha-2 del pais para consultar bancos.
{
  "banks": [
    {
      "code": "101",
      "name": "Banco Ejemplo"
    }
  ]
}