概要
Dodo Payments APIは、支払い試行が失敗した理由を詳細に提供し、なぜ支払いが成功しなかったのかを理解するのに役立ちます。これらの失敗理由は、さまざまな支払い方法やプロバイダーにわたって標準化されており、アプリケーションで一貫したエラーハンドリングを実装しやすくなっています。 各取引失敗レスポンスには以下が含まれます：- 特定の失敗理由コード
- 人間が読めるエラーメッセージ
- 利用可能な場合の失敗に関する追加のコンテキスト
- エラーがユーザーによって修正可能か、システムの介入が必要か
- 顧客に明確なフィードバックを提供すること
- 適切なリトライロジックを実装すること
- 異なる失敗シナリオを優雅に処理すること
- 信頼性の高い支払い処理システムを維持すること
取引失敗理由
以下の表は、すべての可能な取引失敗理由、その意味、およびそれらがユーザーによって修正可能なエラーかどうかを示しています。| 失敗コード | ユーザーエラー | 説明 |
|---|---|---|
AUTHENTICATION_FAILURE | はい | 取引中に認証プロセスが失敗しました |
AUTHENTICATION_REQUIRED | はい | 取引を完了するために追加の認証が必要です |
AUTHENTICATION_TIMEOUT | はい | 認証プロセスがタイムアウトしました |
CARD_DECLINED | いいえ | カードが発行銀行によって拒否されました |
CARD_NOT_ACTIVATED | はい | カードがカード保有者によって有効化されていません |
CARD_VELOCITY_EXCEEDED | はい | 短期間に試行された取引が多すぎます |
CUSTOMER_CANCELLED | はい | 顧客が取引をキャンセルしました |
DO_NOT_HONOR | いいえ | 発行銀行が取引を拒否しました |
EXPIRED_CARD | はい | カードの有効期限が切れています |
FRAUDULENT | はい | 取引が潜在的に不正と見なされました |
GENERIC_DECLINE | いいえ | 取引が不明な理由で拒否されました |
INCORRECT_CVC | はい | 提供されたCVCコードが不正確です |
INCORRECT_NUMBER | はい | カード番号が不正確に入力されました |
INSUFFICIENT_FUNDS | はい | アカウントに取引を完了するための十分な資金がありません |
INVALID_ACCOUNT | はい | 提供されたアカウント詳細が無効です |
INVALID_AMOUNT | はい | 取引金額が無効です |
INVALID_CARD_NUMBER | はい | カード番号の形式が無効です |
INVALID_CARD_OWNER | はい | カード所有者の情報が無効です |
INVALID_CVC | はい | CVC形式が無効です |
INVALID_EXPIRY_YEAR | はい | カードの有効期限年が無効です |
INVALID_PIN | はい | 提供されたPINが不正確です |
INVALID_REQUEST | はい | 取引リクエストに無効なデータが含まれています |
INVALID_UPI_ID | はい | 提供されたUPI IDが無効です |
LIMIT_EXCEEDED | はい | 取引がカードまたはアカウントの制限を超えています |
LIVE_MODE_TEST_CARD | はい | テストカードがライブモードで使用されました |
LOST_CARD | はい | カードが紛失として報告されました |
MANDATE_INVALID | はい | 支払いのmandateが無効です |
MANDATE_REQUIRED | はい | この取引にはmandateが必要です |
MANDATE_REQUIRED_SYSTEM | いいえ | システムがこの取引タイプに対してmandateを要求しています |
NETWORK_ERROR | いいえ | 取引中にネットワークエラーが発生しました |
NETWORK_TIMEOUT | いいえ | ネットワークリクエストがタイムアウトしました |
ORDER_CREATION_FAILED | いいえ | 取引のための注文の作成に失敗しました |
PAYMENT_METHOD_PROVIDER_DECLINED | はい | 支払い方法プロバイダーが取引を拒否しました |
PAYMENT_METHOD_UNSUPPORTED | はい | この取引には支払い方法がサポートされていません |
PICKUP_CARD | はい | カードが盗難として報告され、回収する必要があります |
PROCESSING_ERROR | いいえ | 取引処理中にエラーが発生しました |
PROVIDER_UNSUPPORTED | いいえ | 支払いプロバイダーがこの取引タイプをサポートしていません |
REENTER_TRANSACTION | はい | 取引を再入力する必要があります |
REVOCATION_OF_AUTHORIZATION | はい | 取引の承認が取り消されました |
STOLEN_CARD | はい | カードが盗難として報告されました |
TRANSACTION_NOT_ALLOWED | はい | このカードまたはアカウントでは取引が許可されていません |
TRANSACTION_NOT_APPROVED | はい | 取引が承認されませんでした |
TRY_AGAIN_LATER | いいえ | 取引は後で再試行する必要があります |
UNKNOWN_ERROR | いいえ | 不明なエラーが発生しました |
ユーザーエラーは、支払い拒否が顧客によって解決可能かどうかを示します。
trueの場合、顧客は問題を修正するためのアクションを取ることができます（例：正しいカード詳細を入力する）。falseの場合、拒否は顧客が解決できないシステムレベルの問題や銀行の制限によるものです。