決済ワークフロー & ステータス
は、支払いに関する真実の情報です。支払いステータスが注文応答またはWebhookにラップされている場合、
このページで
使用する payment.data.status を参照してください。注文コンテナは、支払いステータスの意味を変更しません。 order.payment.data.status応答は、非同期操作が開始されたことを意味します。必ずしもお金が移動したことを意味するわけではありません。
常に、承認された金額と取引履歴と合わせてステータスを確認してください。 承認されたAPIリクエストまたはHTTP 2xx 不正検出に関する情報は、
を参照してください。 不正検出ワークフローとステータス通知の送信と検証については、こちらを参照してください。 DEUNA Webhooks.
ステータスグループ#
以下のラベルは、商社がこれらの値をどのように処理すべきかを説明しています。これらはAPIの追加フィールドではありません。
| グループ | ステータス | 商人の取り扱い |
|---|---|---|
| 処理または承認を待機中 | pending, pending_3ds, processing, authorizing, capturing, partial_capturing, voiding, refunding, partial_refunding, manual_review | 支払いを未完了のままにする。必要な顧客の操作を完了し、または、承認された結果を待つか取得する。 |
| 確認済みで、正常に動作中 | processed, authorized, captured, partial_captured, partial_refunded | 確認された財務上の結果を記録する。後で、適切な回収、払い戻し、またはキャンセルを行うことで、ステータスが変更される可能性がある。 |
| 失敗したが、回復可能 | denied | この試行での処理は行わないでください。再試行またはルーティングの決定により、同じ決済がアクティブな状態に戻る可能性があるため、これをターミナルとしてモデル化しないでください。 denied （決済処理のステータスとして） |
| 決済のキャンセル待ち（金融処理の完了を待っている状態） | cancelled | 過去の財務活動を検査します。払い戻しまたはVoidも可能です。 |
| ターミナル | voided, refunded, expired | コアの決済状態マシンには、これらの値からの出力遷移は存在しません。 |
partial_captured および partial_refunded これは、商社のビジネスプロセスで必要となる最後の状態である場合でも、ターミナルAPIの状態としては存在しません。実際のステータスと累積額を維持し、部分的なステータスをローカルで置き換えないでください。 captured または refunded.
エンドツーエンドのライフサイクル#
この概要は、主要なライフサイクルファミリーを示しています。Directな移行とプロバイダー固有のブランチは、以下の 検証済みのトランザクション参照.
3DSとOTP
pending_3ds これは認証が完了していないことを意味します。認証が成功した場合、のみ決済フローが継続できます。ただし、購入または承認が成功したことを証明するものではありません。チャレンジ後、 processed, authorized、または別の報告された決済ステータスを待機します。
一部のプロセッサアダプターは、 pending_otp 内部で処理し、結果を公開します。現在の決済処理は、この結果を正常な状態に変換します。 pending および、必要な次のアクションに関するメタデータを提供します。 以前のレポートまたは検索フィルターに pending_otp、これは顧客の対応を待っている状態であり、決済が完了した状態ではありません。
承認、決済、および決済の取り消し#
二段階決済では、まず資金を予約し、その後決済を行います。 authorized これは、実際に決済された金額ではありません。
ステートマシンは、また、プロセッサが状態を報告することを許可します。 captured, partial_captured、または voided まず、対応する「-ing」状態を公開することなく、直接的に通知を行います。通知は、信頼できる状態の瞬間的なキャプチャであり、イベントごとに確実に通知されるわけではありません。
単一ステップでの決済または、プロセッサ接続レベルでの二段階認証/決済の選択肢をご用意しています。決済と決済取消の可否は、プロセッサ、残高、タイミング、および商家の設定によって異なります。DEUNAの担当者は、互換性のある動作を確認できます。
部分決済モードの場合、および final_captureについては、 MPC — 複数部分決済をご参照ください。成功した Void API HTTP を返します 204 No Content; 後続の決済状態を使用し、プロセッサが非同期で処理を完了した際に。
払い戻しとキャンセル#
払い戻しは、回収された資金を返します。キャンセルは、承認を無効にします。これらは互換性はありません。
失敗した払い戻しは、前の金融状態を復元できます (processed, captured、または partial_captured)。 正常な決済と失敗した払い戻し試行を別々に保持します。詳細は MPR – 複数分割払い ネイティブおよびDEUNAによる部分払い戻しモードの場合。
APM のワークフロー#
代替決済方法は、通常 pendingから開始され、 processingを公開し、 processed, denied, cancelled、または expiredで完了します。一部の APM 接続では、承認とキャプチャの両方がサポートされているため、同じ承認ステータスが適用されます。
決済期限は、決済方法および設定によって異なります。 expired ブラウザからの時間経過、またはリダイレクト後の待機。DEUNAからの通知を待つ。
決済ステータスの参照#
値は、大文字・小文字を区別する小文字の文字列です。
| Estado | 意味 | 商社が取るべき対応 |
|---|---|---|
pending | 決済が作成されました。顧客の操作、ルーティング、またはプロバイダによる確認が必要な場合があります。 | 参照 next_action または、指示に従い、処理を保留します。 |
pending_3ds | 3DS認証が完了していません。 | チャレンジを完了し、その結果の決済ステータスを評価してください。 |
processing | 購入またはAPM決済が進行中です。 | Webhookを受信するか、 authoritative な結果を取得してから再試行してください。 |
processed | ワンステップでの購入が完了しました。 | 成功を記録し、履行ポリシーを適用します。払い戻しが必要な場合があります。 |
authorizing | 承認リクエストが進行中です。 | 現時点では、資金が確保または予約されているとは見なさないでください。 |
authorized | 資金が正常に予約されました。 | 適切な場合に、キャプチャまたは無効化してください。 |
capturing | 完全なキャプチャが進行中です。 | 操作を追跡し、確認を待ちます。 |
partial_capturing | 部分的なキャプチャが進行中です。 | 保留中の金額と、確認済みのキャプチャ/払い戻しの可能性を区別してください。 |
partial_captured | 一部の金額がキャプチャされました。 | 確認済みの金額と、残りのキャプチャ/払い戻しの可能性を記録してください。 |
captured | キャプチャが完了しました。 | 収集された金額を記録します。払い戻しが必要な場合があります。 |
voiding | 承認の解放が進行中です。 | 待機する voided または、復元または失敗した結果。 |
voided | 認証が発行されました。 | 端末での取引完了を記録する。 |
refunding | 完全または残高払い戻し処理中です。 | 返金処理の完了を待つ。返金処理の承認は、実際に返金が完了したことを証明するものではない。 |
partial_refunding | 一部返金処理が進行中。 | 未処理および完了した返金金額を個別に追跡する。 |
partial_refunded | 部分払い戻しが完了しました。 | 払い戻し可能な金額と残高を記録します。 |
refunded | ライフサイクルに基づいて設定された払い戻し金額が返却されました。 | 端末での取引完了を記録する。 |
manual_review | 支払いがリスク評価のために保留されています。 | 支払いが新しいステータスを受信するまで、履行をブロックします。 |
denied | 現在の試行が拒否されました。 | 実行しないでください。理由を保持し、設定された再試行により、アクティブなフローに再入力できます。 |
cancelled | 決済方法または商人が決済をキャンセルしました。 | 返金またはキャンセルが完了する必要があるかどうかを確認します。 |
expired | 承認された完了時間が、決済処理の完了前に終了しました。 | 端末での完了を記録し、顧客が再度試行した場合、新しい決済を作成します。 |
not_authorized および failed これらの値は、プロセッサまたはオペレーションレベルのアダプターで使用されますが、コアの標準的な値ではありません。 payment.data.status トランジショングラフには、プロバイダとオペレーションの状態、キャプチャ/返金オペレーションの状態、およびローカルタイムアウトマーカーを決済の状態フィールドにマージしないでください。
検証済みのトランジション参照#
以下のトランジションは、Paymentsのコア状態マシンと一致します。同じ状態の繰り返しは、明示的に許可されている場合を除き、省略されます。リストされたトランジションは、すべてのプロセッサまたは決済方法が対応するオペレーションをサポートすることを保証するものではありません。
| 現在の状態 | 許可される次の状態 |
|---|---|
pending | pending, pending_3ds, authorizing, authorized, processing, processed, cancelled, voided, denied, manual_review, expired |
pending_3ds | pending_3ds, authorizing, authorized, processing, processed, cancelled, denied, manual_review, expired |
processing | processed, cancelled, denied, manual_review, partial_refunding, refunding, partial_refunded, refunded |
processed | refunding, refunded, partial_refunding, partial_refunded, voided |
authorizing | authorized, captured, voiding, cancelled, denied, manual_review |
authorized | capturing, captured, partial_capturing, partial_captured, voiding, voided, cancelled |
capturing | captured, denied; для поддерживаемых потоков восстановления захвата: authorized, partial_capturing, partial_refunding, partial_refunded, refunding, refunded |
partial_capturing | capturing, partial_captured, captured, denied |
partial_captured | captured, partial_refunding, partial_refunded, refunding, refunded |
captured | partial_refunding, partial_refunded, refunding, refunded |
voiding | voided, denied, authorized |
refunding | refunded, partial_refunded, voided, processed, captured |
partial_refunding | partial_refunded, refunding, refunded, denied, processed, captured, partial_captured |
partial_refunded | partial_refunding, refunding, refunded |
manual_review | processed, captured, denied |
denied | pending, pending_3ds, processing, processed, authorizing, authorized, manual_review, denied |
cancelled | refunded, voided |
voided | なし（端末） |
refunded | なし（端末） |
expired | なし（端末） |
決済ファイルの一元化は、DEUNAが外部プロセッサの結果を再調合する際に、追加の復元トランジションを可能にします。これらのトランジションは、状態の意味を変更しません。
Некоторые профили процессоров могут принимать возврат, пока асинхронный захват все еще находится в процессе. В этом случае DEUNA может отменить или обратить захват и вернуть первоначальную авторизацию, что позволяет дополнительным транзициям, перечисленным для capturing. Не инициируйте этот поток, если DEUNA не подтвердила поддержку подключения к процессору.
安全にアップデートを処理してください。#
- 構成されたWebhook検証方法を使用して、すべての通知を検証します。
- ローカル状態を変更する前に、支払いと関連する操作を特定します。
- 報告されたステータス、確認された金額、通貨、オペレーション識別子、およびプロバイダの参照情報を保存します。
- 通知を効率的に処理します。ステータスのみに基づいて重複を削除しないでください。
- 一時的な、レビュー、または不明な状態の場合、支払いを保留します。
- サポートされている決済取得フローを通じて、欠落または競合する結果を調整してください。
HTTPタイムアウト、応答の喪失、または遅延したWebhookは、 denied または expired. 以下のガイドラインに従ってください。 冪等なリクエストに関するガイダンスを行い、支払いの取得、および同じリクエストの再試行と新しい支払い試行を区別します。