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

# Waffo は残高を自動で出金できますか？出金はどのように連携すればよいですか？

> 自動出金契約の全体像 — どのように起動するか、6 つのステータスの意味、残高が閾値を下回っている場合に何が起きるか、一時停止・終了の方法 — に加えて、出金通知イベント、API 出金と Portal 出金の見分け方、出金一覧のエクスポート、出金における openingRegion と fundsFrom の意味。

[出金：例外とステータス](/docs/ja/support/withdrawal-exceptions-and-status-faq) は、問題が起きた出金について説明しています。
[出金・残高 API](/docs/ja/support/withdrawal-and-balance-api-faq) はエンドポイントの契約仕様です。**本ページは、その 2 つのページでは答えていない 2 つの事項を扱います**：
出金を自動化して手動で申請する必要をなくすこと、そして出金に関わる連携の詳細 — 通知、識別子、エクスポート — です。

## Waffo は精算残高を自動で出金してくれますか？

はい、**自動出金契約**によって可能です。1 つの契約は 1 つの出金契約と 1 つの受取銀行口座に紐づき、Waffo と合意したルールに基づいてお客様の代わりに出金を申請します。

自動出金契約は Waffo 側で設定され、社内承認を経て有効になります。契約が作成されると、Portal の **Account → Withdraw → Auto
Withdrawal** でご自身で確認・操作できます。

申請するには、[サポートにお問い合わせ](mailto:support@waffo.com)いただき、対象の通貨、受取口座、希望するルールをお伝えください。

## 自動出金はどのように起動しますか？

トリガー種別は 2 つあります：

| `triggerType` | ルール |
| - | - |
| `AMOUNT_ONLY` | 毎日チェックされます。出金可能残高が閾値に達すると出金が申請されます |
| `AMOUNT_WITH_PERIOD` | 期間で指定された日のみチェックされます。その日でも閾値を満たす必要があります |

`AMOUNT_WITH_PERIOD` の場合、期間は以下のいずれかです：

| `periodType` | 期間設定 | 起動日 |
| - | - | - |
| `DAILY` | — | 毎日 |
| `WEEKLY` | 曜日、例：`1,3` | 月曜日と水曜日 |
| `MONTHLY` | 日付、例：`1,15`、`last`、`15,last` | 1 日と 15 日；月末日；その両方 |

すべての契約には **トリガー時刻**も設定されており、`UTC+8` で表されます。自動化処理は 1 日の中で繰り返しチェックを行い、その時刻以降の最初のチェックで実行します。日単位のガードにより、チェックが何回実行されても**1 契約につき 1 日最大 1 件の自動出金**となります。

Portal では、組み立てられたルールが契約行に読みやすい文章として表示されるため、フィールドから自分で再構成する必要はありません。

## 自動出金では、いくら出金されますか？

**出金可能残高の全額**であり、閾値の金額ではありません。

閾値は条件であって金額ではありません。閾値を満たした場合、契約はその時点で出金可能なすべての金額 — 精算アカウントの利用可能残高から、Reserveの取り決めで留保されている金額を差し引いたもの — を出金します。これは Portal で出金可能額として表示される金額と同じであり、手動で全額出金した場合に出金される金額とも同じです。

出金可能額がアカウント残高より少なくなる理由については、[残高・アカウント履歴](/docs/ja/support/balance-and-account-history-faq) で説明しています。

## 残高が閾値を下回っている日には何が起きますか？

**何も起きず、何も失敗しません。** 出金注文は作成されず、アカウントに対してエラーが発生することもなく、後処理が必要な失敗行も残りません。次回の定期チェックで同じルールが再び適用されます。

閾値は 2 つ適用され、いずれか一方を下回っていればその日はスキップされます：

| チェック | 出所 |
| - | - |
| 契約の残高閾値 | お客様の自動出金契約 |
| 出金契約の最小出金額 | お客様の出金契約 |

つまり、契約の閾値が出金契約の最小額を下回っている場合、その最小額を下回る範囲では決して起動しません — 出金契約の下限が優先されます。

## 残高が閾値を十分に上回っていたのに出金されませんでした。なぜですか？

可能性の高い順に：

| 原因 | 表示される内容 | 対処 |
| - | - | - |
| 同じ出金契約で以前の自動出金がまだ最終ステータスに達していない | 新しい注文なし | 進行中のものが完了するまで待ちます。次回のチェックで拾われます |
| 本日すでに 1 件申請されている | 注文は 2 件ではなく 1 件 | 想定どおりの動作です — 1 契約につき 1 日 1 件 |
| `UTC+8` でトリガー時刻がまだ過ぎていない | まだ注文なし | トリガー時刻まで待ちます |
| 契約が `SUSPENDED`、または有効期間外 | 契約行のステータス | 再開する、または有効期間についてサポートに確認します |
| 受取銀行口座が無効になっている | 注文なし | サポートにお問い合わせください — Waffo 側での修正が必要です |
| `AMOUNT_WITH_PERIOD` 契約のトリガー日ではない | 注文なし | 行のトリガールールを確認します |

