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

# 一括送金のステータスと資金源

> 一括送金のステータスと各行のステータスの読み方、バッチが失敗として表示されずにリストから消えることがある理由、一部の国のテンプレートしか提供されない理由、そして送金の資金がどこから引き落とされるのかを説明します。

このページでは、一括送金の**読み方** — そのステータス、各行の結果、資金の出所 — を説明します。
Portal での作成手順と出金については
[出金と一括送金](/docs/ja/support/withdrawal-and-batch-payout-faq) を参照してください。
資金が通過するアカウントについては
[送金ウォレットと対応範囲](/docs/ja/support/payout-wallet-and-coverage-faq) を参照してください。
単一送金の API については [送金 FAQ](/docs/ja/support/payout-faq) を参照してください。

## バッチファイル自体にはどんな制限がありますか？

| 制限 | 値 |
| - | - |
| ファイル形式 | **`.xlsx` のみ** — Portal のアップロードはそれ以外を受け付けません |
| ファイルサイズ | **2 MB** 未満 |
| ファイル名 | **100 文字**以内 |
| 1 ファイルあたりの行数 | 最大 **1,000** 行 — これを超えるファイルは拒否され、バッチはキャンセルされます |
| 1 回のアップロードあたりのファイル数 | 1 つ |

スプレッドシートツールが何を勧めてきても、CSV はアップロードできません。`.xlsx` で保存してください。

空のファイル — データ行のないテンプレート — も拒否されバッチはキャンセルされるため、アップロード直後に
消えてしまうバッチは、通常テンプレートが想定する位置に行が置かれていないファイルです。

## Batch name と Batch description は何のためのものですか？受取人に表示されますか？

どちらも受取人には表示されません。いずれもお客様自身のバッチ記録に付けるラベルです。

| 項目 | ルール | 閲覧者 |
| - | - | - |
| **Batch name** | 必須。英字・数字・アンダースコア・ハイフンのみ — スペースやその他の記号は不可。最大 100 文字。 | お客様の Portal アカウント |
| **Batch description** | 任意。最大 256 文字。 | お客様の Portal アカウント（バッチを確認する担当者を含む） |

説明欄は、バッチを承認する同僚にその目的を伝えるためにあります。受取人が明細で実際に目にするのは、
ファイル内の行ごとの説明であり、これら 2 つのどちらでもありません。

## 1 行が検証で失敗しました。問題のない行だけ送ることはできますか？

できません。検証はオール・オア・ナッシングです。**1 行でも失敗するとバッチ全体がキャンセルされ**、
通過した行だけを送信する方法はありません。ファイルを修正して再度アップロードしてください。

各行の何が問題だったかは正確に通知されます。検証後、バッチ記録には **Checked** ファイルが付きます —
アップロードしたものと同じ行に、失敗した行だけ失敗理由の列（エラーコードとそのメッセージ）が埋められたものです。
推測するのではなく、このファイルを基に作業してください。理由は行ごとに具体的で、項目の書式の問題、
国や通貨がバッチ内の他の行と異なる行、受取側で拒否された受取人口座、利用可能残高を超えた行などをカバーしています。

## バッチにはどんなステータスがありますか？

お客様側から見えるのは、ちょうど 2 つです。

| バッチステータス | 意味 |
| - | - |
| **In Progress（処理中）** | バッチが送信され、処理が進んでいます — 資金の引き落とし、各行のルーティング、結果の収集と計上が行われます。 |
| **Completed（完了）** | バッチ内のすべての行が、成功か失敗かを問わず最終結果に到達しました。 |

3 つ目の値はありません。バッチ一覧のフィルターにもこの 2 つしか用意されていません。

このことから 2 つの帰結があり、どちらも意外に思われがちです。

* **In Progress は複数の異なる内部段階を含みます。** バッチがしばらく In Progress のままでも、
  処理は進んでいることがあります。In Progress が長いからといって停止と判断しないでください。
* **Completed は「すべての行が確定した」であって、「すべての行が成功した」ではありません。**
  すべての行が失敗したバッチも Completed です。資金が動いたかどうかは、バッチステータスではなく
  必ず行ステータスで確認してください。

## 作成したはずのバッチが見えないのはなぜですか？

バッチは\*\*送信（submit）\*\*された時点で初めて一覧に表示されるためです。それ以前、およびそこまで
到達しなかった場合は、加盟店側の画面には一切表示されません — バッチ一覧のクエリ自体が In Progress と
Completed に絞り込んでおり、UI 上で他の値を隠しているだけではありません。

