> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anyway.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Refund webhooks and the Refunds API

> Get a webhook when a refund succeeds or fails, and look up your refunds through the API.

[← Changelog](https://docs.anyway.sh/changelog.md)

**October 30, 2026**

# Refund webhooks and the Refunds API

Your webhook endpoints now receive `refund.succeeded` when a refund reaches the buyer and `refund.failed` when it is rejected or declined. Each event says whether the order is now fully refunded, so you can revoke access automatically.

To receive only some events, select **Refund succeeded** and **Refund failed** when you add an endpoint under **Developers → Webhooks**. An endpoint with no events selected receives every event, including these, so return 2xx for types you do not handle.

`GET /v1/refunds` lists refunds and `GET /v1/refunds/{id}` fetches one, with the same fields as the webhook, so the same code handles both. Refunds completed before 30 October can be looked up but send no event.

Details: [Commerce Webhooks](https://docs.anyway.sh/features/webhooks.md) and [List refunds](https://docs.anyway.sh/api-reference/endpoint/refunds.md).

> [card] [Open in Anyway](https://app.anyway.sh/developer?view=business)

### Improvements

* **Payment setup** · Sole traders now verify their identity with Sumsub: **Verify your identity** opens Sumsub once both business sections are complete. USD and payouts open when Sumsub approves your identity and Anyway approves your business details.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.