Skip to content

Domicílios bancários

Rotas aninhadas em /api/v1/integracao/produtores/{produtorId}/domicilios-bancarios.

A listagem retorna um objeto DomicilioBancarioViewResponse com:

  • eligible — se o produtor pode usar domicílios
  • statusMessage — motivo quando não elegível
  • accounts — lista de contas
Método Path Uso
GET .../domicilios-bancarios Listar + elegibilidade
POST .../domicilios-bancarios Cadastrar conta
PUT .../domicilios-bancarios/{domicilioId} Atualizar
DELETE .../domicilios-bancarios/{domicilioId} Excluir
PUT .../domicilios-bancarios/{domicilioId}/padrao Definir padrão

DomicilioBancarioRequest exige banco, agência, conta, tipo (CORRENTE ou POUPANCA), titular e documento. Chave Pix e dígitos são opcionais.

O domicílio padrão é usado em saques sem distribuição explícita entre contas.

Schemas e exemplos: referência da API.