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

# 出金の例外とステータス

> 出金が審査で却下された、銀行に拒否された、あるいは成功後に返却された場合に何が起こるか：ステータスの全体像、出金手数料が戻るかどうか、返却が生成する口座履歴の行、各状態で Description 列に表示される内容、そして Withdraw ボタンがグレーアウトする理由。

[出金と一括送金 FAQ](/docs/ja/support/withdrawal-and-batch-payout-faq) は通常フローを扱います。
手数料、受取口座、明細、ステータス一覧です。このページが扱うのは、
**出金が完了しなかったときに何が起こるか** — 審査で却下された、銀行に拒否された、
あるいは成功した後に返却された場合 — そして、それぞれの結果が資金、手数料、台帳に
どう影響するかです。残高と口座履歴そのものについては
[残高と口座履歴](/docs/ja/support/balance-and-account-history-faq) で説明しています。

## 出金のステータスの全体像はどうなっていますか？

出金が悪い形で終わるパターンは 3 つあり、それらは 1 つの汎用的な失敗ではなく、
本当に異なる状態です。

| Portal のステータス | 意味 | 終端か |
| - | - | - |
| `Not Submitted` | 作成済みだが、まだ貴社が送信していない | いいえ |
| `Under Review` | 送信済みで、Waffo が審査中 | いいえ |
| `Rejected` | 審査で却下された — 支払指図が銀行に届く**前** | はい |
| `Processing` | 審査を通過し、支払が処理中 | いいえ |
| `Result Submitted` | 結果が戻り、確定処理中 | いいえ |
| `Success` | 完了 | はい |
| `Failed` | 未完了。失敗として記録された審査段階での却下**と**、銀行が支払を拒否したケースの両方を含む | はい |
| `Closed` | 完了せずにクローズされた | はい |
| `Bank Return` | 資金はすでに出ていたが、受取銀行がそれを返却した。確認中 | いいえ |
| `Bank Return Confirmed` | 返却が確認され、計上された | はい |

ここで誤読しやすい点が 2 つあります。

* **`Rejected` と `Failed` は同じ事象ではありません。** `Rejected` は、指図が一度も銀行に
  送られていないことを意味します。`Processing` の後の `Failed` は、指図は送られたものの
  銀行がそれを拒否したことを意味します。
* **`Bank Return` は終端ではありません。** 完了した出金が巻き戻されている状態を意味します。
  返却と、銀行がそれに課した手数料が計上されると `Bank Return Confirmed` になります。

## なぜ出金が勝手にクローズされたのですか？

作成から数時間経っても `Not Submitted` のままであり、自動的なスイープがそれをクローズしたためです。

Portal での出金申請は**2 段階**です。金額を入力すると出金オーダーが作成され、
`Not Submitted` の状態で残ります。その後に表示される確認画面こそが、実際に送信を行うものです。
その画面を通過しなかった場合 — タブを閉じた、離席した、セッションが切れた — オーダーは
そのまま残ります。一定の時間が経過すると、システムがそれを `Closed` に移します。

| | Portal で開始した出金 | API で作成した出金 |
| - | - | - |
| 2 段階目を待って `Not Submitted` で留まる | はい、確認するまで | いいえ — 1 回の呼び出しで作成と送信が行われる |
| `Not Submitted` のままだと自動的にクローズされる | **はい、作成から数時間後** | **いいえ、決してされない** |
| 送信ステップが完了しなかった場合 | 再度確認するか、クローズされる | まもなく自動的に完了される |

スイープはオーダーごとのタイマーではなくスケジュールで実行されるため、クローズは
カットオフを少し過ぎて発生することがあります。対象となるのは Portal で開始された出金のみです。
API で作成されたものは貴社が指定した `withdrawRequestId` によって識別され、
スイープから完全に除外されます。

ここから 2 つのことが導かれ、それが `Closed` の出金がほとんど問題にならない理由です。