進行中判定のルールは\*\*（加盟店、出金契約）\*\*の組み合わせ単位です。ある通貨の契約が、別の通貨の進行中の出金によってブロックされることはありません。

## 自動出金のステータスはそれぞれ何を意味しますか？

| `status` | 意味 | 起動可能？ | 編集可能？ |
| - | - | - | - |
| `INIT` | 下書き。承認申請前 | いいえ | はい |
| `AUDITING` | 申請済み。承認待ち | いいえ | いいえ |
| `ACTIVE` | 承認済みで有効 | はい | はい |
| `REJECTED` | 承認が却下された。最終状態 | いいえ | いいえ |
| `SUSPENDED` | 一時停止中。再開可能 | いいえ | はい |
| `TERMINATED` | 終了。最終状態で取り消し不可 | いいえ | いいえ |

`REJECTED` と `TERMINATED` は終端状態です。その契約に対しては一切の操作ができなくなり、フィールドは記録としてのみ保持されます。

## 契約が却下されました。修正して再申請できますか？

いいえ — `REJECTED` 状態の契約は編集も再申請もできません。却下されたルールは新しい契約で置き換える必要があり、再度承認を経ます。却下されたものを再利用しようとするのではなく、変更したい内容を添えて[サポートにお問い合わせください](mailto:support@waffo.com)。

## 一時停止と終了の違いは何ですか？

| | 一時停止 | 終了 |
| - | - | - |
| 設定されるステータス | `SUSPENDED` | `TERMINATED` |
| 取り消し可能か | はい — 再開すると `ACTIVE` に戻ります | **いいえ** |
| 元に戻すのに必要な承認 | 不要 | 新しい契約と新しい承認 |
| 使う場面 | 一時的に出金を止めたいとき — 銀行の変更、閑散期、調査など | 取り決めが終了したとき |

どちらも Portal の契約行からご自身で実行できます。一時停止が安全な既定の選択です。取り決めが終了したと確信できない場合は、終了ではなく一時停止してください。

## 通貨ごとに異なる自動出金設定を持てますか？

はい。契約は 1 つの出金契約に紐づき、出金契約は 1 つの出金通貨ペアに紐づくため、通貨ごとのルールが通常の形です。通貨ごとに 1 つの契約を持ち、それぞれに独自の閾値、期間、トリガー時刻、受取口座を設定します。

契約は互いに独立しており、上述の進行中判定ルールも含めて独立です。

## 出金が完了したときに通知はありますか？

はい。出金が成功または失敗した際、指定した `notifyUrl` に **`WITHDRAW_NOTIFICATION`** 種別の通知が送信されます。

| 項目 | 詳細 |
| - | - |
| イベント名 | `WITHDRAW_NOTIFICATION` |
| URL の出所 | 出金作成リクエストの `notifyUrl` — **必須**です |
| エンベロープと署名 | 他のすべての Waffo 通知と同じエンベロープおよび `X-SIGNATURE` 検証。[Webhook 概要](/docs/ja/developer-docs/webhook/overview) を参照 |
| 本文 | 出金照会レスポンスと同じ構造 |

`notifyUrl` はリクエストごとに指定するため、アカウントレベルで設定する出金通知の設定はありません。作成する各出金がそれぞれの送信先を持ちます。Portal や自動出金契約から申請された出金はお客様の API 呼び出しではないため、通知は `/api/v1/withdraw/create` で作成した出金の確認チャネルとして扱い、それ以外については Portal の一覧を記録として扱ってください。

通知に基づいて処理する前に、署名を検証し、`/api/v1/withdraw/inquiry` から状態を再取得してください — 決済通知に適用されるルールと同じです。

## 出金通知と出金照会レスポンスには何が含まれますか？

1 つの構造が両方に使われます：

| フィールド | 意味 |
| - | - |
| `withdrawRequestId` | お客様側のリクエスト識別子 |
| `withdrawOrderId` | Waffo 側の出金識別子 |
| `status` | 出金がどの段階に達したか |
| `currency` | 精算アカウントから出金された通貨 |
| `beforeAvailableBalance`、`afterAvailableBalance` | 出金前後の利用可能残高 |
| `receiveCurrency` | 銀行口座に入金される通貨 |
| `expectedReceiveAmount` | 出金で受け取る予定だった金額 |
| `actualReceiveAmount` | 実際に受け取った金額 |
| `fxRate` | 異なる通貨間の出金で適用されたレート |
| `feeCurrency`、`feeAmount` | 出金手数料とその通貨 |
| `bankRefId` | 銀行側の参照番号 — **銀行明細と照合するにはこのフィールドを使います** |
| `withdrawRequestedAt`、`withdrawCompleteTime` | 申請した時刻と完了した時刻 |
| `failureCode`、`failureReason` | 出金が失敗した場合に設定されます |
| `merchantBankAccount` | 使用された受取口座 |
| `description` | お客様が送信した説明 |

