> ## 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.

# 退款 Webhook 和退款查询 API

> 退款成功或失败时会收到 Webhook 通知，也可以通过 API 查询退款。

[← 更新日志](https://docs.anyway.sh/zh/changelog.md)

**2026年10月30日**

# 退款 Webhook 和退款查询 API

退款到账时，你的 Webhook 会收到 `refund.succeeded`；退款被拒绝时会收到 `refund.failed`。每个事件都标明订单是否已全额退款，可据此自动收回权益。

只想接收部分事件时，在**开发者 → Webhook** 添加端点时勾选**退款成功**和**退款失败**。没有勾选事件的 Webhook 会接收全部事件，包括这两个，对不处理的事件类型请返回 2xx。

`GET /v1/refunds` 列出退款，`GET /v1/refunds/{id}` 查询单笔，字段和 Webhook 相同，同一套代码可以同时处理。10 月 30 日之前完成的退款可以查到，但不会补发事件。

详细说明见[交易 Webhook](https://docs.anyway.sh/zh/features/webhooks.md)和[列出退款](https://docs.anyway.sh/zh/api-reference/endpoint/refunds.md)。

> [card] [在 Anyway 中打开](https://app.anyway.sh/developer?view=business)

### 改进

* **支付服务设置** · 个体户改在 Sumsub 完成身份验证：两个业务部分填好后，**验证你的身份**会打开 Sumsub。Sumsub 通过身份验证、Anyway 批准业务信息后，即开通 USD 和提现。


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