Listar Bancos (Open Finance)

Retorna os bancos habilitados para Open Finance na sua conta, de acordo com a configuração do seu parceiro bancário. Use o campo id de cada banco como bankId ao criar um Payin com paymentMethod: OPEN_FINANCE.

GET https://api.legacyecombr.com.br/payin/open-finance/banks

📘
Autenticação obrigatória
Envie o cabeçalho Authorization: Basic base64(pk_live_xxxx:sk_live_yyyy) — a mesma credencial usada em Criar Payin. A lista é resolvida a partir da configuração da sua conta.

Resposta

{
  "banks": [
    { "id": "nubank", "name": "Nubank", "logo": "https://logo.clearbit.com/nubank.com.br" },
    { "id": "itau", "name": "Itaú Unibanco", "logo": "https://logo.clearbit.com/itau.com.br" },
    { "id": "bb", "name": "Banco do Brasil", "logo": "https://logo.clearbit.com/bb.com.br" }
  ]
}

Campo	Tipo	Descrição
`banks`	`array`	Lista de bancos habilitados. Vazia quando o Open Finance não está configurado na conta
`banks[].id`	`string`	Identificador do banco — use como `bankId` ao criar o Payin
`banks[].name`	`string`	Nome de exibição do banco
`banks[].logo`	`string (URL)`	URL do logotipo (quando disponível)

👍
Como usar

Liste os bancos com este endpoint.

Apresente as opções ao cliente.

Crie o Payin enviando o id escolhido em bankId. Veja o guia de Open Finance.