出金のステータスの全体像はどうなっていますか？
出金が悪い形で終わるパターンは 3 つあり、それらは 1 つの汎用的な失敗ではなく、 本当に異なる状態です。
ここで誤読しやすい点が 2 つあります。
RejectedとFailedは同じ事象ではありません。Rejectedは、指図が一度も銀行に 送られていないことを意味します。Processingの後のFailedは、指図は送られたものの 銀行がそれを拒否したことを意味します。Bank Returnは終端ではありません。 完了した出金が巻き戻されている状態を意味します。 返却と、銀行がそれに課した手数料が計上されるとBank Return Confirmedになります。
なぜ出金が勝手にクローズされたのですか？
作成から数時間経ってもNot Submitted のままであり、自動的なスイープがそれをクローズしたためです。
Portal での出金申請は2 段階です。金額を入力すると出金オーダーが作成され、
Not Submitted の状態で残ります。その後に表示される確認画面こそが、実際に送信を行うものです。
その画面を通過しなかった場合 — タブを閉じた、離席した、セッションが切れた — オーダーは
そのまま残ります。一定の時間が経過すると、システムがそれを Closed に移します。
スイープはオーダーごとのタイマーではなくスケジュールで実行されるため、クローズは
カットオフを少し過ぎて発生することがあります。対象となるのは Portal で開始された出金のみです。
API で作成されたものは貴社が指定した
withdrawRequestId によって識別され、
スイープから完全に除外されます。
ここから 2 つのことが導かれ、それが Closed の出金がほとんど問題にならない理由です。
- 何も差し引かれていません。 精算アカウントから引き落とされるのは確認したときであり、 申請が作成されたときではありません。送信されないままクローズされた出金は残高に一切触れて いないため、待つべき戻し処理も、突き合わせるべき台帳の行もありません。
- 確認画面から戻る操作も、即座に同じ結果になります。 そこでキャンセルすると、
スイープに委ねるのではなくその場でオーダーがクローズされます。同じ
Closedステータスで、 同じく資金の移動はありません。
Closed は終端であり、API 上では FAILURE にマッピングされます。やはり進めたい場合は、
もう一度申請してください。
出金を作成したときに API が E0001 Unknown status を返しました。失敗したのですか？
いいえ。公開されている
エラーコード
のリファレンスが示すとおり、まさに不明として扱ってください。出金オーダーはすでに存在し、
すでに進行しているかもしれません。作成されたものの送信ステップが完了しなかった API 出金は、
まもなく自動的に拾い上げられて完了されます。
したがって、同じ意図に対して 2 件目の出金を作成しないでください。withdrawRequestId で
1 件目を照会し（出金 API と残高 API を参照）、
返ってきたステータスに基づいて行動してください。代替を作成することが、加盟店が二重に
支払ってしまう原因になります。
出金 API が、Portal では見かけないステータスを返します。なぜですか？
API が意図的により小さな集合を返しているためで、貴社の連携があらゆる運用ステップを 追跡しなくて済むようにしています。対応は次のとおりです。
明示的に扱う価値があるのは
BANK_DISPUTE_NOTIFIED です。これはまだ失敗ではありません。
「完了した出金が巻き戻されている」と捉え、後続を待ってください。返却が確認されると
FAILURE になります。ポーリングの手順については
出金 API と残高 API を参照してください。
出金が失敗したとき、出金手数料は戻ってきますか？
支払指図がすでに銀行へ送られていたかどうかに完全に依存します。
その背後にあるルールはこうです。Waffo が支払指図を発行した時点で、作業とそのコストはすでに
発生しています。失敗の原因が受取口座にある場合 — 誤った情報、閉鎖された口座や制限のある口座 —
手数料はそのまま残ります。出金が審査段階から先に進まなかった場合は、残りません。
異種通貨の出金では、戻し処理は代わりに全額で計上されます。そのルートの手数料は
別途差し引かれるのではなく、銀行の返却手数料と併せて処理されるためです。いずれにしても、
二重に課金されることはありません。
手数料そのものは常に**内枠（インクルーシブ）**で差し引かれます。送金される額は出金金額から
手数料を引いたものです。したがって「手数料が返還される」とは、単に元の金額の全額が
戻ってくるという意味です。
出金手数料は、入力した金額から差し引かれますか、それとも上乗せで請求されますか？
差し引かれます。入力する金額はグロスの金額です。それが精算アカウントから出ていく数字であり、 送金が出る前に手数料はその中から差し引かれます。
同一通貨の出金では、銀行に届く数字は入力した数字より常に小さくなります。特定の金額を
到着させる必要がある場合は、その金額に手数料を加えた額で申請してください。
知っておく価値のある帰結が 3 つあります。
- 手数料が二度請求されることはありません。 引き落とされるのは出金金額のみで、 手数料はその内側にあります。後から別途の課金が発生することも、そのための Invoice が 出ることもありません。
- 出金金額は手数料より大きい必要があります。 手数料以下の金額では送金する分が残らないため、 申請は受理されて後から失敗するのではなく、その時点で却下されます。
- 手数料は受け取る通貨で課され、それは貴社の出金契約上の手数料通貨と一致している 必要があります。契約が任意の通貨ペアではなく 1 つの通貨ペアを提示しているのはそのためです。
出金の返却について銀行から手数料を課されました。それはどこに表示されますか？
精算アカウントに対する、口座履歴の独立した行として表示されます。したがって銀行の返却は、 1 つではなく2 種類の台帳の動きを生みます。
両方の行は同じ識別属性を共有しており、それによって紐づけられます。
したがって、説明のつかない精算アカウントの動きを突き合わせていて、その
Description が
Withdrawal Cancelled と読める場合は、Business Id を出金履歴で調べてください。
それは精算の調整ではなく、巻き戻されている出金です。
出金の Description 列には何が表示されますか？
ステータスによって変わり、一部の状態では正当に空欄になります。Bank Return の行で Description が空欄なのは期待どおりの動作であり、データの欠落では
ありません。理由は状態が Bank Return Confirmed になった時点で表示されます。
なお Actual Payment Amount は実際に支払われた金額です。受取銀行や中継銀行がその側で
何かを差し引いた場合、貴社の銀行口座に着金した金額と同じ数字にはなりません。
なぜ Withdraw ボタンがグレーアウトしているのですか？
この入口には 3 つの状態があり、ボタンが描画される前に Waffo が精算アカウントに対して行う チェックによって決まります。
そのチェックが使うのは精算アカウントの残高ではなく、出金可能残高です。Reserve を
維持するために留保されている金額は先に除外されます。両者の違いについては
残高と口座履歴 を参照してください。
このチェックはクリック時にも再実行されます。その間に残高が動いていた場合 — ページの読み込みと
クリックの間に返金やチャージバックが着地した場合 — 試行は中止され、更新された数字で
再試行するよう求められます。これはアカウントのエラーではなく、安全のための再チェックです。
申請ドロワーの中では、金額ごとの 2 つ目の検証が適用されます。入力する金額は最低額以上、
契約上の最高額以下であり、かつ利用可能残高の範囲内である必要があります。
異種通貨の出金では、なぜ手数料と受取額が空欄なのですか？
レートが判明するまで、どちらも正直に提示できないためです。
申請ページには、金額が換算されること、そして実際の受取額が異なりうることが示されており、
これらの数字が空のままでも意図的に送信できるようになっています。この段階で手数料が空欄でも
エラーではなく、出金が無料であることを意味するものでもありません。レートも最終的な金額も、
後から出金レコードとその明細に書き込まれます。したがって申請ページからではなく、
レコードから突き合わせてください。
複数のアカウントが関わっているのに、混在通貨の出金が 1 件の支払として表示されるのはなぜですか？
精算通貨の背後にあるアカウント構造が、意図的に貴社には公開されていないためです。 資金を調達するために内部で何が起ころうと、貴社に見えるのは次のとおりです。- 精算通貨ごとに1 つの精算アカウント
- その精算に対する1 件の口座履歴エントリ
- その出金に対する1 件の支払
出金が Processing のまま止まっています。いつサポートに連絡すべきですか？
Processing は、審査の通過から結果が戻るまでのすべてをカバーしており、Waffo のシステムの
外側にある送金の区間も含みます。チケットを起票する前に、次を確認してください。
- ステータスがすでに
Result Submittedに移っていないか — それは結果が届き、確定処理中で あることを意味します。 Successに到達している場合は、Description のSerial No.を確認してください。 着金を追跡する際に自社の銀行に伝えられる銀行の参照番号です。Bank Returnに到達している場合、貴社側の対応は不要です。戻し処理はすでに進行中であり、 確認されると資金は精算アカウントに戻ります。
それでも解決しませんか？出金オーダー ID を添えて サポートに連絡 してください。これは関連する口座履歴の行の
Business Id です。