Gerenciar Chave Pix

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

Tipo	Identificador	Observação
`DOCUMENT`	CPF ou CNPJ	Gerado automaticamente pelo banco para a conta principal
`EVP`	Chave aleatória (UUID)	Criada via API ou app, sem dados pessoais
`EMAIL`	Endereço de e-mail	Requer validação por código
`PHONE`	Número de celular	Requer 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

Introdução

Autenticação

Receber via Pix (Pix Cash-in)

Pagar via Pix (Pix Cash-out)

Cobranças via Boleto

Split de Pagamentos

Webhooks

Tipos de chave

Criar uma chave EVP

Consultar chaves cadastradas

Remover uma chave

Gerenciar pelo app ou internet banking

Referência da API

Criar chave Pix

Consultar chaves

Remover chave

​Tipos de chave

​Criar uma chave EVP

​Consultar chaves cadastradas

​Remover uma chave

​Gerenciar pelo app ou internet banking

​Referência da API

Criar chave Pix

Consultar chaves

Remover chave

Tipos de chave

Criar uma chave EVP

Consultar chaves cadastradas

Remover uma chave

Gerenciar pelo app ou internet banking

Referência da API