Exclusão de chaves
stable
Este endpoint permite realizar a exclusão de chaves Pix de uma conta.
Pré-requisito
Para que seja possível utilizar este endpoint, é necessário que:
- A chave a ser excluída não esteja em um processo de reinvindicação. Se esse for o caso, é necessário aguardar o encerramento da disputa para realizar a exclusão.
Requisição
Requisição HTTP
DELETE 'https://api-mtls.sandbox.bankly.com.br/pix/entries/{{addressingKeyValue}}'
--curl --request DELETE \
--url 'https://api-mtls.sandbox.bankly.com.br/pix/entries/{{addressingKeyValue}}'\
--header 'Accept: application/json' \
--header 'api-version: 1' \
--header 'Authorization: Bearer {{Token}}'\
--header 'x-correlation-id: {{correlationId}}' \
Autorização
Para garantir a segurança nas requisições, todos os endpoints do Bankly utilizam scopes como parte do seu fluxo de autorização.
Esta requisição requer o scope descrito a seguir:
Scope | Descrição |
---|---|
pix.entries.delete | Concede acesso para excluir uma chave de endereçamento. |
Cabeçalhos (Headers)
Nome | Descrição |
---|---|
api-version | Obrigatório. Versão da API. Atualmente estamos na versão 1.0. |
Authorization | Obrigatório. Token de autorização do tipo Bearer. |
x-correlation-id | Obrigatório. Informe um GUID, sendo um novo cada requisição. |
Parâmetros da rota (Path)
No path desta requisição envie o seguinte campo:
Nome | Tipo | Descrição |
---|---|---|
addressingKeyValue | path | Obrigatório. Valor da chave de endereçamento a ser excluída. Veja na tabela a seguir as possibilidades de preenchimento. |
Chave de endereçamento
Chave | Instrução de preenchimento |
---|---|
CPF | 11 dígitos, sem formatação. |
CNPJ | 14 dígitos, sem formatação. |
Todos os caracteres em minúsculo. Tamanho máximo de 72 caracteres. | |
Phone (número de telefone celular) | Composto por símbolo ‘+’, seguido pelo código do país, DDD e número de celular com até nove dígitos. Ex.: +5523415162342. |
EVP | Tamanho máximo de 36 caracteres. Exemplo: 123e4967-e89b-12d3-a456-426655440000. |
Corpo da requisição (Body)
Não é necessário enviar campos no body desta requisição.
Resposta (Response)
O status code 204 indicará que a chave foi excluída com sucesso.
Dica
Para simular uma requisição nesse endpoint, acesse o API Reference.
Erros
Este endpoint pode retornar erros específicos, conforme a tabela a seguir:
Status code | Código | Descrição |
---|---|---|
400 | INVALID_ENTRY_STATUS_FOR_EXCLUSION | A chave só pode ser excluída por seu proprietário. |
422 | ENTRY_NOT_FOUND | Chave não encontrada. |
422 | ENTRY_REGISTERED_TO_ANOTHER_PARTNER | A chave foi cadastrada para outro parceiro Bankly e é por ele que ela deve ser excluída. |
422 | ENTRY_LOCKED_BY_CLAIM | A chave está em processo de reivindicação e, portanto, não pode ser excluída. |
Válido lembrar que a API também poderá retornar erros comuns entre todos os endpoints.
Eventos
Este endpoint não possui eventos relacionados a ele.
Updated about 1 month ago