> ## Documentation Index
> Fetch the complete documentation index at: https://developer.pagou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Cancelar transferência Pix

> Cancele uma transferência pendente com segurança operacional.

Cancele apenas quando a transferência ainda estiver em um estado cancelável no seu fluxo operacional.

## Endpoint

`POST /v2/transfers/{id}/cancel`

## Exemplo de requisição

```bash theme={null}
curl --request POST \
  --url https://api.pagou.ai/v2/transfers/018f1f2e-7b45-7c9a-8d3e-1a2b3c4d5e72/cancel \
  --header "Authorization: Bearer SEU_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "reason": "wrong recipient"
  }'
```

## Exemplo de resposta

```json theme={null}
{
  "success": true,
  "requestId": "0190a2b4-18a7-7de0-9a43-69b7cf261201",
  "data": {
    "id": "018f1f2e-7b45-7c9a-8d3e-1a2b3c4d5e72",
    "status": "cancelled"
  }
}
```

## Erro comum

Status `409`

```json theme={null}
{
  "type": "https://api.pagou.ai/problems/conflict",
  "title": "Conflict",
  "status": 409,
  "detail": "The transfer cannot be cancelled in its current state."
}
```

Como corrigir: mostre a ação de cancelamento apenas em estados que sua operação ainda possa interromper com segurança. Se o estado estiver incerto, consulte a transferência antes.

## Regras

* Confirme o estado atual da transferência antes de exibir o botão de cancelamento.
* Reconcilie após qualquer tentativa de cancelamento incerta.
* Atualize a interface operacional apenas depois do webhook ou de confirmação por `GET`.