Cancelar contestação - Autoatendimento MED

A funcionalidade de cancelamento de contestação permite que o usuário encerre uma contestação MED 2.0 que ainda esteja em andamento. Ao acessar os detalhes de uma contestação ativa, o usuário pode optar por cancelá‑la, encerrando definitivamente o processo sem continuidade de análise. O cancelamento somente é permitido quando a contestação está em status elegível e ainda não passou por decisão final.

Restrições da funcionalidade:

Não é possível cancelar contestações com status Approved, Rejectedou Canceled.

Este endpoint permite que o usuário pagador possa criar uma notificação de infração.

Requisição (Request)

Requisição HTTP

DELETE https://api-mtls.sandbox.bankly.com.br/pix/branches/{branch}/accounts/{account}/infractions/{protocolNumber}

curl --request DELETE \
     --url https://api-mtls.sandbox.bankly.com.br/pix/branches/0001/accounts/123456789/infractions/20250712175650999455 \
     --header 'Authorization: Token' \
     --header 'accept: application/json' \
     --header 'api-version: 1' \
     --header 'x-bkly-pix-user-id: 12312312387' \
     --header 'x-correlation-id: bf700e6e-88a6-4368-a392-420e6726effa'

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.infraction-notifications.write`	Concede acesso para cancelar uma contestação.

Cabeçalhos (Headers)

Nome	Descrição	Especificação
`api-version`	Obrigatório. Versão da API. Atualmente estamos na versão 1.	—
`Authorization`	Obrigatório. Token de autorização do tipo Bearer.	—
`x-bkly-pix-user-id`	Obrigatório. Número do documento do usuário que está fazendo a requisição.	Informe somente números.

Parâmetros da rota (Path)

Nome	Descrição	Especificação
`branch`	Agência do Pagador	—
`account`	Conta do Pagador	—

Corpo da requisição (Body)

Não é necessário enviar campos no body desta requisição.

Resposta (Response)

O status code 204 indicará sucesso no cancelamento da contestação.

👍
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	Mensagem	Significado
401	UNAUTHORIZED	—	—
403	FORBIDDEN	—	—
404	—	—	—
422	INFRACTION_CANNOT_BE_CANCELED	The infraction cannot be canceled	A infração não pode ser cancelada.

Eventos

Este endpoint não possui eventos relacionados a ele.

Updated 1 day ago