Skip to main content
Uma chave Pix é um apelido para a sua conta. Em vez de passar agência e número de conta para quem vai te pagar, basta compartilhar a chave, que pode ser seu CPF, CNPJ, e-mail, celular ou uma chave aleatória (EVP). Você pode gerenciar suas chaves pelo aplicativo, internet banking ou via API. Esta página foca na gestão via API, com suporte à criação de chaves do tipo EVP (chave aleatória).
Cada conta suporta até 5 chaves Pix simultâneas para Pessoa Física e até 20 chaves Pix simultâneas para Pessoa Jurídica, conforme regra do Banco Central.

​
Tipos de chave

TipoIdentificadorObservação
DOCUMENTCPF ou CNPJGerado automaticamente pelo banco para a conta principal
EVPChave aleatória (UUID)Criada via API ou app, sem dados pessoais
EMAILEndereço de e-mailRequer validação por código
PHONENúmero de celularRequer validação por SMS
Para automações e integrações onde você precisa gerar múltiplas chaves sem expor dados pessoais, o tipo EVP é o mais indicado. A chave é um UUID de 36 caracteres gerado automaticamente.

​
Criar uma chave EVP

Chaves EVP não exigem nenhum dado adicional no corpo da requisição, nem validação por código. Basta enviar o entryType.
cURL
curl --request POST \
  --url 'https://apisandbox.delbank.com.br/baas/api/v1/pix/dict/entries' \
  --header 'Content-Type: application/json' \
  --header 'x-delbank-api-key: {{apiKey}}' \
  --header 'x-delfinance-account-id: {{accountId}}' \
  --header 'IdempotencyKey: {{$guid}}' \
  --data '{
    "entryType": "EVP"
}'
A resposta contém a chave gerada, que pode ser compartilhada imediatamente para receber Pix.

​
Consultar chaves cadastradas

Retorna todas as chaves Pix registradas na conta.
cURL
curl --request GET \
  --url 'https://apisandbox.delbank.com.br/baas/api/v1/pix/dict/entries' \
  --header 'x-delbank-api-key: {{apiKey}}' \
  --header 'x-delfinance-account-id: {{accountId}}'
Resposta
[
    { "key": "14414076000118" },
    { "key": "d882fe5b-0b8a-4b35-ac30-ed862bfa2222" }
]

​
Remover uma chave

Para remover uma chave, informe o entryType e o valor da key no corpo da requisição.
cURL
curl --request DELETE \
  --url 'https://apisandbox.delbank.com.br/baas/api/v1/pix/dict/entries' \
  --header 'Content-Type: application/json' \
  --header 'x-delbank-api-key: {{apiKey}}' \
  --header 'x-delfinance-account-id: {{accountId}}' \
  --header 'IdempotencyKey: {{$guid}}' \
  --data '{
    "entryType": "EVP",
    "key": "d882fe5b-0b8a-4b35-ac30-ed862bfa2222"
}'
A resposta de sucesso é 204 No Content, sem corpo.

​
Gerenciar pelo app ou internet banking

Se preferir não usar a API, todas as operações de chave Pix também estão disponíveis no aplicativo e no internet banking da Delfinance, incluindo os tipos que exigem validação por código (e-mail e celular).

​
Referência da API

Criar chave Pix

POST /baas/api/v1/pix/dict/entries

Consultar chaves

GET /baas/api/v1/pix/dict/entries

Remover chave

DELETE /baas/api/v1/pix/dict/entries