Skip to main content
出金:例外とステータス は、問題が起きた出金について説明しています。 出金・残高 API はエンドポイントの契約仕様です。本ページは、その 2 つのページでは答えていない 2 つの事項を扱います: 出金を自動化して手動で申請する必要をなくすこと、そして出金に関わる連携の詳細 — 通知、識別子、エクスポート — です。

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

はい、自動出金契約によって可能です。1 つの契約は 1 つの出金契約と 1 つの受取銀行口座に紐づき、Waffo と合意したルールに基づいてお客様の代わりに出金を申請します。 自動出金契約は Waffo 側で設定され、社内承認を経て有効になります。契約が作成されると、Portal の Account → Withdraw → Auto Withdrawal でご自身で確認・操作できます。 申請するには、サポートにお問い合わせいただき、対象の通貨、受取口座、希望するルールをお伝えください。

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

トリガー種別は 2 つあります: AMOUNT_WITH_PERIOD の場合、期間は以下のいずれかです: すべての契約には トリガー時刻も設定されており、UTC+8 で表されます。自動化処理は 1 日の中で繰り返しチェックを行い、その時刻以降の最初のチェックで実行します。日単位のガードにより、チェックが何回実行されても1 契約につき 1 日最大 1 件の自動出金となります。 Portal では、組み立てられたルールが契約行に読みやすい文章として表示されるため、フィールドから自分で再構成する必要はありません。

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

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

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

何も起きず、何も失敗しません。 出金注文は作成されず、アカウントに対してエラーが発生することもなく、後処理が必要な失敗行も残りません。次回の定期チェックで同じルールが再び適用されます。 閾値は 2 つ適用され、いずれか一方を下回っていればその日はスキップされます: つまり、契約の閾値が出金契約の最小額を下回っている場合、その最小額を下回る範囲では決して起動しません — 出金契約の下限が優先されます。

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

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

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

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

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

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

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

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

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

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

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

はい。出金が成功または失敗した際、指定した notifyUrl に WITHDRAW_NOTIFICATION 種別の通知が送信されます。 notifyUrl はリクエストごとに指定するため、アカウントレベルで設定する出金通知の設定はありません。作成する各出金がそれぞれの送信先を持ちます。Portal や自動出金契約から申請された出金はお客様の API 呼び出しではないため、通知は /api/v1/withdraw/create で作成した出金の確認チャネルとして扱い、それ以外については Portal の一覧を記録として扱ってください。 通知に基づいて処理する前に、署名を検証し、/api/v1/withdraw/inquiry から状態を再取得してください — 決済通知に適用されるルールと同じです。

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

1 つの構造が両方に使われます: 異なる通貨間の出金で expectedReceiveAmount と actualReceiveAmount が異なるのは正常であり、 出金:例外とステータス で説明しています。

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

列からは見分けられません — Portal の出金一覧には出金の開始方法は表示されません。区別できるのはリクエスト識別子です: 実務上、開始元をデータとして必要とする場合は、ご自身の withdrawRequestId の値を保持し、認識できないものはすべて連携外で申請されたものとして扱ってください。

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

はい — Portal → Account → Withdraw にエクスポート操作があります。エクスポートの日付範囲は 31 日を超えることができないため、より長い期間は複数回のエクスポートに分けて取得する必要があります。 他の Portal エクスポートと同様にバックグラウンドタスクであり、ファイルはすぐにダウンロードされるのではなくエクスポート履歴に表示されます。エクスポートセンター を参照してください。

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

はい — どちらも出金契約上に出金通貨ペアごとに定められており、Portal、API、自動出金契約のいずれから申請した場合でも、出金作成時に適用されます。範囲外の金額は後で失敗するのではなく、作成時点で拒否されます。 適用される値はお客様の出金契約に記載されているものです。手元にない場合はサポートにお問い合わせください。同じ最小額が、自動出金契約が従う下限にもなります。

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

各出金契約には 1 つ以上の受取銀行口座が紐づいています。出金する際:
  • Portal では紐づいている口座が表示され、複数ある場合はそこから選択できます
  • /api/v1/withdraw/create は bankAccountId を受け取ります。省略すると、出金契約の既定口座が使用されます
口座の追加や変更はセルフサービスではありません。Portal → Settings → Bank Accounts は、すでに紐づいている口座 — 通貨、口座情報、SWIFT コード、銀行住所 — の読み取り専用ビューです。追加や編集の操作はありません。新しい送金先は Waffo 側のコンプライアンス上の変更であり、お客様側の設定変更ではないためです。 追加や変更をご希望の場合は、サポートにお問い合わせください。口座の通貨、口座名義と口座番号、銀行名と SWIFT コード、銀行住所と支店、必要な場合はコルレス銀行の情報をご用意ください — これらは口座レコードが保持するフィールドそのものです。

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

これらはどちら側から送金されるかを表すもので、出金できる金額を表すものではありません。 fundsFrom はお客様が設定するものではなく、口座の openingRegion から決まります。Portal では、出金ドロワーの From ブロックに表示される支払元エンティティを決めるものであり、確認前に表示された名称と銀行明細上の名称が一致するようになっています。 どちらのフィールドも出金可能額に上限を設けるものではありません。金額は出金可能残高と、出金契約の最小額・最大額によって決まります — 上の 2 つの質問を参照してください。
出金に関して本ページと一致しない点がありますか? 出金注文 ID を添えてサポートにお問い合わせください — 1 回の照会で、背後にある出金契約、受取口座、自動出金契約を特定できます。