Definição de Conta Bancária Principal do Emissor

Este endpoint promove uma conta bancária existente do emissor a conta principal (is_default: true). A conta anteriormente marcada como principal passa automaticamente a is_default: false.

---

Trocando a conta bancária principal do emissor

O emissor pode ter várias contas bancárias cadastradas, e apenas uma é marcada como principal. Para corrigir uma conta principal com dados incorretos (dígito, agência, ISPB), use o fluxo abaixo.

Pré-requisito

O emissor precisa estar no status in_filling. Após esse status, a conta principal não pode ser alterada — comportamento intencional, dado que a conta principal é referenciada em operações financeiras.

Fluxo de troca (3 chamadas)

1. POST .../bank_account → cria a nova conta (correta).
2. POST .../bank_account/{key}/set_default → promove a nova conta a principal.
3. DELETE .../bank_account/{old_key} → remove a conta antiga.

A mesma restrição de ordem se aplica: como não é permitido deletar a conta principal, a promoção precisa vir antes da remoção. Tentar inverter retorna HTTP 400 / ISS0000012.

---

Request

ENDPOINT

/issuer_management/issuer/ISSUER-KEY/bank_account/BANK-ACCOUNT-KEY/set_default

MÉTODO

POST

Path Params

Campo	Tipo	Descrição	Caracteres
ISSUER-KEY	string	Chave única do emissor (UUID v4).	36
BANK-ACCOUNT-KEY	string	Chave única da conta bancária que será promovida a principal (UUID v4).	36

Request Body

Nenhum conteúdo é enviado no corpo da requisição.

---

Response

STATUS

204

Conta promovida a principal. Nenhum conteúdo é retornado no corpo da resposta.

---

Erros

HTTP	Código	Cenário
400	ISS0000011	Emissor não está em in_filling.
403	ISS000011	Tenant não tem acesso a esse emissor.
404	ISS000005	bank_account_key não encontrado para esse emissor.
404	ISS000009	issuer_key não encontrado.