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.