Claude APIUpdated 2026-07

How to Add Credits to the Anthropic / Claude API When Your Card Is Declined (2026)

Hitting 'Add credits' in the Anthropic Console and watching your card get declined? Here's why it fails, how Claude API billing actually works (prepaid credits), and the two fixes that work.

TL;DR: Anthropic Console → Billing → Add credits runs on card payments, and cards issued outside the US/EU are frequently declined — the card goes in, the charge never lands. It's a check on where the card was issued, not a mistake on your side. Two fixes: (1) **Add credits with a US-BIN virtual card** (cocodot issues US Visa virtual cards) — right if you must stay on the official Console for official invoices or SLA; (2) **Call Claude through an OpenAI-compatible relay you can fund directly** — cocodot (ours, disclosed) takes card (Stripe), stablecoin (USDC/USDT) or CNY, one-line base_url change — right if you just need Claude working in your code. Two things to know: the Anthropic API is **prepaid credits** — when the balance hits zero, calls fail outright rather than slowing down; and **Claude Code speaks Anthropic's native format**, so if you go the relay route, confirm it exposes an Anthropic-compatible endpoint or Claude Code won't connect.

1. The API is not the same as a subscription

A claude.ai subscription covers the web app and Claude Code usage. The API (console.anthropic.com) is a developer interface billed per token. To build apps, run batch jobs, or power an agent you must use the API, which has its own credit balance and card on file.

2. What you need

Two things: access to console.anthropic.com, and a card that Anthropic will accept. In many countries a local card is declined at checkout, which is exactly the gap a US-issued virtual card fills.

3. Add a card and top up credits

Open Console then Settings then Billing, add your cocodot card, then use Add credits to load your balance (starting with $5 to confirm the card works is a good idea). Credits are usable the moment they post, and you can call the API right away.

4. Pick the right model to save money

Use Sonnet or Haiku for everyday tasks and Opus for the hard problems. Turning on prompt caching cuts a large share of repeated-context cost. Set a spend limit to avoid runaway usage — and your card balance acts as a natural cap on top of that.

5. Common issues

If a card is declined, confirm it has not expired and that the billing address is complete. If credits do not appear, check the invoice status on the Billing page. Need a receipt for accounting? You can download invoices directly from the Console.

Can't add Claude API credits: which fix is for you

	① Add credits via official Console	② Call Claude through a relay
Best for	You need the official account, invoices or SLA	You just need Claude working in your code
How you pay	Issue a US Visa virtual card → Console → Add credits	Fund the balance directly — no card
Account	Your own official Anthropic account	Relay account — still the official models underneath
Network	Direct access from China is unstable; still your problem	Direct route, no VPN
Setup cost	Issue a card, then the official card-on-file flow	Change one base_url (OpenAI-compatible)

FAQ

How do I add credits to the Anthropic / Claude API?

Through console.anthropic.com → Settings → Billing → Add credits, paid by card. If your card is issued outside the US/EU it will often be declined; the two workarounds are to pay with a US-BIN virtual card, or to call Claude through an OpenAI-compatible relay you can fund directly.

Why does my card keep getting declined on Claude API billing?

It's not a data-entry problem — it's a risk check on where the card was issued. Cards from many countries are declined by Anthropic's acquirer. A US-BIN virtual card clears that specific wall.

What happens when Claude API credits run out?

The Anthropic API is prepaid: when the balance reaches zero, calls fail with an error rather than being throttled. In production, monitor the balance so a long-running job doesn't die partway.

Can I use the Claude API without issuing a card at all?

Yes — use an OpenAI-compatible relay you can fund directly: sign up, top up, create a key, point base_url at it and set the Claude model code. Your code barely changes. Note Claude Code needs an Anthropic-compatible endpoint, so check the relay offers one.

My card was declined on Anthropic billing but there is no charge record — why?

That's a pre-auth rejection: Anthropic's checkout rejected it before any authorization reached the issuer, so nothing exists to look up. Usual causes: billing details not matching the cardholder, an exit country that doesn't match the card, or a datacenter IP. Full breakdown: /hub/card-declined-no-record.

Can I also call Chinese models like DeepSeek or Qwen from outside China?

Yes, and that is usually harder than it sounds on your own: those platforms generally require a Chinese phone number and a Chinese payment method to register and pay. Through a gateway you fund one balance (stablecoin, card or CNY) and call DeepSeek, Qwen and GLM from the same OpenAI-compatible endpoint as Claude and GPT. cocodot (ours, disclosed) serves them from $0.028 per million tokens.