---
agentTools:
  projectIndex: https://docs.ninepay.com.br/llms.txt
  projectSearch: https://docs.ninepay.com.br/agentSearch?query=term1%20term2
---

# Estornar um pagamento

Devolva ao cliente um pagamento pago no cartão ou no PIX e acompanhe o reembolso até ser concluído.

## Confira se pode estornar

> Linhas destacadas: 1

Só pode ser estornado o pagamento com `status: "paid"`, pago no cartão (`credit`) há menos de 350 dias ou no PIX (`pix`) há menos de 90 dias, e com saldo suficiente na sua conta. Boleto e baixa manual não têm estorno pela API. O campo `can_refund` do pagamento ajuda a conferir antes.

## Peça o estorno

> Linhas destacadas: 2-6

Envie o `id` do pagamento em `payment.id`. O estorno é sempre do valor integral e volta ao cliente pelo mesmo meio em que ele pagou.

## Acompanhe o reembolso

> Linhas destacadas: 8-11

O estorno do cartão costuma ser imediato: o pagamento passa a `reversed` e sai o webhook `payment.updated`. O do PIX pode ficar em processamento. Consulte o pagamento com `with[]=refunds`: o `status` de cada reembolso vai de `new` e `processing` para `completed` (devolvido) ou `failed`.

Enquanto um estorno está em `processing`, outro pedido para o mesmo pagamento é recusado.

## Código

```bash cURL
# 1. Peça o estorno do pagamento
curl -X POST https://api.sandbox.cefispay.com.br/api/v1/payment/reversal \
  -H "Authorization: Bearer $NINEPAY_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{ "payment": { "id": 1470491 } }'

# 2. Acompanhe o reembolso
curl -g "https://api.sandbox.cefispay.com.br/api/v1/payments/1470491?with[]=refunds" \
  -H "Authorization: Bearer $NINEPAY_TOKEN" \
  -H "Accept: application/json"
```