バッチファイル自体にはどんな制限がありますか？
スプレッドシートツールが何を勧めてきても、CSV はアップロードできません。
.xlsx で保存してください。
空のファイル — データ行のないテンプレート — も拒否されバッチはキャンセルされるため、アップロード直後に
消えてしまうバッチは、通常テンプレートが想定する位置に行が置かれていないファイルです。
Batch name と Batch description は何のためのものですか？受取人に表示されますか？
どちらも受取人には表示されません。いずれもお客様自身のバッチ記録に付けるラベルです。
説明欄は、バッチを承認する同僚にその目的を伝えるためにあります。受取人が明細で実際に目にするのは、
ファイル内の行ごとの説明であり、これら 2 つのどちらでもありません。
1 行が検証で失敗しました。問題のない行だけ送ることはできますか？
できません。検証はオール・オア・ナッシングです。1 行でも失敗するとバッチ全体がキャンセルされ、 通過した行だけを送信する方法はありません。ファイルを修正して再度アップロードしてください。 各行の何が問題だったかは正確に通知されます。検証後、バッチ記録には Checked ファイルが付きます — アップロードしたものと同じ行に、失敗した行だけ失敗理由の列（エラーコードとそのメッセージ）が埋められたものです。 推測するのではなく、このファイルを基に作業してください。理由は行ごとに具体的で、項目の書式の問題、 国や通貨がバッチ内の他の行と異なる行、受取側で拒否された受取人口座、利用可能残高を超えた行などをカバーしています。バッチにはどんなステータスがありますか？
お客様側から見えるのは、ちょうど 2 つです。
3 つ目の値はありません。バッチ一覧のフィルターにもこの 2 つしか用意されていません。
このことから 2 つの帰結があり、どちらも意外に思われがちです。
- In Progress は複数の異なる内部段階を含みます。 バッチがしばらく In Progress のままでも、 処理は進んでいることがあります。In Progress が長いからといって停止と判断しないでください。
- Completed は「すべての行が確定した」であって、「すべての行が成功した」ではありません。 すべての行が失敗したバッチも Completed です。資金が動いたかどうかは、バッチステータスではなく 必ず行ステータスで確認してください。
作成したはずのバッチが見えないのはなぜですか？
バッチは**送信（submit）**された時点で初めて一覧に表示されるためです。それ以前、およびそこまで 到達しなかった場合は、加盟店側の画面には一切表示されません — バッチ一覧のクエリ自体が In Progress と Completed に絞り込んでおり、UI 上で他の値を隠しているだけではありません。 注意すべきケースは、処理前に放棄されたバッチです — たとえば送信時点で利用可能残高が不足していた、 あるいは有効期限を過ぎても未送信のままだった場合 — こうしたバッチは失敗やキャンセルとして表示されるのではなく、 一覧から消えます。想定していたバッチが消えている場合、暗黙のうちに処理されたと思い込まないでください。 送信時点の残高を再確認し、バッチを再作成してください。個々の行にはどんなステータスがありますか？
3 つあり、実際に何が起きたかを教えてくれるのはこれらです。
各行にはステータスのタイムラインも付いています。バッチレベルのタイムラインはより粗く —
送信、処理開始、完了を示すだけです — 特定の受取人の遅延を説明する必要がある場合は、行のタイムラインを使ってください。
行にステータスがまったく表示されていない場合、その行はルーティングまで到達しなかった行です —
典型的にはファイル検証で失敗した行です。空欄の行ステータスは、保留中の送金ではなく、再送信が必要な失敗として扱ってください。
バッチステータスのタイムラインには何が表示されますか？
3 つの時点です。Submitted — バッチが検証を通過し受理された時点で、資金はまだ動いていません。 In Progress — 資金が引き落とされ、処理が始まった時点。Completed — すべての行が確定した時点。 中間の内部段階はタイムラインのノードとして公開されないため、タイムラインは監査証跡ではなく進行状況の指標です。 照合（リコンサイル）には、バッチ記録に添付されたソース・Checked・結果の各ファイルを使ってください。バッチテンプレートをダウンロードするとき、一部の国しか選べないのはなぜですか？
テンプレートは契約済みの国ごとに発行されるためです。表示される一覧は、締結済みの送金契約から導かれます。 現在有効で有効期間内にある契約がカバーする国ごとに、1 つのテンプレートが用意されます。- 有効な契約がなければテンプレートはまったく表示されません — ここが空の場合は契約の問題であり、バグではありません。
- この制限は UI だけでなく、ダウンロード時にも適用されます。契約していない国を要求すると、 提供されずに拒否されます。
- 契約している国によってテンプレートが要求する列も決まるため、ある国のファイルを別の国に流用することはできません。
バッチが送信される前に、2 回目の確認ステップはありますか？
はい — プレビューの後に Portal 内で明示的な確認があります。利用可能な精算残高、送金総額、受取人の合計数、 手数料の合計が表示され、引き落としが行われる前に確認する必要があります。残高不足の場合は、バッチを部分的に 処理するのではなく、この時点で送信が拒否されます。 この確認は Portal 内のステップです。この段階でメールで確認コードが届くことを前提にした手順書を作らないでください。バッチをアップロードしましたが送信していません。キャンセルできますか？
その必要はありません。アップロードされたが送信されていないバッチは、作成から約 4 時間後に自動的にクローズされ、 クローズにコストはかかりません — 引き落としは送信時に行われるため、未送信のバッチは残高に一切触れていません。 計画時に考慮すべき 2 つの帰結があります。- キャンセル操作はありません。 キャンセルするものが何もないためです。間違ったファイルをアップロードした場合は、 正しいファイルを新しいバッチとしてアップロードし、古いものは自然に失効させてください。
- 送信予定より大幅に前にバッチを準備しないでください。 ある日にレビューして翌日に送信しようとしても、 そのバッチは存在しません — 失効しており、上述のとおり失効したバッチはキャンセルとして表示されずに一覧から消えます。 アップロードと送信は一度に行ってください。
一括送金では Webhook が送信されますか？
いいえ。送金の Webhook は API 経由で作成された送金に対してのみ送信されます。一括アップロードの行として 作成された送金は、結果がどうであれ通知を生成しません。バッチの結果はバッチ記録とその結果ファイルから追跡するか、 各行のpayoutOrderId を送金 API で照会してください。
送金のステータス、通知、レポート を参照してください。
送金の資金はどこから来るのですか？
お客様の決済（アクワイアリング）精算金からです。一括送金の経路におけるすべての残高チェックとすべての引き落としは、 該当通貨の精算アカウントに対して行われます — 承認するプレビューが読み取るのも同じ残高なので、 プレビューで表示されているアカウントが引き落とされるアカウントです。 2 つの帰結があります。- 資金調達通貨の精算アカウント以外に入金された資金は、一括送金からは利用できません。送金経路にはアカウント選択の 機能がなく、精算残高が不足している場合に別のアカウントへフォールバックすることもありません — 代わりに送信が拒否されます。
- したがって、送金は精算の下流にあります。送金能力を増やしたい場合、調整手段は精算のタイミングであり、 別途のチャージ（トップアップ）フローではありません。精算金がいつ入金されるかを決める要素については 精算サイクル を参照してください。
どの精算アカウントから送金の資金を出せますか？選べますか？
選べません — 通貨によって決まり、その通貨は送金契約から来ます。- 国ごとの送金契約には、受取人通貨とともに資金調達通貨が記録されています。この資金調達通貨だけが、 どの精算アカウントから引き落とすかを決めます。
- 契約設定時に選べる資金調達通貨は、お客様が実際に精算アカウントを保持している通貨に限定されるため、 保持していないアカウントに対して契約が作成されることはありません。
- バッチの資金調達通貨は契約に基づいて行ごとに解決され、それを 1 つに集約するため、 1 つのバッチ内のすべての行は同じ資金調達通貨・受取人通貨・国を共有しなければなりません — これが、バッチ検証がこの 3 つの項目についてオール・オア・ナッシングである根本的な理由です。
1 つのバッチ内のすべての行が同じ国と通貨でなければならないのはなぜですか？
バッチは 1 つの単位として資金を調達するためです。資金調達通貨は行ごとに契約から解決され、バッチ全体で 1 つの値に 集約され、その 1 つの値が引き落とす精算アカウントを 1 つ選びます。コリドーが混在するバッチは複数のアカウントから 引き落とす必要があり、この経路はそれを行いません。 だからこそ、国・資金調達通貨・受取人通貨について検証はオール・オア・ナッシングであり、 不正な行が 1 つあるだけで、その行を除外するのではなくファイル全体がキャンセルされます。 複数コリドーにわたる支払いは、コリドーごとに 1 バッチに分割して別々に送信してください。部分送信はありません。バッチが長時間 In Progress のままです。何を確認すべきですか？
In Progress は複数の段階にまたがるため、経過時間だけでは何もわかりません。代わりに以下を確認してください。
進行を促すためにファイルを再送信しないでください。2 つ目のバッチは 2 回目の引き落としと 2 組目の送金になります。
止まっているバッチは再アップロードせず、Waffo の担当者に連絡してください。
Completed になったバッチはどう照合すればよいですか？
画面ではなく、バッチ記録上のファイルを基に作業してください。
行レベルの失敗は、引き落とし元の精算アカウントに金額が戻されます。戻された金額はバッチの合計から
推測するのではなく、アカウント履歴で確認してください。それらの明細の記載方法については
残高とアカウント履歴 を参照してください。