概要
Dodo Payments APIは、支払い試行が失敗した理由を詳細に提供し、なぜ支払いが成功しなかったのかを理解するのに役立ちます。これらの失敗理由は、さまざまな支払い方法やプロバイダーにわたって標準化されており、アプリケーションで一貫したエラーハンドリングを実装しやすくなっています。 各取引失敗レスポンスには以下が含まれます：- 特定の失敗理由コード
- 人間が読めるエラーメッセージ
- 利用可能な場合の失敗に関する追加のコンテキスト
- エラーがユーザーによって修正可能か、システムの介入が必要か
- 顧客に明確なフィードバックを提供すること
- 適切なリトライロジックを実装すること
- 異なる失敗シナリオを優雅に処理すること
- 信頼性の高い支払い処理システムを維持すること
取引失敗理由
以下の表は、すべての可能な取引失敗理由、その意味、およびそれらがユーザーによって修正可能なエラーかどうかを示しています。| Failure Code | User Error | Description |
|---|---|---|
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 の場合、拒否はシステムレベルの問題や顧客が解決できない銀行の制限によるものです。