Excluir uma conta para saques

Desconecta uma payout_account da organização atuante. O destino de repasses continua preservado no cadastro financeiro; esta operação apenas remove o vínculo que permite que a organização veja e use essa conta para saques.

Autenticação

Credencial	Acesso
API key da organização	Requer escopo `write` ou `admin`.
API key da plataforma	Organização conectada indicada no header `Organization`.

Parâmetros de caminho

string

required

ID da conta para saques (pa_*).

curl -X DELETE "https://api.chargefy.io/v1/payout-accounts/pa_d6HV5h2XK8KDWLGR" \
  -H "Authorization: Bearer {{API_KEY}}" \
  -H "Organization: org_jSTwXizF3Ff6BtES"

Resposta

200 OK com confirmação de desconexão.

{
  "id": "pa_d6HV5h2XK8KDWLGR",
  "object": "payout_account",
  "deleted": true
}

Webhooks

Desconexão bem-sucedida emite payout.account.detached com a payout_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.payout_account.

Erros

Status	`code`	Quando
`400`	`invalid_request`	ID ausente.
`401`	`authentication_failed`	API key ausente, inválida, revogada ou expirada.
`403`	`permission_denied`	API key sem acesso à organização ou sem escopo suficiente.
`404`	`resource_missing`	Conta para saques inexistente ou fora do escopo da organização atuante.
`409`	`sandbox_unsupported`	Contas para saques ainda não são suportadas no sandbox.
`500`	`internal_error`	Erro temporário desconectando a conta para saques. Faça retry.

Fundamentos da API

Objetos de sistema

Webhooks e eventos

SDKs

MCP

Excluir uma conta para saques

Autenticação

Parâmetros de caminho

Resposta

Webhooks

Erros

​Autenticação

​Parâmetros de caminho

​Resposta

​Webhooks

​Erros

Autenticação

Parâmetros de caminho

Resposta

Webhooks

Erros