Cancelar agendamento

stable

Este endpoint permite que o usuário pagador possa solicitar o cancelamento de um agendamento Único ou de Pix Automático

Pré-requisito

Para que seja possível utilizar este endpoint, é necessário que:

O cliente de nosso parceiro possua um ou mais pagamentos agendados.

Requisição (Request)

Requisição HTTP

DELETE https://api-mtls.sandbox.bankly.com.br/pix/scheduling-payments/{requestIdentifier}

curl --request DELETE \
     --url https://api-mtls.sandbox.bankly.com.br/pix/scheduling-payments/RR595881112025031252S6M18DDD1 \
     --header 'Authorization: bearer' \
     --header 'accept: application/json' \
     --header 'api-version: 1' \
     --header 'x-bkly-pix-user-id: 123456789' \
     --header 'x-correlation-id: haseher-2414n-bnjk2-213jl'

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.schedule-payment.write`	Concede acesso para cancelar um agendamento via Pix automático.

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.
`x-correlation-id`	Obrigatório. Identificador de correlação da requisição.	Formato GUID v4. A cada requisição, deve-se gerar um novo GUID.

Parâmetros da rota (Path)

No path desta requisição envie os seguintes campos:

Nome	Tipo	Descrição	Especificação
`requestIdentifier`	`path`	Obrigatório. Identificador do agendamento.	—

Corpo da requisição (Body)

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

Resposta (Response)

O status code 200 indicará sucesso na consulta.

Sendo bem-sucedido, o retorno irá trazer os seguintes campos em formato JSON:

Nome	Tipo	Descrição
`requestIdentifier`	`string`	Identificador do agendamento.
`reason`	`string`	Motivo de cancelamento.
`status`	`string`	Status do cancelamento.
`transactionIdentification`	`string`	Identificador da transação utilizado para conciliação do recebedor.
`uidSchedule`	`string`	Identificador de recorrência.
`dateSchedule`	`date`	Data do agendamento.

{
  "requestIdentifier": "E5958811120250324200809925PFR97O",
  "reason": "ACCT",
  "status": "CANCELED",
  "transactionIdentification": "afb1c976-0195-1000-fb69-sadsaffa8641d"
}

{
  "requestIdentifier": "E5958811120250324200809925PFR97O",
  "status": "CANCELED",
  "uidSchedule": "39f42215-0196-1000-ae4a-ffffffff8d2d",
  "dateSchedule": "2025-04-15"
}

👍
Dica
Para simular uma requisição nesse endpoint, acesse o API Reference.

Erros

Este endpoint não retorna erros específicos. Porém, ele poderá retornar alguns erros comuns entre todos os endpoints.

Eventos

Este endpoint não possui eventos relacionados a ele.

Updated 14 days ago