# Reembolso

URL: https://staging.pagpolar.com/docs/referencia/entidades/reembolso

> Pedido de reembolso de uma venda, total ou parcial, com o andamento e a venda de origem.

Pedido de reembolso de uma venda, total ou parcial, com o andamento e a venda de origem.

## Onde aparece

* [`GET /refunds`](/docs/referencia/reembolsos/list-refunds)
* [`POST /refunds`](/docs/referencia/reembolsos/create-refund)

## Campos

Campos anuláveis chegam com `null`. Campos com opções fixas listam todos os valores.

| Campo | Tipo | Obrigatório | Nulo | Descrição |
| --- | --- | --- | --- | --- |
| `id` | texto (uuid) | não | não | — |
| `status` | enum | não | não | PENDING aguarda o vendedor · ACCEPTED/ACCEPTED_BY_ADMIN aceito pelo vendedor, pelo admin ou automaticamente · REFUSED/REFUSED_BY_ADMIN recusado · WAITING_SEND, WAITING_TRACK_CODE e SENT são etapas da devolução do produto físico · REFUNDING estorno pedido ao gateway · REFUNDED estorno concluído · CANCELED pedido desfeito · FAILED o gateway recusou o estorno. Valores: `PENDING`, `ACCEPTED`, `ACCEPTED_BY_ADMIN`, `REFUSED`, `REFUSED_BY_ADMIN`, `WAITING_SEND`, `WAITING_TRACK_CODE`, `SENT`, `REFUNDING`, `REFUNDED`, `CANCELED`, `FAILED`. Exemplo: `REFUNDED`. |
| `requested_by` | enum | não | não | Quem pediu o reembolso. `CLIENT` é o pedido do comprador — aberto por ele no painel ou informado por você em `POST /refunds`. `SELLER` é a decisão do vendedor, no painel ou pela API. Valores: `CLIENT`, `SELLER`. Exemplo: `CLIENT`. |
| `is_partial` | booleano | não | não | `true` quando o reembolso é só de alguns itens. Exemplo: `false`. |
| `refund_amount` | número | não | sim | Valor do reembolso parcial, em reais. `null` no reembolso total — vale o total da venda. Exemplo: `null`. |
| `reason` | texto | não | sim | Motivo informado no pedido. Exemplo: `Não atendeu às expectativas`. |
| `customer_observation` | texto | não | sim | Exemplo: `null`. |
| `refused_reason` | texto | não | sim | Motivo da recusa, quando recusado. Exemplo: `null`. |
| `canceled_reason` | texto | não | sim | Motivo do cancelamento, quando cancelado. Exemplo: `null`. |
| `return_tracking` | objeto | não | sim | Rastreio da devolução do produto físico. `null` quando não há devolução. |
| `return_tracking.code` | texto | não | não | Exemplo: `BR123456789BR`. |
| `return_tracking.provider` | texto | não | sim | — |
| `return_tracking.sent_at` | texto (date-time) | não | sim | — |
| `return_tracking.received_at` | texto (date-time) | não | sim | — |
| `sale` | objeto | não | não | — |
| `sale.identifier` | texto | não | não | Exemplo: `PPO9876543210`. |
| `sale.status` | texto | não | não | Exemplo: `REFUNDED`. |
| `sale.payment_method` | texto | não | não | Exemplo: `PIX`. |
| `sale.total_amount` | número | não | não | Exemplo: `197`. |
| `customer` | [Cliente](/docs/referencia/entidades/cliente) | não | não | — |
| `created_at` | texto (date-time) | não | não | Exemplo: `2026-01-25T09:00:00.000Z`. |
| `updated_at` | texto (date-time) | não | não | Exemplo: `2026-01-27T16:20:00.000Z`. |