Consultas - ON RAMP by Mesadepagos

El módulo Consultas permite consultar el saldo de la cuenta del business autenticado y el historial de transacciones para conciliación. Obtén un token con POST /v3/auth/login y envía Authorization: Bearer {accessToken} en cada request.

Saldo de la cuenta

GET /v3/transactions/payouts/balance

Respuesta: HTTP 200

{
  "fiat": "BOB",
  "available": 1000,
  "accounting": 1200,
  "held": 200,
  "lastCredit": "2026-05-12T12:00:00.000Z",
  "lastDebit": "2026-05-12T12:00:00.000Z"
}

Campo	Descripción
`fiat`	Moneda fiat de la cuenta, por ejemplo `BOB`.
`available`	Saldo disponible para operar.
`accounting`	Saldo contable, incluidos los fondos aún no liberados.
`held`	Saldo retenido, no disponible para operar.
`lastCredit`	Fecha del último crédito, o `null` si no hay créditos.
`lastDebit`	Fecha del último débito, o `null` si no hay débitos.

La respuesta de saldo v3 es un único objeto de cuenta. Usa available, accounting y held; el array de saldos por producto de v2 tiene un contrato diferente. HTTP 400 indica que falta configurar la cuenta o que el request es inválido, 401 indica un fallo de autenticación y 503 indica que no se pudo consultar el saldo. Consulta la referencia API de saldo.

Historial de Transacciones

GET /v3/transactions/history

El historial mantiene el contrato de request y response de v2. La paginación usa page=1 y limit=10 por defecto. Una consulta exitosa devuelve HTTP 200.

Query Params

Parámetro	Requerido	Descripción
`type`	No	Tipo de transacción.
`transactionStatus`	No	Estado de transacción.
`page`	No	Página solicitada.
`limit`	No	Registros por página.
`fromDate`	No	Fecha inicial.
`toDate`	No	Fecha final.
`search`	No	Texto de búsqueda.

El filtro type acepta deposit_virtual_account para consultar cobros de cuentas virtuales. Las transacciones de ese tipo también pueden aparecer en el historial sin filtro, con type: "deposit_virtual_account". amountFiat y fiatCode pueden ser 0 y N/A mientras llega la información del proveedor; consulta de nuevo más tarde para obtener los valores actualizados. Los cobros ACH de cuentas virtuales ATC incluyen además achNumber y recipientNumber cuando el proveedor los informa; en los demás tipos estos campos no se envían.

Response

{
  "transactions": [
    {
      "amountFiat": 69.6,
      "amountCrypto": 10,
      "assetCode": "USDC",
      "fiatCode": "BOB",
      "exchangeRate": 6.96,
      "transactionId": "550e8400-e29b-41d4-a716-446655440000",
      "type": "deposit_express",
      "status": "completed_transaction",
      "createdAt": "2026-05-12T12:00:00.000Z",
      "updatedAt": "2026-05-12T12:00:00.000Z",
      "externalReference": "ORDER-1001"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 1,
    "totalPages": 1
  }
}

Consulta la referencia API del historial para los filtros aceptados y los esquemas de respuesta. Usa el historial junto con Webhooks v3 para conciliar las notificaciones de estado.

​Saldo de la cuenta

​Respuesta: HTTP 200

​Historial de Transacciones

​Query Params

​Response

Saldo de la cuenta

Respuesta: HTTP 200

Historial de Transacciones

Query Params

Response