Skip to main content
curl -X DELETE "https://api.chargefy.io/v1/bank-accounts/ba_123" \
  -H "Authorization: Bearer {{API_KEY}}" \
  -H "Organization: org_789"

{
  "id": "ba_123",
  "object": "bank_account",
  "deleted": true
}
Desconecta uma bank_account da organização atuante. A credencial bancária continua preservada no cadastro financeiro; esta operação apenas remove o vínculo que permite que a organização veja e use essa conta.

​
Autenticação

CredencialAcesso
JWT de usuárioRequer acesso à organização.
API key da organizaçãoRequer escopo write ou admin.
API key da plataformaOrganização conectada indicada no header Organization.

​
Parâmetros de caminho

​
id
string
required
ID da conta bancária (ba_*).
curl -X DELETE "https://api.chargefy.io/v1/bank-accounts/ba_123" \
  -H "Authorization: Bearer {{API_KEY}}" \
  -H "Organization: org_789"

​
Resposta

200 OK com confirmação de desconexão. 
{
  "id": "ba_123",
  "object": "bank_account",
  "deleted": true
}

​
Webhooks

Desconexão bem-sucedida emite bank.account.detached com a bank_account completa como estava imediatamente antes da desconexão. Quando a conta conectada da organização muda, também emite organization.updated com data.previous_attributes.bank_account.

​
Erros

StatusQuando
400ID ausente.
401Credencial ausente, inválida, revogada ou expirada.
403Credencial sem acesso à organização ou sem escopo suficiente.
404Conta bancária inexistente ou fora do escopo da organização atuante.
409Contas bancárias ainda não são suportadas no sandbox.
500Erro temporário desconectando a conta bancária. Faça retry.