Supported banks and logos

Load the current bank catalog — including optional logo images — and use its codes in payments, merchants, and payouts.

List banks

GET /v1/banks returns the persisted bank catalog (refreshed weekly from BNC Services/Banks). Each item includes `code` (4-digit SIMF), `name`, `services`, and `logoUrl`. Banks tagged as hidden in ops are omitted. Build selectors from this response instead of hard-coding the list.

curlbash

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

Response shapejson

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

UI tipjavascript

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

// Show logo + name so customers spot their bank faster
banks.map((b) => ({
  value: b.code,
  label: b.name,
  image: b.logoUrl, // null → render initials / name only
}));