Bank catalog
Directory of participants for TED and PIX-by-bank-account dropdowns. This is
not the credentialed account — that remains
GET /v1/accounts/{accountId}/bank-account (your own COMPE, branch and number).
TED (POST .../ted/out) requires a 3-digit COMPE. An 8-digit ISPB returns
400 invalid_bank_code. PIX by bank details prefers ISPB and also accepts
COMPE in the same field.
The UI needs both codes: the user picks “Itaú”, the integrator sends
bankCode: "341" on TED and bankIspb: "60701190" on PIX.
ted / pix matter because not every SPI participant does STR, and the
reverse is also true.
GET /v1/banks returns one row per participant. GET /v1/banks/{code}
accepts 341 or 60701190 and returns the same row (404 bank_not_found
if missing).
Source: STR participants — Banco Central. Payments do not validate against this catalog.