> ## 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 repasse

> Cancele um repasse que ainda não foi executado. O valor permanece na conta de recebimento.

> [!WARNING]
>
> **Funcionalidade em beta.** Contrato em proposta, sujeito a mudanças. Veja o guia [Acompanhar repasses](https://docs.delfinance.com.br/guias/split-pagamentos/acompanhar-repasses.md).

Cancela um repasse em `SCHEDULED` ou `PENDING`. Nesses status, nenhum dinheiro saiu da conta de recebimento, então o valor do repasse apenas permanece nela. O cancelamento é irreversível.

> [!NOTE]
>
> Nesta fase, todo repasse é executado logo após o recebimento, então um repasse fica em `PENDING` por pouquíssimo tempo. O cancelamento ganha uso real com os repasses com data futura (`SCHEDULED`), previstos para uma próxima fase.

## Headers

**x-delbank-api-key** `string` *required*

Sua API key.

**x-delfinance-account-id** `string` *required*

Número da conta de recebimento.

## Path params

**payoutId** `string` *required*

Identificador do repasse (`id`), obtido em [Listar repasses](https://docs.delfinance.com.br/api-reference/split-pagamentos/listar-repasses.md) ou em [Consultar recebimento com split](https://docs.delfinance.com.br/api-reference/split-pagamentos/consultar-recebimento.md).

## Body

**reason** `string` *required*

Motivo do cancelamento. Fica registrado em `cancelReason`. Até 255 caracteres.

## Response

Retorna o repasse atualizado, com `status` igual a `CANCELED` e os campos `canceledAt` e `cancelReason` preenchidos. A estrutura é a mesma descrita em [Listar repasses](https://docs.delfinance.com.br/api-reference/split-pagamentos/listar-repasses.md#response).

## Erros

| HTTP | Código | Quando acontece |
| - | - | - |
| `404` | `SPLIT_PAYOUT_NOT_FOUND` | Não existe repasse com esse `payoutId` na conta de recebimento |
| `422` | `SPLIT_PAYOUT_NOT_CANCELABLE` | O repasse não está em `SCHEDULED` nem em `PENDING`. Repasses em `PROCESSING`, `PAID`, `FAILED` ou `CANCELED` não podem ser cancelados |

```bash cURL theme={null}
curl --location 'https://apisandbox.delbank.com.br/baas/api/v1/split-payments/payouts/3f9b2c7e-8d14-4b6a-a0e5-71c2d9f4b8a3/cancel' \
--header 'Content-Type: application/json' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}' \
--data '{
    "reason": "Pedido devolvido pelo comprador"
}'
```

```json 200 theme={null}
{
    "id": "3f9b2c7e-8d14-4b6a-a0e5-71c2d9f4b8a3",
    "order": {
        "id": "e7a0c1d2-5b3f-4a8e-9c61-2f4d8b7a1e90",
        "source": "QR_CODE",
        "grossAmount": 200.00,
        "tariffAmount": 2.00,
        "splitBaseAmount": 198.00,
        "createdAt": "2026-10-26T14:32:10.000Z"
    },
    "status": "CANCELED",
    "transferType": "INTERNAL",
    "instructionType": "PERCENTAGE",
    "instructionAmount": 10,
    "amount": 19.80,
    "paymentDate": "2026-10-26",
    "beneficiary": {
        "number": "10073",
        "branch": "0001",
        "type": "PAYMENT",
        "holder": {
            "document": "12345678000190",
            "name": "LOJA DO JOÃO LTDA",
            "type": "LEGAL"
        },
        "participant": {
            "ispb": "38224857",
            "name": "DELFINANCE SCD S.A."
        }
    },
    "executedTransactionId": null,
    "endToEndId": null,
    "failureReason": null,
    "paidAt": null,
    "canceledAt": "2026-10-26T14:35:00.000Z",
    "cancelReason": "Pedido devolvido pelo comprador",
    "createdAt": "2026-10-26T14:32:10.000Z",
    "updatedAt": "2026-10-26T14:35:00.000Z"
}
```

```json 422 theme={null}
{
    "code": "SPLIT_PAYOUT_NOT_CANCELABLE",
    "message": "O repasse está em PAID e não pode ser cancelado."
}
```


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