異なる通貨間の出金で `expectedReceiveAmount` と `actualReceiveAmount` が異なるのは正常であり、
[出金：例外とステータス](/docs/ja/support/withdrawal-exceptions-and-status-faq) で説明しています。

## API から開始した出金と Portal で申請した出金を見分けられますか？

列からは見分けられません — Portal の出金一覧には出金の開始方法は表示されません。区別できるのはリクエスト識別子です：

| 申請元 | 識別方法 |
| - | - |
| お客様の API 呼び出し | お客様が送信した `withdrawRequestId`。`/api/v1/withdraw/inquiry` で返されます |
| Portal でのお客様の操作 | Waffo が生成したリクエスト識別子 |
| 自動出金契約 | 契約と日付を符号化した生成済みリクエスト識別子 |

実務上、開始元をデータとして必要とする場合は、ご自身の `withdrawRequestId` の値を保持し、認識できないものはすべて連携外で申請されたものとして扱ってください。

## 出金一覧をエクスポートできますか？

はい — Portal → Account → Withdraw にエクスポート操作があります。**エクスポートの日付範囲は 31 日を超えることができない**ため、より長い期間は複数回のエクスポートに分けて取得する必要があります。

他の Portal エクスポートと同様にバックグラウンドタスクであり、ファイルはすぐにダウンロードされるのではなくエクスポート履歴に表示されます。[エクスポートセンター](/docs/ja/support/export-center-faq) を参照してください。

## 出金の最小金額と最大金額はありますか？

はい — どちらも**出金契約**上に出金通貨ペアごとに定められており、Portal、API、自動出金契約のいずれから申請した場合でも、出金作成時に適用されます。範囲外の金額は後で失敗するのではなく、作成時点で拒否されます。

適用される値はお客様の出金契約に記載されているものです。手元にない場合はサポートにお問い合わせください。同じ最小額が、自動出金契約が従う下限にもなります。

## 出金はどの銀行口座に送られますか？口座の追加や変更はどうすればよいですか？

各出金契約には 1 つ以上の受取銀行口座が紐づいています。出金する際：

* Portal では紐づいている口座が表示され、複数ある場合はそこから選択できます
* `/api/v1/withdraw/create` は `bankAccountId` を受け取ります。**省略すると、出金契約の既定口座が使用されます**

口座の追加や変更は**セルフサービスではありません**。Portal → Settings → Bank Accounts は、すでに紐づいている口座 — 通貨、口座情報、SWIFT コード、銀行住所 — の読み取り専用ビューです。追加や編集の操作はありません。新しい送金先は Waffo 側のコンプライアンス上の変更であり、お客様側の設定変更ではないためです。

追加や変更をご希望の場合は、[サポートにお問い合わせください](mailto:support@waffo.com)。口座の通貨、口座名義と口座番号、銀行名と SWIFT コード、銀行住所と支店、必要な場合はコルレス銀行の情報をご用意ください — これらは口座レコードが保持するフィールドそのものです。

## 出金の `openingRegion` と `fundsFrom` は何を意味しますか？出金できる金額を制限しますか？

これらは**どちら側から送金されるか**を表すもので、出金できる金額を表すものではありません。

| フィールド | 値 | 意味 |
| - | - | - |
| `openingRegion` | `HKG`、`OTHER` | 受取銀行口座がどこで開設されているか |
| `fundsFrom` | `openingRegion` から導出 | 支払いに Waffo のどの送金スキームが使われるか |

`fundsFrom` はお客様が設定するものではなく、口座の `openingRegion` から決まります。Portal では、出金ドロワーの **From** ブロックに表示される支払元エンティティを決めるものであり、確認前に表示された名称と銀行明細上の名称が一致するようになっています。

どちらのフィールドも出金可能額に上限を設けるものではありません。金額は出金可能残高と、出金契約の最小額・最大額によって決まります — 上の 2 つの質問を参照してください。

***

出金に関して本ページと一致しない点がありますか？
出金注文 ID を添えて[サポートにお問い合わせください](mailto:support@waffo.com) — 1 回の照会で、背後にある出金契約、受取口座、自動出金契約を特定できます。


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