Pular para o conteúdo principal
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

curl --request POST \
  --url https://api.pagou.ai/v2/transfers/po_1001/cancel \
  --header "Authorization: Bearer SEU_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "reason": "wrong recipient"
  }'

​
Exemplo de resposta

{
  "success": true,
  "requestId": "req_2002",
  "data": {
    "id": "po_1001",
    "status": "cancelled"
  }
}

​
Erro comum

Status 409 
{
  "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.