* **何も差し引かれていません。** 精算アカウントから引き落とされるのは**確認した**ときであり、
  申請が作成されたときではありません。送信されないままクローズされた出金は残高に一切触れて
  いないため、待つべき戻し処理も、突き合わせるべき台帳の行もありません。
* **確認画面から戻る操作も、即座に同じ結果になります。** そこでキャンセルすると、
  スイープに委ねるのではなくその場でオーダーがクローズされます。同じ `Closed` ステータスで、
  同じく資金の移動はありません。

`Closed` は終端であり、API 上では `FAILURE` にマッピングされます。やはり進めたい場合は、
もう一度申請してください。

## 出金を作成したときに API が `E0001 Unknown status` を返しました。失敗したのですか？

いいえ。公開されている
[エラーコード](/docs/ja/developer-docs/tools-and-references/developer-tools/error-codes)
のリファレンスが示すとおり、まさに不明として扱ってください。出金オーダーはすでに存在し、
すでに進行しているかもしれません。作成されたものの送信ステップが完了しなかった API 出金は、
まもなく自動的に拾い上げられて完了されます。

したがって、同じ意図に対して 2 件目の出金を作成**しないで**ください。`withdrawRequestId` で
1 件目を照会し（[出金 API と残高 API](/docs/ja/support/withdrawal-and-balance-api-faq) を参照）、
返ってきたステータスに基づいて行動してください。代替を作成することが、加盟店が二重に
支払ってしまう原因になります。

## 出金 API が、Portal では見かけないステータスを返します。なぜですか？

API が意図的により小さな集合を返しているためで、貴社の連携があらゆる運用ステップを
追跡しなくて済むようにしています。対応は次のとおりです。

| API ステータス | 対応する Portal のステータス |
| - | - |
| `IN_PROGRESS` | `Not Submitted`、`Under Review`、`Processing`、`Result Submitted` |
| `SUCCESS` | `Success` |
| `FAILURE` | `Rejected`、`Failed`、`Closed`、`Bank Return Confirmed` |
| `BANK_DISPUTE_NOTIFIED` | `Bank Return` |

明示的に扱う価値があるのは `BANK_DISPUTE_NOTIFIED` です。これはまだ失敗では**ありません**。
「完了した出金が巻き戻されている」と捉え、後続を待ってください。返却が確認されると
`FAILURE` になります。ポーリングの手順については
[出金 API と残高 API](/docs/ja/support/withdrawal-and-balance-api-faq) を参照してください。

## 出金が失敗したとき、出金手数料は戻ってきますか？

支払指図がすでに銀行へ送られていたかどうかに完全に依存します。

| 結果 | 手数料 |
| - | - |
| **審査で却下**（`Rejected`） | **返還されます。** 手数料を含む出金金額の全額が精算アカウントに戻されます。銀行には何も送られていないため、手数料は発生しません |
| **銀行が支払を拒否**（`Processing` の後の `Failed`） | **返還されません。** 出金金額は**手数料を差し引いた額**で戻されます |
| **成功後に銀行が資金を返却**（`Bank Return Confirmed`） | **返還されません。** 同じ扱いで、戻し処理は手数料を差し引いた額になります |

その背後にあるルールはこうです。Waffo が支払指図を発行した時点で、作業とそのコストはすでに
発生しています。失敗の原因が受取口座にある場合 — 誤った情報、閉鎖された口座や制限のある口座 —
手数料はそのまま残ります。出金が審査段階から先に進まなかった場合は、残りません。

**異種通貨**の出金では、戻し処理は代わりに全額で計上されます。そのルートの手数料は
別途差し引かれるのではなく、銀行の返却手数料と併せて処理されるためです。いずれにしても、
二重に課金されることはありません。

手数料そのものは常に\*\*内枠（インクルーシブ）\*\*で差し引かれます。送金される額は出金金額から
手数料を引いたものです。したがって「手数料が返還される」とは、単に元の金額の全額が
戻ってくるという意味です。

