Bancos compatibles y logos

Carga el catálogo actual de bancos — con imágenes de logo opcionales — y usa sus códigos en pagos, comerciantes y payouts.

Consulta los bancos

GET /v1/banks devuelve el catálogo de bancos persistido (actualizado semanalmente desde el directorio bancario nacional). Cada ítem incluye code (SIMF de 4 dígitos), name, services y logoUrl. Los bancos marcados como ocultos en ops no se incluyen. Crea los selectores a partir de esta respuesta en lugar de codificar la lista de forma fija.

curlbash

curl "${API_URL}/v1/banks" \
  --header "x-api-key: ${VEXPAY_API_KEY}"

Estructura de la respuestajson

[
  {
    "code": "0102",
    "name": "Banco de Venezuela",
    "services": [],
    "logoUrl": "https://pub-xxxxx.r2.dev/vebanking/banks/0102.png"
  },
  {
    "code": "0134",
    "name": "Banco Ejemplo",
    "services": [],
    "logoUrl": null
  }
]

Tip de UIjavascript

const banks = await fetch(`${process.env.API_URL}/v1/banks`, {
  headers: { 'x-api-key': process.env.VEXPAY_API_KEY },
}).then((r) => r.json());

// Muestra logo + nombre para que el cliente reconozca su banco
banks.map((b) => ({
  value: b.code,
  label: b.name,
  image: b.logoUrl, // null → iniciales / solo nombre
}));