注意すべきケースは、処理前に放棄されたバッチです — たとえば送信時点で利用可能残高が不足していた、
あるいは有効期限を過ぎても未送信のままだった場合 — こうしたバッチは**失敗やキャンセルとして表示されるのではなく、
一覧から消えます**。想定していたバッチが消えている場合、暗黙のうちに処理されたと思い込まないでください。
送信時点の残高を再確認し、バッチを再作成してください。

## 個々の行にはどんなステータスがありますか？

3 つあり、実際に何が起きたかを教えてくれるのはこれらです。

| 行ステータス | 意味 |
| - | - |
| **In Progress（処理中）** | 行が受理され、処理中です。 |
| **Success（成功）** | 資金が受取人に送金されました。 |
| **Failure（失敗）** | 行は送金されませんでした。金額は精算アカウントに戻されます。手数料が戻るかどうかは送金契約によります。 |

各行にはステータスのタイムラインも付いています。バッチレベルのタイムラインはより粗く —
送信、処理開始、完了を示すだけです — 特定の受取人の遅延を説明する必要がある場合は、行のタイムラインを使ってください。

行に**ステータスがまったく表示されていない**場合、その行はルーティングまで到達しなかった行です —
典型的にはファイル検証で失敗した行です。空欄の行ステータスは、保留中の送金ではなく、再送信が必要な失敗として扱ってください。

## バッチステータスのタイムラインには何が表示されますか？

3 つの時点です。**Submitted** — バッチが検証を通過し受理された時点で、資金はまだ動いていません。
**In Progress** — 資金が引き落とされ、処理が始まった時点。**Completed** — すべての行が確定した時点。
中間の内部段階はタイムラインのノードとして公開されないため、タイムラインは監査証跡ではなく進行状況の指標です。
照合（リコンサイル）には、バッチ記録に添付されたソース・Checked・結果の各ファイルを使ってください。

## バッチテンプレートをダウンロードするとき、一部の国しか選べないのはなぜですか？

テンプレートは**契約済みの国ごと**に発行されるためです。表示される一覧は、締結済みの送金契約から導かれます。
現在有効で有効期間内にある契約がカバーする国ごとに、1 つのテンプレートが用意されます。

* 有効な契約がなければ**テンプレートはまったく表示されません** — ここが空の場合は契約の問題であり、バグではありません。
* この制限は UI だけでなく、**ダウンロード時**にも適用されます。契約していない国を要求すると、
  提供されずに拒否されます。
* 契約している国によってテンプレートが要求する列も決まるため、ある国のファイルを別の国に流用することはできません。

契約済みの国が一覧に表示されているのにダウンロードが失敗する場合は、Waffo の担当者に連絡する価値があります —
契約は存在するが、そのテンプレートファイルがまだ準備されていないことを意味します。

## バッチが送信される前に、2 回目の確認ステップはありますか？

はい — プレビューの後に Portal 内で明示的な確認があります。利用可能な精算残高、送金総額、受取人の合計数、
手数料の合計が表示され、引き落としが行われる前に確認する必要があります。残高不足の場合は、バッチを部分的に
処理するのではなく、この時点で送信が拒否されます。

この確認は Portal 内のステップです。この段階でメールで確認コードが届くことを前提にした手順書を作らないでください。

## バッチをアップロードしましたが送信していません。キャンセルできますか？

その必要はありません。アップロードされたが送信されていないバッチは、**作成から約 4 時間後に自動的にクローズ**され、
クローズにコストはかかりません — 引き落としは送信時に行われるため、未送信のバッチは残高に一切触れていません。

計画時に考慮すべき 2 つの帰結があります。

* **キャンセル操作はありません。** キャンセルするものが何もないためです。間違ったファイルをアップロードした場合は、
  正しいファイルを新しいバッチとしてアップロードし、古いものは自然に失効させてください。
* **送信予定より大幅に前にバッチを準備しないでください。** ある日にレビューして翌日に送信しようとしても、
  そのバッチは存在しません — 失効しており、上述のとおり失効したバッチはキャンセルとして表示されずに一覧から消えます。
  アップロードと送信は一度に行ってください。

## 一括送金では Webhook が送信されますか？

いいえ。送金の Webhook は API 経由で作成された送金に対してのみ送信されます。一括アップロードの行として
作成された送金は、結果がどうであれ通知を生成しません。バッチの結果はバッチ記録とその結果ファイルから追跡するか、
各行の `payoutOrderId` を送金 API で照会してください。
[送金のステータス、通知、レポート](/docs/ja/support/payout-status-notifications-and-reports-faq) を参照してください。

## 送金の資金はどこから来るのですか？