## 出金手数料は、入力した金額から差し引かれますか、それとも上乗せで請求されますか？

差し引かれます。入力する金額は**グロス**の金額です。それが精算アカウントから出ていく数字であり、
送金が出る前に手数料はその中から差し引かれます。

| 数字 | 入力した金額との関係 |
| - | - |
| 出金金額 | 入力した金額。精算アカウントから**全額**引き落とされる |
| 出金手数料 | その金額から差し引かれ、受け取る通貨で課される |
| 受取予定額 | 出金金額**から**出金手数料を引いたもの |

同一通貨の出金では、銀行に届く数字は入力した数字より常に小さくなります。特定の金額を
到着させる必要がある場合は、その金額**に手数料を加えた額**で申請してください。

知っておく価値のある帰結が 3 つあります。

* **手数料が二度請求されることはありません。** 引き落とされるのは出金金額のみで、
  手数料はその内側にあります。後から別途の課金が発生することも、そのための Invoice が
  出ることもありません。
* **出金金額は手数料より大きい必要があります。** 手数料以下の金額では送金する分が残らないため、
  申請は受理されて後から失敗するのではなく、その時点で却下されます。
* **手数料は受け取る通貨で課され**、それは貴社の出金契約上の手数料通貨と一致している
  必要があります。契約が任意の通貨ペアではなく 1 つの通貨ペアを提示しているのはそのためです。

異種通貨の出金も同じ扱いです — 手数料は上乗せではなく金額から差し引かれます — ただし
申請時点では受取額を提示できません。後述の *異種通貨の出金では、なぜ受取額が空欄で
手数料は表示されるのですか？* を参照してください。

このページが意図的に説明しないのは、**手数料の金額そのものがどう決まるか**です。
それは貴社の出金契約から来るもので、適用される数値はその契約に記載されたものです。

## 出金の返却について銀行から手数料を課されました。それはどこに表示されますか？

精算アカウントに対する、口座履歴の独立した行として表示されます。したがって銀行の返却は、
1 つではなく**2 種類**の台帳の動きを生みます。

| 行 | 方向 | 金額 |
| - | - | - |
| 出金の戻し処理 | 精算アカウントへの**クレジット** | 銀行が拒否した金額。同一通貨の出金では出金手数料を差し引いた額 |
| 銀行の返却手数料 | 精算アカウントからの**デビット** | 銀行が課した手数料 |

両方の行は同じ識別属性を共有しており、それによって紐づけられます。

| 列 | 値 |
| - | - |
| `Business Type` | `WITHDRAWAL` |
| `Business Id` | **出金オーダー ID** — 精算バッチ ID ではありません |
| `Description` | `Withdrawal Cancelled` |

したがって、説明のつかない精算アカウントの動きを突き合わせていて、その `Description` が
`Withdrawal Cancelled` と読める場合は、`Business Id` を出金履歴で調べてください。
それは精算の調整ではなく、巻き戻されている出金です。

## 出金の Description 列には何が表示されますか？

ステータスによって変わり、一部の状態では正当に空欄になります。

| ステータス | Description |
| - | - |
| `Success` | `Serial No.: {bank reference}` と `Actual Payment Amount: {amount} {currency}` |
| `Rejected` | 却下の理由を説明する審査コメント |
| `Failed` | その出金に記録された拒否理由 |
| `Bank Return Confirmed` | その返却に記録された拒否理由 |
| `Bank Return` | **空欄** — 終端の状態ではないため、示すべき最終的な理由がまだありません |
| その他のステータス | 空欄 |

`Bank Return` の行で Description が空欄なのは期待どおりの動作であり、データの欠落では
ありません。理由は状態が `Bank Return Confirmed` になった時点で表示されます。

なお `Actual Payment Amount` は実際に支払われた金額です。受取銀行や中継銀行がその側で
何かを差し引いた場合、貴社の銀行口座に着金した金額と同じ数字にはなりません。

