概要
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_REQUIRED | ははい | このトランザクションには指示が必要です |
MANDATE_REQUIRED_SYSTEM | いいえ | システムはこのトランザクションタイプに対して指示を必要とします |
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の場合、拒否は顧客が解決できないシステムレベルの問題や銀行の制限によるものです。