我们在 GraphQL Admin API 的订阅计费尝试中添加了新的支付错误代码，这些新错误代码提供了更高的细粒度和一致性，使支付错误更易于诊断。它们目前在 可用 的 unstable API 版本中，并将在版本 2026-04 中发布。
我们还在更新错误代码映射，使其更加明确：
- 在 unstable 版本中，您将开始看到显示新的错误代码，以及更少的 AUTHENTICATION_ERROR 和 PAYMENT_METHOD_DECLINED 错误。
- 如果您使用的是版本 2026-01 或更早版本，您可能仍然会注意到现有错误代码的错误数量有所变化。我们改进了映射方式，使得一些以前归类为通用拒绝错误的错误（例如 PAYMENT_METHOD_DECLINED）现在更明确地映射到现有错误代码。例如，我们可以将更多情况映射到 INSUFFICIENT_FUNDS 而不是通用拒绝。
已知问题已解决
从 2026 年 1 月 28 日到 2026 年 2 月 4 日，错误映射存在临时问题，这可能导致 TRANSIENT_ERROR 激增。此问题已修复。
错误代码映射
如果您使用的是版本 unstable 或 2026-04，您将看到新的错误代码。
如果您使用的是 2026-01 或更早版本，您将看到当前映射的代码。
新错误代码 当前映射的错误代码 AMOUNT_TOO_LARGE UNEXPECTED_ERROR MERCHANT_ACCOUNT_ERROR UNEXPECTED_ERROR AUTHENTICATION_FAILED AUTHENTICATION_ERROR AUTHENTICATION_REQUIRED AUTHENTICATION_ERROR CALL_ISSUER PAYMENT_METHOD_DECLINED CARD_DECLINED PAYMENT_METHOD_DECLINED CONFIRMATION_REJECTED PAYMENT_METHOD_DECLINED DO_NOT_HONOR PAYMENT_METHOD_DECLINED MERCHANT_RULE PAYMENT_METHOD_DECLINED OFF_SESSION_REJECTED PAYMENT_METHOD_DECLINED RETRY_DECLINED PAYMENT_METHOD_DECLINED TRANSACTION_LIMIT_EXCEEDED PAYMENT_METHOD_DECLINED INCORRECT_ZIP INVALID_PAYMENT_METHOD INVALID_CURRENCY INVALID_PAYMENT_METHOD INVALID_NUMBER INVALID_PAYMENT_METHOD INVALID_PAYMENT_ERROR INVALID_PAYMENT_METHOD PAYMENT_METHOD_UNSUPPORTED INVALID_PAYMENT_METHOD INCORRECT_ADDRESS INVALID_PAYMENT_METHOD INCORRECT_NUMBER CARD_NUMBER_INCORRECT EXPIRED_CARD EXPIRED_PAYMENT_METHOD INVALID_EXPIRY_DATE EXPIRED_PAYMENT_METHOD EXPIRED_BUYER_ACTION EXPIRED_PAYMENT_METHOD PROCESSING_ERROR UNEXPECTED_ERROR PAYMENT_PROVIDER_ERROR UNEXPECTED_ERROR GENERIC_ERROR TRANSIENT_ERROR CANCELLED_PAYMENT BUYER_CANCELED_PAYMENT_METHOD INVALID_PURCHASE_TYPE PURCHASE_TYPE_NOT_SUPPORTED