Pular para o conteúdo principal
Use reembolsos para transações pagas que precisem de reversão total ou parcial.

​
Operação de reembolso

PUT /v2/transactions/{id}/refund

​
Exemplo de requisição

curl --request PUT \
  --url https://api.pagou.ai/v2/transactions/tr_1001/refund \
  --header "Authorization: Bearer SEU_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "amount": 500,
    "reason": "requested_by_customer"
  }'

​
Exemplo de resposta

{
  "success": true,
  "requestId": "req_1202",
  "data": {
    "transaction_id": "tr_1001",
    "status": "partially_refunded",
    "refunded_amount": 500
  }
}

​
Erro comum

Status 409 
{
  "type": "https://api.pagou.ai/problems/conflict",
  "title": "Conflict",
  "status": 409,
  "detail": "The transaction cannot be refunded in its current state."
}
Como corrigir: reconcilie a transação antes e permita reembolso apenas a partir de estados pagos elegíveis no seu produto e nas ferramentas operacionais.

​
Regras operacionais

  • Use seu próprio ID de solicitação de reembolso ou ticket para evitar ações duplicadas.
  • Persista a solicitação de reembolso, o ID da transação e o status resultante da transação.
  • Atualize o estado financeiro visível ao cliente apenas após confirmação por webhook ou reconciliação.

​
Próximos passos