> ## 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からの返金、または通知アドレスを指定しない返金APIリクエスト | Dashboardのグローバル `refundNotifyUrl`     |
| Chargeback通知 | Chargeback処理を伴うカード決済                     | Dashboardのグローバル `chargebackNotifyUrl` |

返金APIリクエストに `refundNotifyUrl` が含まれる場合、Waffoはその返金結果をリクエストで指定されたアドレスへ送信します。そのリクエストではDashboardのグローバルURLは不要です。

## 前提条件

* ロールが **Super Admin**、**Admin**、または **Dev** である。
* 受信サービスが、インターネットから到達可能な本番アドレスにデプロイされている。
* 受信サービスがWaffo署名を検証し、必要なレスポンスを返せる。[Webhookの概要](/docs/ja/developer-docs/webhook/overview)を参照してください。

## URLの要件

| 項目    | 要件                             |
| ----- | ------------------------------ |
| プロトコル | 本番環境では `https://` とTLS 1.2+を使用 |
| 形式    | RFC 3986に準拠したURL               |
| 長さ    | 512文字以内                        |
| 文字    | 空白、中国語文字、その他の無効な文字を含めない        |
| 到達性   | Waffoサービスからインターネット経由で到達可能      |

## 通知URLを設定する

<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.` | プロトコルがない、形式が無効、文字数超過、または無効な文字を含む | 完全な本番HTTPSアドレスを使用し、空白、中国語文字、無効な文字を削除する |

Dashboardで保存に成功しても通知を受信できない場合は、インターネットからの到達性、TLS証明書、サービスログ、Webhook署名処理を確認してください。解決しない場合は、Waffoテクニカルサポートへお問い合わせください。

次へ：[本番移行](/docs/ja/developer-docs/getting-started/go-live)に戻り、本番注文を検証します。