3DS 決済フロー
保留中の認証処理、次のアクションの提示、および最終的な決済ステータスの確認を行います。
カード決済を一度だけ送信し、返された3DSの次のアクションを表示して、バックエンドで決済結果を確認します。認証画面では、ブラウザー情報を収集したり、チャレンジなしで完了したり、銀行での認証を顧客に求めたりする場合があります。
認証はどの段階でも失敗または中断する可能性があります。図は通常の流れを示しています。待機するか、注文を履行するか、復旧手段を提示するかは、現在の決済ステータスに基づいて判断してください。
連携側の責任範囲#
バックエンドは決済を作成し、その結果を確認します。checkoutは返されたアクションを表示し、元の注文のコンテキストを保持します。DEUNAは接続先プロバイダーとブラウザー確認、認証、残りのオーソリゼーションを調整します。チャレンジと認証の判断は発行銀行が行います。
プロバイダーへの認証呼び出しの順序を独自に実装したり、図の各手順に加盟店からの個別のAPIリクエストが必要だと想定したりしないでください。接続先で対応している連携方法を通じて、返されたアクションを使用してください。
1. 決済の作成#
以下のいずれかの決済パターンを使用:
購入者、請求、注文、およびデバイスに関する完全な情報を送信します。これらの情報は、発行者が認証をスムーズに行えるかどうかを判断するのに役立ちます。
2. 決済応答の確認#
保留中の3DSレスポンスには、次のフィールドが含まれる場合があります。この例では、フローの続行に必要なフィールドのみを示します:
{
"order": {
"payment": {
"data": {
"status": "pending_3ds",
"next_action": {
"action": "authorization_3ds",
"authorization_3ds": {
"url_challenge": "https://api.deuna.io/transactions/next-action/NEXT_ACTION_ID"
}
}
}
}
}
}以下のフィールドを真実のデータソースとして使用してください。
| フィールド | 意味 | アクション |
|---|---|---|
order.payment.data.status | pending_3ds は、3DS決済フローの結果がまだ確定していないことを意味します。 | 注文の履行を保留し、返されたアクションを処理してください。 |
order.payment.data.next_action.action | 必要な顧客の行動を特定します。 | 処理 authorization_3ds DEUNA SDKまたは戻りチャレンジデータを使用して。 |
order.payment.data.next_action.authorization_3ds.url_challenge | 次の認証手順を実行するDEUNAのURLです。チャレンジの前にブラウザー確認が行われる場合があります。 | 接続先で対応している表示モードで、返されたURLをそのまま使用してください。 |
互換性のために、一部の統合では、上位レベルの authorization_3ds オブジェクトも受信できる。新しい実装では、 next_action.
3. 次の操作を実行#
Web SDK
使用する initNextAction(...) DEUNAがサポートするモーダル、iframe、またはリダイレクトの動作を管理したい場合に。詳細は、 Web SDK のリファレンスを参照してください。.
DEUNA Payment Widgetがすでに決済フローを管理している場合は、そのウィジェットに返されたアクションの処理を任せてください。同じ試行に対して別のNext Actionインスタンスを開かないでください。加盟店独自の決済フォームを使用する場合は、次を参照してください: Next Actionウィジェット.
ブラウザへの直接統合
次の操作を自身で処理する場合:
- 返された
url_challengeを使用してください。3DS URLを構築しないでください。 - 設定されたプレゼンテーションモードに従ってください。トップレベルのリダイレクトが必要な場合に、issuerページをiframeに強制しないでください。
- 成功、失敗、およびリダイレクトURLを保持してください。
- 閉じられたウィンドウ、コールバック、またはリダイレクトを、決済の成功を示す信号としてではなく、状態を取得するための信号として扱ってください。
ネイティブアプリ
DEUNAがサポートするSDKまたは、安全なシステムブラウザ/ウェブビューを使用してください。購入者がアプリに戻った際に、リダイレクト/ディープリンクを設定し、決済コンテキストを復元してください。
チャレンジ前のブラウザー確認
発行銀行がチャレンジを要求するか判断する前に、返された認証画面がブラウザーやデバイスの情報を収集する場合があります。この手順では、顧客がコードを入力したり決済を承認したりする必要はありません。フローが続行するまで、読み込み画面と認証画面を利用可能な状態に保ってください。
ブラウザーデータの収集が待機時間内に完了しなくても、管理されたフローはその結果を使用して続行する場合があります。それだけで認証の失敗や決済の成功を意味するものではありません。返されたアクションをローカルタイマーによる失敗に置き換えたり、別の購入を開始したりしないでください。
4. 最終決済ステータスの確認#
ブラウザー確認の終了、チャレンジの完了、戻り先URL、SDKコールバックは、元の注文を照合するためのきっかけです。いずれも代金が回収された証拠にはなりません。認証がオーソリゼーションと同時に完了する場合も、その後でDEUNAが決済を完了する必要がある場合もあります。
以下の両方を使用してください:
- 設定と検証が済んだ 決済ステータスWebhook によるバックエンドの更新、および
- 注文を取得 顧客が返品した場合、またはシステムが不確実な結果を処理する必要がある場合。
| 結果 | 意味 | 履行アクション |
|---|---|---|
processed | 購入完了 | ビジネスの検証が完了したら、履行を実行してください。 |
authorized | 決済は承認済みですが、決済は実行されていません。 | 決済戦略に従ってください。決済が完了したとみなさないでください。 |
pending_3ds | 目に見えるチャレンジの有無にかかわらず、3DSフローの結果はまだ確定していません。 | 現在の認証画面を利用可能な状態に保ち、注文を履行したり自動的に再開したりしないでください。 |
pending, processing、または authorizing | 決済処理が完了していません。 | 照合を続けてください。3DSを完了するために別の購入リクエストを送信しないでください。 |
denied, cancelled、または expired | 決済が完了しませんでした。 | 適切な場合にのみ、復旧可能な状態を表示し、新しい試行を開始してください。 |
参照 決済ワークフロー & ステータス を参照してください。
5. 無障害な認証処理の実現#
Frictionlessとは、顧客が発行銀行のチャレンジを行わないことを意味します。それでも、デバイス情報の収集と決済処理の続行のために、返されたブラウザー画面が必要になる場合があります。コードは次の両方の結果に対応する必要があります:
- 即時的な最終的な、または進行中の支払いステータス; または
pending_3dsさらにauthorization_3ds次のアクション。
3DS の評価が完了したかどうかを判断するために、チャレンジ URL の存在は必須ではありません。
チャレンジなしで決済が成功しても、それだけで3DS認証の成功を証明するものではありません。サポートや責任の分析に必要な場合は、返された認証情報を使用してください。
6. タイムアウトと再試行#
ブラウザーデータ収集、チャレンジ画面の読み込み、発行銀行の認証、決済処理には、それぞれ異なる待機時間があります。読み込みの遅延やローカルタイムアウトだけでは決済結果を判断できません。認定時に接続先に適用される認証時間枠を確認し、すべてのチャレンジに共通の固定時間をハードコードしないでください。
- 失効したチャレンジURLを再利用しないでください。
- Не создавайте повторные попытки оплаты, пока первая оплата не будет разрешена.
- 利用可能な最終ステータスと
allow_retry標準化されたエラーガイダンスを使用してから、再度試行する前に。 - ルーティングが別の互換性のある接続を選択した場合、既存の認証結果を再利用するかどうかは、DEUNAが決定します。
画面の終了、ネットワークの中断、タイムアウトが発生した場合は、再試行を提示する前に元の注文を取得してください。決済結果が未確定の場合は保留中と表示し、照合を続けます。成功していない場合は、返されたエラーと再試行の可否に従います。クライアント側で画面を閉じても、バックエンドの決済がキャンセルされるとは限りません。
7. 認証情報を安全に解釈する#
DEUNAの管理者は、プロトコルのバージョン、フロータイプ、ECI、認証結果、およびネットワークトランザクション識別子などの3DSの結果を技術的に表示できます。これらは、サポート、集計、および紛争分析に使用できます。
商人のログに、生の暗号文、完全な認証応答、またはチャレンジHTMLを保存または公開しないでください。 決済ステータス(ECIまたはチャレンジ完了イベントではなく)が決済処理を制御します。