> ## Documentation Index
> Fetch the complete documentation index at: https://docs.delfinance.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Cancelar agendamento

> Cancela o débito de um ciclo do Pix Automático. A autorização continua ativa.

> [!NOTE]
>
> Para o passo a passo completo, veja o guia [Cancelar](https://docs.delfinance.com.br/guias/pix/pix-automatico/cancelar.md#cancelar-um-agendamento).

## Headers

**Authorization** `string` *required*

Sua API key, sem o prefixo `Bearer`.

**IdempotencyKey** `string` *required*

Chave de idempotência. Use um valor novo a cada chamada.

## Path params

**endToEndId** `string` *required*

`endToEndId` do agendamento, retornado em [Listar agendamentos](https://docs.delfinance.com.br/api-reference/pix-automatico/listar-agendamentos.md).

## Body

**cancellationRequesterType** `string` *required*

Quem cancela: `RECEIVER` ou `PAYER`.

**receiverIspb** `string` *required*

ISPB da instituição do recebedor. Use `38224857` quando o recebedor tem conta na Delfinance.

**cancellationReason** `string` *required*

Motivo: `REQUESTED_BY_PAYEE`, `REQUESTED_BY_PAYER`, `AUTHORIZATION_CANCELLED`, `ACCOUNT_CLOSED`, `ACCOUNT_BLOCKED`, `SETTLEMENT_ERROR` ou `OTHER_PARTICIPANT_REQUEST`.

**beneficiaryConciliationId** `string`

Referência de conciliação do recebedor.

## Response

**id** `string`

Identificador interno do agendamento.

**recurrenceId** `string`

Identificador da recorrência.

**endToEndId** `string`

Identificador do débito cancelado.

**beneficiaryReconciliationId** `string`

Referência de conciliação do recebedor.

**requestedAt** `string`

Data de criação do agendamento, não do cancelamento.

Se o `endToEndId` não existir, a resposta é `204 No Content`.

```bash cURL theme={null}
curl --location 'https://apisandbox.delbank.com.br/baas/api/v1/pix/automatic/scheduling/E38224857202612010300a1b2c3d4e5f/cancel' \
--header 'Content-Type: application/json' \
--header 'Authorization: {{apiKey}}' \
--header 'IdempotencyKey: {{$guid}}' \
--data '{
    "cancellationRequesterType": "RECEIVER",
    "receiverIspb": "38224857",
    "cancellationReason": "REQUESTED_BY_PAYEE"
}'
```

```json 200 theme={null}
{
    "id": "c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f",
    "recurrenceId": "RR3822485720261027B7C8D9E0F1A",
    "endToEndId": "E38224857202612010300a1b2c3d4e5f",
    "requestedAt": "2026-12-01T03:00:12.000Z"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.