← cartapi.io blog

Xbox Game Pass gift card not working: seven fixes and how to get a refund

Published 2026-08-06 · Last updated 2026-08-06 · 6 min read · gaming
TL;DR

Seven reasons an Xbox Game Pass code errors at microsoft.com/redeem: region mismatch, already redeemed, tier confusion (PC vs Ultimate), typo, expired, account payment issue, Microsoft outage. Fixes below. Un-redeemed codes are refundable through most sellers including cartapi's request_refund. Redeemed codes are spent-equivalent — universal industry policy.

You pasted the 25-character code into microsoft.com/redeem. It errored. You feel like you're out $25.

Most of the time you're not. Here's the diagnostic.

The seven failure modes

1. Region mismatch (most common)

Error looks like: "This code isn't valid in your country/region."

Cause: the card's country doesn't match your Microsoft account's registered region. A US Xbox card on a Canadian account, a UK card on a US account, etc.

Fix: check your account region — on Xbox: Settings → System → Language & Location. On Windows: Xbox app → Profile → Settings → Language & Location. If they don't match, don't try to redeem again — you'll only "burn" the code. Contact the seller for a refund and buy the correct region.

2. Already redeemed

Error looks like: "This code has already been used."

Cause: someone (you, previously, or a fraudster) already applied this code to a Microsoft account.

Fix: if you never redeemed it, this is fraud — the card was compromised before it reached you. Take proof of the error to the seller. Physical retailer: take it back with receipt. Online seller: contact their fraud/support team with screenshots. cartapi: trigger request_refund — Reloadly's un-redeemed check will show the code was consumed, and cartapi will investigate the supply-chain issue.

3. PC vs Ultimate tier confusion

Error looks like: code redeems but the subscription doesn't extend the way you expected.

Cause: you have Game Pass Ultimate (Xbox + PC) and applied a PC Game Pass only code, or the reverse. PC Game Pass ≠ Ultimate.

Fix: not really a bug, just tier confusion. The subscription you have is the one it extended. If you wanted the other tier, contact Microsoft support — occasionally they'll do a tier-swap for a first-time issue.

4. Typo in the 25 characters

Error looks like: "This code doesn't look right. Please try again."

Cause: you typed a 0 (zero) as an O (letter), or a 1 as an I, etc. Xbox codes use only specific character sets.

Fix: re-enter, being explicit about 0/O and 1/I/l. If you received the code via email (cartapi's flow), copy-paste rather than typing.

5. Expired code

Error looks like: "This code has expired."

Cause: some Microsoft promotional codes have expiration windows. Retail-sold Game Pass gift cards generally don't expire (US federal law limits gift-card expiration), but promo codes and some regional exceptions do.

Fix: if it's a paid gift card and the seller advertised no expiration, contact them for refund. If it's a promo code from an old bundle, it's gone.

6. Microsoft account payment issue

Error looks like: code redeems but subscription immediately shows "there's a problem with your account."

Cause: your Microsoft account has a stored payment method that's declined a recent auto-renew. The gift card credit applied but Microsoft is confused about billing state.

Fix: Microsoft account → Payment & billing → remove the failed card. Wait 10 minutes. The gift card credit should apply cleanly.

7. Microsoft-side outage

Error looks like: "Something went wrong. Please try again later."

Cause: Xbox Live services occasionally go down. support.xbox.com/xbox-live-status is the status page.

Fix: wait 30 minutes and retry. Almost always resolves.

The refund path, by seller

Where you bought itUn-redeemed refundHow
Walmart / Walgreens (physical)Usually yes within return windowReturn with receipt, un-activated card
Walmart.com / Amazon.com emailUsually yes if un-redeemedCustomer service, request digital-code refund
microsoft.com directNon-refundable per ToS, occasional exceptionsMicrosoft Store support
cartapi via AI agentYes if un-redeemedAsk the agent to call request_refund(order_id). Reloadly's check confirms un-redeemed; Stripe returns funds.
Grey-market key sitesRarelyTheir support flow, best of luck

Rule of thumb: legitimate sellers refund un-redeemed codes because the wholesale layer (Reloadly, Blackhawk) has visibility into whether the code was consumed. Grey-market sellers can't verify and often refuse.

The agent-driven refund

If you bought via cartapi, the flow is:

using cartapi, request a refund for order ord_abc123 — code didn't work.

The agent calls request_refund(order_id="ord_abc123"). cartapi runs Reloadly's un-redeemed check. If clean, Stripe returns the money in 3–5 business days. If already redeemed but you're saying you didn't redeem it, this becomes a supply-chain-fraud case and support investigates.

You never fill out a form. You never call a phone tree.

What to check before you redeem

  1. Verify your Microsoft account's registered region matches the card country.
  2. If it's Ultimate you want, verify the SKU says Ultimate (not PC Game Pass, not Xbox Live Gold historically).
  3. Copy-paste from email; don't type.
  4. Have a stable internet connection (redeeming during a Wi-Fi flap can cause transient errors).
  5. Redeem via redeem.microsoft.com rather than the Xbox in-console flow — better error messages.

Never buying a broken code again

The two behaviors that eliminate most of these errors:

  1. Buy from a legitimate source that verifies un-redeemed status before refund. Microsoft direct, Amazon.com, Walmart.com, cartapi. Skip grey-market key resellers.
  2. Always match card country to account region. When in doubt, ask an agent: "which country is my Microsoft account in?" then buy that country's SKU.

Try the agent-native flow

claude mcp add --transport http cartapi https://mcp.cartapi.io/mcp

using cartapi, $25 Xbox Game Pass Ultimate for US, email to [email protected].

Code arrives. Copy-paste at redeem.microsoft.com. If anything fails, request_refund is one prompt away.

Frequently asked questions

Why is my Xbox Game Pass gift card not working?

Seven common causes: region mismatch, already redeemed, PC vs Ultimate tier confusion, typo, expired, account payment issue, Microsoft outage. Fixes above.

How do I fix a region-mismatch error?

You can't after redemption — code is spent. Before redeeming: check account region and compare to card country. If mismatched, don't redeem; refund the code and buy the right region.

Can I get a refund for an un-redeemed gift card?

Retail: yes within return window. Amazon.com / Walmart.com email: usually yes. Microsoft direct: officially no, exceptions happen. cartapi: yes via request_refund. Once redeemed: never.

The code was already redeemed but not by me. What now?

You bought a used code — fraud in the supply chain. Take proof to the seller. Legitimate sellers (Microsoft, Walmart.com, Amazon.com, cartapi) treat this as fraud and refund. Grey-market sellers often refuse.

Do Game Pass gift cards expire?

Retail-sold cards generally don't (US federal law limits gift-card expiration). Promotional codes from bundles sometimes do — check the promo terms.

About the author

Roc Chow

Roc Chow builds cartapi, the commerce layer for AI agents. The failure modes in this post are from cartapi's support inbox and Reloadly's shared fraud-signal data — not a generic Microsoft help doc.

LinkedIn · · cartapi.io