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

# 配置退款与 Chargeback 通知 URL

> 在 Waffo Dashboard 配置退款和 Chargeback 的全局通知 URL。

Waffo 可以将退款和 Chargeback 结果发送到你在 Dashboard 配置的全局通知 URL。

## 通知地址的作用

| 通知类型          | 何时配置                              | 地址来源                                  |
| ------------- | --------------------------------- | ------------------------------------- |
| 退款通知          | 通过 Dashboard 操作退款，或退款请求没有单独提供通知地址 | Dashboard 中的 `refundNotifyUrl` 作为全局地址 |
| Chargeback 通知 | 已接入卡支付和 Chargeback 处理             | Dashboard 中的 `chargebackNotifyUrl`    |

如果退款 API 请求已经传入 `refundNotifyUrl`，Waffo 会将该笔退款结果发送到请求指定的地址，无需依赖 Dashboard 全局配置。

## 前提条件

* 你的角色为 **Super Admin**、**Admin** 或 **Dev**。
* 接收服务已部署到公网可访问的生产地址。
* 接收服务可以验证 Waffo 签名，并返回符合要求的响应。详见 [Webhook 概述](/docs/zh/developer-docs/webhook/overview)。

## URL 要求

| 项目  | 要求                             |
| --- | ------------------------------ |
| 协议  | 生产环境必须使用 `https://` 和 TLS 1.2+ |
| 格式  | 符合 RFC 3986                    |
| 长度  | 不超过 512 个字符                    |
| 字符  | 不包含空格、中文或其他非法字符                |
| 可达性 | Waffo 服务可以通过公网访问               |

## 配置步骤

<Steps>
  <Step title="登录 Dashboard">
    打开 [Waffo Dashboard](https://dashboard.waffo.com/auth/login)，进入 **Settings → Integration**。
  </Step>

  <Step title="选择通知类型">
    在 **Merchant Sign Configuration Details** 中找到需要配置的通知类型，点击对应的 **Edit**。
  </Step>

  <Step title="填写并保存 URL">
    粘贴完整的 `refundNotifyUrl` 或 `chargebackNotifyUrl`，然后点击 **Save**。
  </Step>

  <Step title="验证通知">
    从生产环境触发对应业务并确认服务收到通知。不要只依赖 Dashboard 的保存成功提示。
  </Step>
</Steps>

## 修改通知 URL

按照首次配置的步骤填写新地址并保存。新地址生效后，旧地址不会继续接收该类型的通知。

切换前先确认新地址可以接收请求并完成签名验证，避免通知丢失。

## 清空通知 URL

如果不再使用全局通知地址，在编辑弹窗中清空 URL 并点击 **Save**。清空后，原地址不会再接收该类型的全局通知。

<Warning>
  清空 `refundNotifyUrl` 前，确认退款 API 请求会为每笔退款提供有效地址。清空 `chargebackNotifyUrl` 会停止向该地址发送 Chargeback 通知。
</Warning>

## 常见错误

| 错误                                                                         | 原因                          | 处理方法                           |
| -------------------------------------------------------------------------- | --------------------------- | ------------------------------ |
| `Invalid URL: must start with http:// or https:// and be a valid address.` | URL 缺少协议、格式无效、超过长度限制或包含非法字符 | 使用完整的生产 HTTPS 地址，并移除空格、中文和非法字符 |

如果保存成功但未收到通知，请检查公网可达性、TLS 证书、服务日志和 Webhook 签名处理。仍无法解决时，请联系 Waffo 技术支持。

下一步：返回[生产上线](/docs/zh/developer-docs/getting-started/go-live)完成生产订单验证。