概述
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 时，拒付是由于系统级问题或银行限制，客户无法解决。