Skip to main content
DELETE
/
v4
/
i
/
baas
/
accounts
/
{accountId}
/
pix-keys
/
{pixKeyId}
curl -X DELETE https://api.owem.com.br/v4/i/baas/accounts/123456789012/pix-keys/75be0efc-51b0-47e1-803d-5162f06b755c \
  -H "Authorization: Basic $(echo -n 'SUA_API_KEY:SEU_SECRET' | base64)" \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "USER_REQUESTED",
    "observation": "Cliente solicitou remoção da chave PIX duplicada"
  }'

{
  "requestId": "f2bc75e4-2287-41b4-8aea-87191e2a5514",
  "success": true,
  "size": 1,
  "data": {
    "success": true,
    "message": "Chave PIX deletada com sucesso",
    "pixKeyId": "23ba97ef-efed-4f67-b359-ca564de54bc5"
  }
}

curl -X DELETE https://api.owem.com.br/v4/i/baas/accounts/123456789012/pix-keys/75be0efc-51b0-47e1-803d-5162f06b755c \
  -H "Authorization: Basic $(echo -n 'SUA_API_KEY:SEU_SECRET' | base64)" \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "USER_REQUESTED",
    "observation": "Cliente solicitou remoção da chave PIX duplicada"
  }'

​
Descrição

Remove uma chave PIX de uma conta bancária BaaS. A chave é removida tanto do sistema quanto do DICT (Diretório de Identificadores de Contas Transacionais) do Banco Central.
PROGRAMA BETA - Este endpoint está disponível apenas para parceiros aprovados no programa BAAS.
Ação Irreversível - A deleção de uma chave PIX é permanente. Após deletada, a chave não pode ser recuperada e pode demorar para ser reutilizada.

​
Autenticação

Este endpoint usa Basic Auth com sua API Key + Secret. O scope baas:accounts é configurado pela Owem na sua API Key.
Authorization: Basic {Base64(API_KEY:API_SECRET)}

​
Request

​
Headers

HeaderTipoObrigatórioDescrição
Authorizationstring✅Basic Auth (API Key + Secret em Base64)
Content-Typestring✅application/json

​
Path Parameters

ParâmetroTipoObrigatórioDescrição
accountIdstring✅ID da conta (retornado em onboarding/status)
pixKeyIdstring✅ID da chave PIX (retornado na listagem)

​
Body Parameters

ParâmetroTipoObrigatórioDescrição
reasonstring✅Motivo da deleção (ver tabela abaixo)
observationstring✅Descrição detalhada (25-500 caracteres)

​
Motivos de Deleção (reason)

ValorDescrição
USER_REQUESTEDSolicitação do cliente
ACCOUNT_CLOSUREEncerramento da conta
FRAUDSuspeita ou confirmação de fraude
PORTABILITYPortabilidade para outra instituição
OTHEROutro motivo (detalhar na observação)

​
Regras de Negócio

Chave Corrente

Não é possível deletar a chave corrente. A conta sempre precisa ter pelo menos uma chave ativa.

Como Deletar

Crie outra chave → defina como corrente → só então delete a antiga.

Observação

A observação deve ter entre 25 e 500 caracteres para garantir rastreabilidade.

DICT

A chave é removida do DICT do Banco Central automaticamente.
Chave corrente nunca pode ser deletada. A conta BaaS sempre deve manter pelo menos uma chave PIX ativa para receber transferências.

​
Response

​
Sucesso (200 OK)

{
  "requestId": "f2bc75e4-2287-41b4-8aea-87191e2a5514",
  "success": true,
  "size": 1,
  "data": {
    "success": true,
    "message": "Chave PIX deletada com sucesso",
    "pixKeyId": "23ba97ef-efed-4f67-b359-ca564de54bc5"
  }
}

​
Campos da Response

CampoTipoDescrição
successbooleanSe a operação foi bem-sucedida
messagestringMensagem de confirmação
pixKeyIdstringID da chave deletada

​
Erros

CódigoHTTPDescrição
BAAS_PIX_KEY_IS_CURRENT400Não pode deletar chave corrente
BAAS_PIX_KEY_NOT_FOUND404Chave PIX não encontrada
BAAS_PIX_KEY_WRONG_ACCOUNT400Chave não pertence à conta informada
BAAS_ACCOUNT_NOT_FOUND404Conta não encontrada
BAAS_ACCOUNT_WRONG_PARTNER403Conta não pertence ao parceiro
Para deletar a chave corrente: Primeiro crie outra chave, defina-a como corrente usando Definir Chave Corrente, e só então delete a chave antiga.
{
  "requestId": "f2bc75e4-2287-41b4-8aea-87191e2a5514",
  "success": true,
  "size": 1,
  "data": {
    "success": true,
    "message": "Chave PIX deletada com sucesso",
    "pixKeyId": "23ba97ef-efed-4f67-b359-ca564de54bc5"
  }
}