## なぜ Withdraw ボタンがグレーアウトしているのですか？

この入口には 3 つの状態があり、ボタンが描画される前に Waffo が精算アカウントに対して行う
チェックによって決まります。

| 表示 | 理由 |
| - | - |
| Withdraw ボタンが表示されない | そのアカウントで出金が有効になっていない |
| ボタンは表示されるが**グレーアウト** | **出金可能残高が、出金契約上の最低出金金額を下回っている** |
| ボタンが有効 | 進められる |

そのチェックが使うのは精算アカウントの残高ではなく、**出金可能**残高です。Reserve を
維持するために留保されている金額は先に除外されます。両者の違いについては
[残高と口座履歴](/docs/ja/support/balance-and-account-history-faq) を参照してください。

このチェックはクリック時にも再実行されます。その間に残高が動いていた場合 — ページの読み込みと
クリックの間に返金やチャージバックが着地した場合 — 試行は中止され、更新された数字で
再試行するよう求められます。これはアカウントのエラーではなく、安全のための再チェックです。

申請ドロワーの中では、金額ごとの 2 つ目の検証が適用されます。入力する金額は最低額以上、
契約上の最高額以下であり、かつ利用可能残高の範囲内である必要があります。

## 異種通貨の出金では、なぜ手数料と受取額が空欄なのですか？

レートが判明するまで、どちらも正直に提示できないためです。

| フィールド | 申請時点 | いつ埋まるか |
| - | - | - |
| 出金手数料 | **空欄**の場合がある | 最終審査時に補完される |
| 受取予定額 | **空欄** | 結果が戻った時点で補完される |

申請ページには、金額が換算されること、そして実際の受取額が異なりうることが示されており、
これらの数字が空のままでも意図的に送信できるようになっています。この段階で手数料が空欄でも
エラーではなく、出金が無料であることを意味するものでもありません。レートも最終的な金額も、
後から出金レコードとその明細に書き込まれます。したがって**申請ページからではなく、
レコードから突き合わせてください**。

## 複数のアカウントが関わっているのに、混在通貨の出金が 1 件の支払として表示されるのはなぜですか？

精算通貨の背後にあるアカウント構造が、意図的に貴社には公開されていないためです。
資金を調達するために内部で何が起ころうと、貴社に見えるのは次のとおりです。

* 精算通貨ごとに**1 つの精算アカウント**
* その精算に対する**1 件の口座履歴エントリ**
* その出金に対する**1 件の支払**

手数料は合計から内枠で、一度だけ差し引かれます。内部の動きごとに差し引かれるのでは
ありません。Portal が表示する単一の数字を超えて突き合わせる必要は決してないはずです。

## 出金が Processing のまま止まっています。いつサポートに連絡すべきですか？

`Processing` は、審査の通過から結果が戻るまでのすべてをカバーしており、Waffo のシステムの
外側にある送金の区間も含みます。チケットを起票する前に、次を確認してください。

1. ステータスがすでに `Result Submitted` に移っていないか — それは結果が届き、確定処理中で
   あることを意味します。
2. `Success` に到達している場合は、Description の `Serial No.` を確認してください。
   着金を追跡する際に自社の銀行に伝えられる銀行の参照番号です。
3. `Bank Return` に到達している場合、貴社側の対応は不要です。戻し処理はすでに進行中であり、
   確認されると資金は精算アカウントに戻ります。

返却の場合は、あらためて出金を手配することが前に進む方法です。元のオーダーは確認された時点で
終端となり、自動的に再試行されることはありません。同じ口座では資金が再び返却されてしまうため、
先に Waffo とともに受取口座の情報を修正してください。

***

それでも解決しませんか？出金オーダー ID を添えて [サポートに連絡](mailto:support@waffo.com)
してください。これは関連する口座履歴の行の `Business Id` です。


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