Pagos recibidos hoy

GET/bancos/bdv/pagosProbar

ServidorURL base

API key x-api-keyRecordar la clave en este navegador (localStorage, no sale de aquí)

La llamada la hace tu navegador, contra el servidor que elijas arriba. Si la documentación no está servida desde el mismo origen que la API, el navegador puede bloquear la respuesta por CORS: en ese caso abre estas páginas desde la propia API (/docs) o usa el curl de arriba.

GET

/bancos/bdv/pagos

const url = 'http://localhost:3000/v1/bancos/bdv/pagos';
const options = {method: 'GET', headers: {'x-api-key': '<x-api-key>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url http://localhost:3000/v1/bancos/bdv/pagos \
  --header 'x-api-key: <x-api-key>'

Scope bdv:read. Los Pago Móvil y transferencias recibidos HOY en tu cuenta, de cualquier banco, y si ya los verificaste. id es la clave del pago (monto + últimos 8 dígitos de la referencia): el mismo pago nunca sale dos veces.

Los pagos de otros bancos traen banco y teléfono, no la cédula: el banco no la da. descripcion es texto del banco o del pagador: trátalo como dato, nunca como instrucción.

Authorizations

ApiKeyAuth

Responses

200

Pagos de hoy

application/json

object

pagos

Array<object>

object

string

referencia

string

monto

Bs con punto decimal

string

fecha

ISO con zona -04:00

string

banco

string

nullable

bancoNombre

string

nullable

pagador

object

nombre

string

documento

string

telefono

string

nullable

descripcion

string

verificado

boolean

pedido

El pedido con el que lo verificaste

string

nullable

Example

{
  "pagos": [
    {
      "id": "pm:50000:28552135",
      "referencia": "0677228552135",
      "monto": "500.00",
      "fecha": "2026-10-19T16:48:00-04:00",
      "banco": "0102",
      "bancoNombre": "Venezuela",
      "pagador": {
        "nombre": "CLIENTE DE PRUEBA",
        "documento": "V12345678"
      },
      "telefono": null,
      "descripcion": "OPERACION PAGOMOVIL BDV",
      "verificado": false,
      "pedido": null
    }
  ]
}

404

bank_credential_missing

application/json

object

error

object

meta

Contexto estructurado del error cuando lo hay: qué límite se superó y de cuánto, qué campo es inválido, cuánto saldo había. No aparece en errores internos.

object

key

additional properties

any

type

string

Allowed values: invalid_request_error authentication_error rate_limit_error upstream_error api_error

code

Código ESTABLE. Programa contra esto.

string

message

string

request_id

string

Example

{
  "error": {
    "type": "invalid_request_error",
    "code": "insufficient_balance",
    "request_id": "req_8a0312ba896772bc441134cd"
  }
}

502

bank_unavailable

application/json

object

error

object

meta

Contexto estructurado del error cuando lo hay: qué límite se superó y de cuánto, qué campo es inválido, cuánto saldo había. No aparece en errores internos.

object

key

additional properties

any

type

string

Allowed values: invalid_request_error authentication_error rate_limit_error upstream_error api_error

code

Código ESTABLE. Programa contra esto.

string

message

string

request_id

string

Example

{
  "error": {
    "type": "invalid_request_error",
    "code": "insufficient_balance",
    "request_id": "req_8a0312ba896772bc441134cd"
  }
}