cocodot
← Back to guides
Local card declined for overseas AI? cocodot: one card + one key
AI APIUpdated 2026-08

When to Use the Official API and When to Use a Compatible Gateway (2026 Decision Table)

Not 'which is better' but 'what are your constraints'. Clear answers for four scenarios — including the cases where you should not use us.

TL;DR: There is no universal answer; it depends on your hard constraints. Three situations call for going official: procurement requires a direct contract with the vendor, you need contract-level SLA, or your business has zero tolerance for a single-vendor point of failure. Two situations favor a compatible gateway: your card will not go through (overseas acquiring scores risk by issuing country, and cards issued in mainland China pass at low rates), or you want one key across several vendors for comparison without registering and paying at each. One often-overlooked option: mix — production on official for stability, development and testing on the gateway for cost and convenience. Ask first whether you have a non-negotiable constraint (direct vendor relationship / SLA); if so, stop deliberating. If not, compare price and convenience.

1. Check for non-negotiable constraints first

This step can eliminate every comparison below. Direct vendor relationship: some procurement processes require a direct contract with the model vendor; a gateway does not fit. SLA: if your service makes contractual availability commitments, your upstream must offer matching commitments, and gateways cannot provide vendor-level SLA. Data compliance: some industries specify which entities data may pass through; every extra hop is another party to assess. If any of the three applies, the answer is official — stop reading.

2. Card will not go through: the most common real reason

Many people researching 'which should I choose' actually started from the official payment step failing. The cause is fixed: overseas acquirers identify the issuing institution's country from the card's first 6-8 digits (BIN) and score risk accordingly; cards issued in mainland China pass at low rates regardless of balance, and switching to another Chinese bank or another card network changes nothing. Two ways forward: get a card whose issuing country is accepted and stay official (keeping the direct relationship and SLA), or use a compatible gateway that accepts local payment. Decide first how much those two things matter to you.

3. Multi-vendor evaluation: the gateway's real advantage

Choosing between Claude, GPT and Gemini the official way means three registrations, three card bindings, three sets of keys and balances. A compatible gateway's value is concrete here: one key, one balance, change base_url to switch models — evaluation friction drops to nearly zero. That is a real efficiency gain for technology selection and product research. Decide afterward whether to move back to official.

4. Mixing is underrated

In practice many teams' optimum is layered, not either/or: production on official (stability, SLA, direct relationship), development and testing on the gateway (no payment hassle, easy model switching, lower cost). Both use the same OpenAI-compatible code; switching is configuration. You keep production reliability and development flexibility. The one caveat: align model versions on both sides, or behavior validated in development may differ in production.

5. What to verify when choosing a gateway

If you go with a gateway, verify at least three things first: ① whether the model is real — the most common problem is billing for one model and serving a cheaper one, invisible to the eye, so test with fixed probes (the open-source tool probe.cocodot.co runs against any OpenAI-compatible endpoint, including the cocodot that publishes it); ② who operates it — a prepaid balance makes you its unsecured creditor, so at minimum find clear company information and terms; ③ whether your model is listed — 'supports all models' is marketing; check the model list endpoint yourself.

6. Where we stand

Disclosure: this page is published by cocodot, and we provide the second kind (an OpenAI-compatible gateway). By the criteria above, if you need a direct vendor contract or contract-level SLA, we are not for you — stated up front rather than buried in terms. We fit developers whose card will not go through but whose project must move, teams evaluating several vendors, and teams that layer development/testing and production. Prices sit below list and never above it — see cocodot.co/pricing; model integrity is verifiable with the open-source tool above, so you need not take our word for it.

7. A practical suggestion

Do not treat this as a permanent decision. Run both at minimum cost first: if your card works on official, pay for one small month; on the gateway, top up the minimum; run the same tasks on both and compare response quality, speed and actual spend. A week later you will have a conclusion grounded in your own scenario — more accurate than any review. The cost of deciding is far below the cost of migrating after a wrong choice, and that week costs almost nothing.

Four scenarios, four answers

Your situationRecommendationWhy
Corporate procurement needing a direct vendor relationshipOfficialCases that require a direct contract with the vendor
Production system needing contract-level SLAOfficialGateways cannot offer vendor-level service commitments
Card keeps failing, project stalledGatewaySwitching banks does nothing against BIN-based issuing-country checks
Evaluating several vendors' modelsGatewayOne key, one balance, no repeated sign-ups and payments
Personal learning / small projectEitherPick whichever is handier; amounts are small
Both production and developmentMixProduction official for stability, development on gateway for convenience

FAQ

What is the real difference between official API and a compatible gateway?

Official gives you a direct vendor relationship and contract-level SLA; a gateway gives you a payment method that works and one key across vendors. The difference is not quality but what you trade for what.

Can corporate procurement use a gateway?

Depends on the procurement rules. If a direct contract with the model vendor or vendor-level SLA is required, go official; otherwise align with finance on how the spend is booked, then decide.

When is a gateway clearly better?

When the card keeps failing and stalls the project, or when you need to evaluate several vendors under one key. In both cases the friction removed is real.

Can I use official and gateway together?

Yes, and it is often optimal: production official for stability, development and testing on the gateway for convenience. Keep model versions aligned on both sides.

How do I judge whether a gateway is trustworthy?

Verify three things: the model is real (open-source probe), the operator and terms are clear (prepaid balance = you are a creditor), and your model is actually listed (check the model list yourself).

About cocodot

cocodot is a payment and AI access service for developers and cross-border teams in mainland China. It provides US-BIN virtual cards issued by a licensed institution — used to pay for overseas subscriptions and ad accounts — and an OpenAI-compatible AI API gateway for calling Claude, GPT and Gemini from within mainland China. Both share one wallet, funded by Alipay and accounted in USD. Card: $9.9 to open, 3% to load, $1 per active card per month; spending: $0.60 settlement fee on purchases under $20; a corresponding fee applies when the issuer charges one.

Service scope, pricing and limits →
When to Use the Official API and When a Compatible Gateway