MPC - 複数部分キャプチャ
プロセッサネイティブまたは DEUNA 管理の複数部分キャプチャについて、カットオフルールと最終キャプチャの動作を含めて設定方法と運用方法を説明します。
複数の部分キャプチャ (MPC) を使用すると、一度に金額を承認し、複数のリクエストでキャプチャできます。 これは、例えば、チケットの確認、商品の発送、またはサービスの完了などの段階的な履行に適しています。
MPC は、支払いプロセッサとの接続ごとに構成されます。 接続には、承認とキャプチャをサポートする必要があり、DEUNA は、その接続に対して適切な動作モードを有効にする必要があります。
MPC を使用するには、 Create Payments V2 と統合し、自動キャプチャではなく承認を使用して支払いを作成します。
動作モードを選択してください#
| モードでプロセスを完了できます | プロセッサとの連携時 | DEUNAによる管理 | final_capture 動作 |
|---|---|---|---|
| オンライン | すべての決済要求は、直ちにプロセッサに送信されます。 | なし | オンラインMPCフローによって無視されます。 累積された決済金額が承認額に達するか、またはプロセッサのルールに従って、シーケンスが終了します。 |
| オフライン | 未完了の決済要求はバッファリングされます。 DEUNAは、シーケンスが終了したときに、累積された決済金額を送信します。 | はい | シーケンスを終了し、累積された金額を送信します。 |
オンラインモードは、プロセッサの接続が複数の決済をネイティブにサポートする場合にのみ適しています。 オフラインモードは、DEUNAが管理する互換モードであり、バッチ処理が必要なプロセッサにも選択できます。
オフラインMPCのライフサイクル#
- 決済が完了
authorized. - 未完了の決済要求は、残りの承認額に対して検証され、プロセッサを呼び出さずに保存されます。
- 1つ以上の決済金額がバッファリングされている間、決済は
partial_capturing. - DEUNAは、次のいずれかの条件が満たされた場合にシーケンスを終了します。
- 累積された要求金額が承認額に達する。
- 要求に以下のいずれかが含まれる。
"final_capture": true. - 保存された決済の終了時間が到達する。
- DEUNAは、1回の決済操作として、累積されたネット決済金額をプロセッサに送信します。
- 合計金額が承認額と一致する場合、決済は
captured。合計金額が低い場合は、決済はpartial_captured.
承認額を下回るシーケンスの終了により、DEUNAの決済シーケンスが完了します。 その後の決済要求は拒否されます。 選択したプロセッサが残りの承認額をどのように解放するかについては、DEUNAのテクニカルアカウントマネージャー(TAM)にお問い合わせください。
API経由でシーケンスを終了
送信 final_capture JSON形式のブール値として、文字列としてではなく:
{
"amount": 100,
"final_capture": true
}次の amount これは、この決済処理のリクエスト金額です。オフラインモードでは、DEUNAはこれまでの蓄積された決済金額にこの金額を追加し、その後、集約された決済処理のリクエストを送信します。
決済処理の制限時間と上限#
オフラインモードにおける決済処理の制限は以下のとおりです:
- 指定された数値から整数を設定する 1~45暦日.
- DEUNA は絶対期限を
capture_cutoff_atに保存します。値が返される場合は、ローカルで期限を計算せず、このタイムスタンプを支払いの正しい期限として使用してください。 - 承認フローにおいて、承認が完了するタイミングを決定する際、クロックは承認時に開始されます。もし、まだタイムアウト設定がない場合は、最初の非最終的な決済処理が記録される時点で、タイムアウト設定が作成されます。
- 締め切りは、指定されたカレンダー日の末であり、リクエストからの正確な時間数ではありません。
- 後からの部分的な決済は、保存された締め切りを延長またはリセットしません。
- 接続設定の変更は、既存の決済に設定された期限を上書きしません。
- 設定された期限に到達すると、決済はカットオフワーカーによってバッファされた処理を完了させる資格を得ます。 処理は、その日の最終秒に確実に完了するわけではないため、他の商人の決済に対して猶予期間を依存しないでください。
オンラインMPCには、DEUNAの決済カットオフは適用されません。 処理の承認有効期間と決済制限は引き続き適用されます。
金額とシーケンスルール#
- 合計決済金額は、いかなる逆転によって利用可能な残高に影響を与えた場合でも、承認された金額を超えないようにする必要があります。
- 承認された金額に達すると、決済は自動的に完了します。
final_captureこの場合、追加の確認は不要です。 - 承認された金額を下回るオフライン決済の場合、処理者は部分決済をサポートする必要があります。
- 最終決済が完了した後、DEUNAは同じシーケンスに対して別の決済を受け付けません。
- DEUNA は、バッファリングされたオフライン決済のトランザクション数に制限を設けていません。 実際の制限は、金額、カットオフ、接続、およびプロセッサのルールによって決定されます。
常に、確認された金額に基づいて決済処理を行います。 バッファリングされた決済は、プロセッサからの決済金額とは異なります。
ステータスとエラー処理#
| ステータス | MPC フローにおける意味 | 加盟店の対応 |
|---|---|---|
authorized | 資金は予約され、部分的な決済は現在保留中です。 | 有効期限が切れる前に、適切な決済を送信してください。 |
partial_capturing | 1つ以上の決済金額が保留中またはバッファリングされています。 | 保留中の金額と確認済みの金額を区別してください。 バッファリングされた金額を決済として扱わないでください。 |
capturing | 合計金額が決済されています。 | 結果を確認してください。 |
partial_captured | プロセッサによって、承認額以下の金額が確認されました。 | 確認された金額を記録します。 シーケンスが完了した場合は、別の決済を作成しないでください。 |
captured | 承認された全額が決済されました。 | 決済完了を記録します。 |
タイムアウトまたは受け入れられた非同期リクエストは、決済が成功したか失敗したことを証明しません。 決済を取得し、DEUNA のウェブフックを処理して、確認済みのステータスを確認してください。 失敗したオンライン決済は、以前の確認済みの決済の状態を保持し、失敗した操作はトランザクション履歴に表示されます。
完全な移行テーブルについては、 決済ワークフロー & ステータスを参照してください。 重複するリクエストについては、 同時決済と返金.
を参照してください。#
接続の設定について、DEUNA の TAM と連携してください:
| 設定 | オンライン | オフライン |
|---|---|---|
| 機能の状態 | 必須 | 必須 |
| 動作モード | online | offline |
| 決済のカットオフ | DEUNA では使用されません | 必須: 1–45 暦日 |
| プロセッサの機能 | ネイティブな部分払いと複数払い | 払い戻しサポート: 最終的な合計が承認額を下回る場合でも、部分払いも必須 |
管理画面で、注文の詳細を使用して、払い戻しリクエスト、累積額、残りの承認額、および利用可能なカットオフを監視します。 活性化、認証、およびプロセッサの制限は、国および接続によって異なる場合があります。