# Bank Accounts (Brazil)

Para receber pagamentos de entrada na conta bancária da sua organização, é necessário registrar as contas bancárias (individuais e empresariais) usando a Payments API da Belvo.

- Contas bancárias **individuais** devem ser criadas para cada pagador (seu cliente).
- Contas bancárias **empresariais** precisam ser criadas para o beneficiário do pagamento (sua organização).

{% admonition type="info" name="Versionamento de Recursos" %}
  Este endpoint suporta versionamento a nível de recurso. Ao incluir o cabeçalho `X-Belvo-API-Resource-Version: Payments-BR.V2`, você pode acessar os formatos de requisição e resposta mais recentes (V2). Se o cabeçalho não for fornecido, o formato padrão (V1) será utilizado. Consulte a documentação da API para detalhes sobre as diferenças entre as versões.
{% /admonition %}

## Registrar uma nova conta bancária

 - [POST /payments/br/bank-accounts/](https://developers.belvo.com/pt-br/apis/belvoopenapispec/bank-accounts-(brazil)/registerbankaccountbrazil.md): Registre uma nova conta bancária da qual você pode enviar ou solicitar fundos.

## Listar todas as contas bancárias

 - [GET /payments/br/bank-accounts/](https://developers.belvo.com/pt-br/apis/belvoopenapispec/bank-accounts-(brazil)/listbankaccountbrazil.md): Liste todas as contas bancárias associadas à sua conta Belvo.

## Ativar ou desativar uma conta bancária

 - [PATCH /payments/br/bank-accounts/{id}/](https://developers.belvo.com/pt-br/apis/belvoopenapispec/bank-accounts-(brazil)/patchbankaccountbrazil.md): Atualiza se uma conta bancária está ativa definindo active como true ou false.

Definir active como false desativa a conta bancária identificada no caminho. Contas desativadas são ignoradas para verificações de duplicidade na mesma instituição, agência e número de conta, o que permite registrar uma nova conta bancária com os mesmos dados bancários quando for necessário corrigir informações incorretas do titular (como nome ou CPF/CNPJ) ou erros semelhantes de um registro inicial.

## Obter detalhes sobre uma conta bancária

 - [GET /payments/br/bank-accounts/{id}/](https://developers.belvo.com/pt-br/apis/belvoopenapispec/bank-accounts-(brazil)/detailbankaccountbrazil.md): Obtenha os detalhes sobre uma conta bancária específica.