Claude Payment Declined? Fixing "Your Card Was Declined" for Claude Pro and API Credits
"Your card was declined" on Claude, either for a Pro or Max subscription or when buying API credits in the Console. Anthropic says it does not receive decline reasons from banks, so this guide walks through what you can check yourself, where each charge lives, and who can tell you why.
1. Figure out which charge was declined
The same message can come from three different places, and the fix depends on which one you are looking at. First, a web subscription: Pro, Max or Ultra bought from Settings → Billing on claude.ai. Second, Console credits: the Buy credits button on the Billing page at platform.claude.com, which funds the API, the playground and Claude Code used through a Console account. Third, a subscription bought inside the Claude mobile app: Anthropic's billing FAQ says those payments are handled by the iOS or Android store, and you manage the payment method and receipts in that store account, not on claude.ai. The subscription and the Console are billed separately. The help center notes that Console usage is never charged to your Claude plan. Some plans include monthly API credits, but only after you link a Console organization to the plan; see Anthropic's help center for which plans qualify. Write down the page you were on, the amount and the time before you do anything else; you will need all three later.
2. What Anthropic says, and what it cannot see
The help center article "Why was my card declined?" opens with an admission that shapes the whole troubleshooting process: Anthropic does not receive detailed information from issuing banks about the specific reason for a decline. It can only list common factors. In practice this means the message on screen carries no reason code, and a support ticket to Anthropic may not get you the bank's side of the story either. The checklist the article gives is: confirm a supported billing location, verify the billing address, complete 3D Secure if it is required, use an accepted payment method, and confirm sufficient funds. After that it suggests retrying with another payment method or at a later time, contacting your bank, and only then contacting Anthropic's support team. The sections below take those items in order and say where to look for each one.
3. Supported regions: check Anthropic's official list
Anthropic's decline article puts a supported billing location first on its checklist. Which countries and regions are supported is set by Anthropic's Supported Regions Policy (anthropic.com/legal/supported-regions); go by what that page says today, since the list is updated over time. Territories and dependencies of a listed country are covered too, and anything not listed is unsupported. Before you try again, open the list and compare it with the country on your billing details, then work through the address, verification and funds checks in section 4.
4. The billing address, 3D Secure, card type and funds
Billing address. The help article warns that small discrepancies, such as a missing accent mark or a misspelled street name, can trigger a decline, so type it carefully rather than relying on browser autofill. With a card from your own bank, follow the help article's guidance. With a cocodot virtual card: this card is not tied to a personal address, and cocodot does not provide or assign any address. On the checkout page, enter the address you actually use as your billing address, fill in every field, and keep using the same one with the same merchant. Do not use an address found online, someone else's, or a made-up one. 3D Secure. If the payment asks for verification, make sure you actually finished it, whether that is a one-time code sent to your phone or an approval in your bank's app or website. Card type. Anthropic accepts credit and debit cards for all purchases, and web subscriptions take only credit or debit cards. Third-party processors such as PayPal and Venmo are not accepted. Funds. Check that the card covers the full amount, including any tax shown at checkout.
5. After a failed renewal: downgrades and saved cards
Two details in the "Paid plan billing FAQs" article catch people out. First, if you paid for Pro or Max and the account suddenly shows the free plan, Anthropic suggests checking whether you signed in with a different email, and whether your payment method failed and the account was downgraded. Settings → Billing shows the recent payment status, and that is where you update the card or billing details. Second, changing your card does not delete the old one. The previous card usually stays in the list of payment methods, and the article says that, depending on your account, a saved card may be charged if your default card is declined. If you switched cards because you no longer want one used, remove it: open the three-dot menu next to it and choose Remove. You cannot remove the default card until another card is the default, and you cannot remove a card that a subscription or an unpaid bill is still using. Separately, the billing date itself cannot be changed directly; the article's workaround is to unsubscribe and resubscribe on the day you prefer.
6. Declined when buying API credits in the Console
Start with permissions. According to "How do I pay for my Claude API usage?", buying credits requires logging in to the Console with an Admin or Billing role, going to platform.claude.com/settings/billing and clicking Buy credits; purchased credits are available immediately. If your role is something else, ask an admin in your organization. Next, look at auto-reload, set in the Credit balance section of the same page. It buys credits when your balance falls below a threshold you choose. If the balance is already at that threshold or lower when you turn it on, the button reads "Turn on and purchase" and you are charged right away to bring the balance up to the target, plus applicable taxes. That immediate charge is worth remembering when you see an unexpected decline notice. Without credits you cannot call the API or use the playground. In code, an HTTP 402 with the type billing_error means, per the official errors page, that there is an issue with your billing or payment information, and the fix is to check payment details in the Console. Finally, purchased credits expire one year after purchase, the date cannot be extended, and all credit purchases are non-refundable, so make your first purchase a small one.
7. Who to ask, and what to bring
Anthropic's own suggestions, after the checklist, are to try another payment method, to try again later because temporary technical issues or network disruptions can cause declines that resolve on their own, and to ask your bank about the reason. Ask your card issuer and the merchant to confirm the reason for the decline. A missing entry in your bank app does not show where the request was stopped, and a decline at another merchant does not by itself identify the cause. Make the call short by preparing: the exact time of the attempt (to the minute, with your time zone), the amount and currency, a screenshot of the message, and whether it was a subscription or a Console purchase. Ask the bank whether they received an authorization request from Anthropic at that time and what decline code they returned. If you then go to Anthropic support, name the account email or the Console organization involved. Resist the urge to hit the button over and over; get the reason first, then try again.
8. Using a cocodot virtual card
cocodot issues US-BIN Mastercard virtual cards; new cards can use the 537872 or 555659 range. Check your billing location against section 3 first. The flow: sign up, top up your wallet with Alipay / WeChat Pay (RMB) or USDT / USDC, open a card, and move funds onto the card. The wallet balance and the card balance are separate, so the card itself needs enough for the charge. Fill in the billing address as described in section 4. Whether a payment goes through depends on Anthropic's review and the actual result, so verify with a small amount first; if you are buying API credits, start with a small purchase, since Console credits are non-refundable. /hub/claude-pro explains how the subscription tiers differ.
Which Claude charge failed? (based on support.claude.com help articles)
| Where you saw the decline | Where it is managed | Who can fix it | What happens after a failure | First thing to check |
|---|---|---|---|---|
| Pro / Max subscription on the web | claude.ai, Settings → Billing | The account owner | The account can be downgraded to the free plan | Recent payment status under Settings → Billing |
| Buying API credits | platform.claude.com/settings/billing → Buy credits | A Console member with the Admin or Billing role | Once credits run out, the API and playground stop working | Credit balance and payment method on the Billing page |
| Auto-reload | Same Billing page, Credit balance section | Admin or Billing role | Turning it on at the threshold or lower charges immediately | Your threshold and target under Manage auto-reload |
| Subscription bought in the iOS or Android app | Your iOS or Android store account | The account owner | Handled by that store, not claude.ai | Subscription and payment settings in that store |
| HTTP 402 from the API | Your code | — | billing_error: a problem with billing or payment details | Payment details in the Console |