> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.fluveo.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.fluveo.com/_mcp/server.

# Refund a payment

Create a refund against the PaymentIntent (or a `charge`). Omit `amount` for a
full refund; pass `amount` (smallest currency unit) for a partial one. The refund
shows up in [balance transactions](/cookbooks/paginate-balance-transactions) as
`type: "refund"`.

**`curl`**

```bash title="curl"
curl https://api.devfluveo.com/v1/refunds \
  -u sk_test_123: \
  -d payment_intent=pi_1A9e8AzB2xQRH9Jf \
  -d reason=requested_by_customer
```

For a **partial** refund, add `amount`:

**`curl`**

```bash title="curl"
curl https://api.devfluveo.com/v1/refunds \
  -u sk_test_123: \
  -d payment_intent=pi_1A9e8AzB2xQRH9Jf \
  -d amount=2000
```

`reason` accepts `duplicate`, `fraudulent`, or `requested_by_customer`. See the
[API Reference](/api-reference) for the full Refund object and its statuses.