お客様の**決済（アクワイアリング）精算金**からです。一括送金の経路におけるすべての残高チェックとすべての引き落としは、
該当通貨の**精算アカウント**に対して行われます — 承認するプレビューが読み取るのも同じ残高なので、
プレビューで表示されているアカウントが引き落とされるアカウントです。

2 つの帰結があります。

* 資金調達通貨の精算アカウント以外に入金された資金は、一括送金からは利用できません。送金経路にはアカウント選択の
  機能がなく、精算残高が不足している場合に別のアカウントへフォールバックすることもありません — 代わりに送信が拒否されます。
* したがって、送金は精算の下流にあります。送金能力を増やしたい場合、調整手段は精算のタイミングであり、
  別途のチャージ（トップアップ）フローではありません。精算金がいつ入金されるかを決める要素については
  [精算サイクル](/docs/ja/support/settlement-cycle-faq) を参照してください。

## どの精算アカウントから送金の資金を出せますか？選べますか？

選べません — **通貨**によって決まり、その通貨は送金契約から来ます。

* 国ごとの送金契約には、受取人通貨とともに資金調達通貨が記録されています。この資金調達通貨だけが、
  どの精算アカウントから引き落とすかを決めます。
* 契約設定時に選べる資金調達通貨は、お客様が実際に精算アカウントを保持している通貨に限定されるため、
  保持していないアカウントに対して契約が作成されることはありません。
* バッチの資金調達通貨は契約に基づいて行ごとに解決され、それを 1 つに集約するため、
  **1 つのバッチ内のすべての行は同じ資金調達通貨・受取人通貨・国を共有しなければなりません** —
  これが、バッチ検証がこの 3 つの項目についてオール・オア・ナッシングである根本的な理由です。

実務的な計画のルール：ある送金経路（コリドー）で送金したい場合、そのコリドーの契約**と**、
その契約が指定する資金調達通貨で蓄積されている精算金の両方が必要です。別の通貨で残高を持っていても
役に立たず、Waffo が送金の一環として通貨を変換することもありません。

## 1 つのバッチ内のすべての行が同じ国と通貨でなければならないのはなぜですか？

バッチは 1 つの単位として資金を調達するためです。資金調達通貨は行ごとに契約から解決され、バッチ全体で 1 つの値に
集約され、その 1 つの値が引き落とす精算アカウントを 1 つ選びます。コリドーが混在するバッチは複数のアカウントから
引き落とす必要があり、この経路はそれを行いません。

だからこそ、国・資金調達通貨・受取人通貨について検証は**オール・オア・ナッシング**であり、
不正な行が 1 つあるだけで、その行を除外するのではなくファイル全体がキャンセルされます。
複数コリドーにわたる支払いは、コリドーごとに 1 バッチに分割して別々に送信してください。部分送信はありません。

## バッチが長時間 In Progress のままです。何を確認すべきですか？

In Progress は複数の段階にまたがるため、経過時間だけでは何もわかりません。代わりに以下を確認してください。

| 確認事項 | 理由 |
| - | - |
| すでに確定した**行**はあるか？ | 行は個別に確定します。成功がすでに表示されているバッチは、バッチステータスが何であれ進行しています。 |
| **行**のタイムラインに動きはあるか？ | 行のタイムラインはバッチのタイムラインより細かく、特定の受取人がどこで止まっているかを示します。 |
| バッチ記録に**結果ファイル**は現れたか？ | 行が確定するにつれて生成され、進行の最も早い確実な証拠です。 |
| 送信時に精算残高はバッチをカバーしていたか？ | 資金不足のバッチは停止するのではなく送信時に拒否されます — バッチ自体が見つからない場合は、上記の消えたバッチに関する質問を参照してください。 |

進行を促すためにファイルを再送信しないでください。2 つ目のバッチは 2 回目の引き落としと 2 組目の送金になります。
止まっているバッチは再アップロードせず、Waffo の担当者に連絡してください。

## Completed になったバッチはどう照合すればよいですか？

画面ではなく、バッチ記録上のファイルを基に作業してください。

| ファイル | 用途 |
| - | - |
| **Source** | アップロードしたファイル — 何を依頼したかについてのお客様自身の参照用。 |
| **Checked** | 検証後のビューで、何が受理されたかを示します。 |
| **Result** | 行ごとの結果で、自社の帳簿と照合する対象です。 |

行レベルの失敗は、引き落とし元の精算アカウントに金額が戻されます。戻された金額はバッチの合計から
推測するのではなく、アカウント履歴で確認してください。それらの明細の記載方法については
[残高とアカウント履歴](/docs/ja/support/balance-and-account-history-faq) を参照してください。


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