カード決済ワークフロー
カード購入、認証、3DS、レビュー、キャプチャ、無効化、返金といった状態を、認証と決済成功を混同しないまま追跡する。
カード決済は、ワンステップの購入または、2ステップの認証とキャプチャモデルを使用する。現在の値を payment.data.status; 注文応答内での決済の場合、以下の値を読み取ります。 order.payment.data.status.
このページを使用して、カード固有のパスを使用する。状態の定義と、許可される直接的な移行に関する詳細は、 支払いワークフローとステータス.
購入と認証#
設定されたプロセッサとの接続が、DEUNAが購入または認証を行うかを決定する。3DSチャレンジは、どちらかの操作の前に発生する可能性がある。
| 州 | 意味 | 加盟店の対応 |
|---|---|---|
pending | カード決済は存在しているが、ルーティング、認証、または処理が開始されていない。 | 参照 next_action 存在する場合、および履行をブロックする。 |
pending_3ds | 発行者の認証が不完全である。 | チャレンジを完了し、その後、新しい決済の状態を評価する。 |
processing | 購入リクエストが進行中である。 | 待機する processed または、別の権威ある結果。 |
authorizing | 2ステップの認証が進行中である。 | 待機する authorized または、別の権威ある結果。 |
processed | 購入が完了し、資金が回収された。 | 履行ポリシーを適用する。決済は、返金可能である。 |
authorized | 資金は予約されているが、回収されていない。 | キャプチャまたは無効化を、プロセッサとの接続の制限内で行う。 |
3DSとOTP
認証成功のみが、カードフローを継続させる。購入または認証が成功したことを証明するものではない。チャレンジ後、 processed, authorized、または別の報告された決済ステータスを待機します。
一部のプロセッサアダプターは、 pending_otp 内部で処理し、結果を公開します。現在の決済処理は、この結果を正常な状態に変換します。 pending および、必要な次のアクションに関するメタデータを提供します。 以前のレポートまたは検索フィルターに pending_otp、これは顧客の対応を待っている状態であり、決済が完了した状態ではありません。
リスクレビューとリトライ#
manual_review 履行を、リスク決定の結果が出るまで保留する。承認されたレビューは、 processed または capturedを継続できる。拒否されたレビューは、 deniedが含まれる場合があります。詳細は 不正検出ワークフローとステータス それぞれ別の詐欺フィールドと決定を生成する。
denied 失敗した試行を記述するが、決済の状態マシンは、同じ決済を pending, pending_3ds, processing、または authorizingにルーティングまたはリトライできる。拒否された試行を履行せず、 denied をターミナル決済の状態としてモデル化しない。
キャプチャと認証#
キャプチャは、予約された資金を回収された資金に変換する。プロセッサ、残りの承認済み金額、時間制限、および商人の設定が、どのキャプチャ操作が有効かを決定する。
状態マシンは、 captured または partial_captured を直接受け取ることができる。通知は、権威あるスナップショットであり、イベントごとに確実に発生するわけではない。
部分キャプチャモードの場合、サポートされている同時実行性、時間制限、および final_captureについては、 MPC — 複数部分決済.
承認を無効化#
無効化は、予約された資金を解放する。これは、すでに回収された資金を返金することとは異なる。
成功した Void API HTTP を返します 204 No Content。プロセッサが非同期的に完了した場合、後続の決済の状態を結果として使用する。
回収された資金の返金#
正常な購入、完全なキャプチャ、または部分キャプチャは、接続と残りの返金可能額がある場合に返金可能である。
失敗した返金は、 processed, captured、または partial_capturedを回復する。成功した決済と失敗した返金試行を別々に保持する。 MPR – 複数分割払い ネイティブモードとDEUNA集約モード、時間制限、同時実行性、および残りのバランスの動作に関する詳細は、
統合チェックリスト#
- 履行を
pending,pending_3ds,processing,authorizing, およびmanual_review. - 認証とリクエストの受け取りを、決済の確認とは別の段階として扱う。
- 確認された金額と操作識別子を、すべてのステータス更新時に保存する。
- タイムアウトまたは遅延したプロバイダからの応答後に、信頼できる決済を取得する。
- 以下の 検証済みのトランザクション参照 通常の流れにない、リトライや調整パスを処理する際に。