Comebackby Tan Solutions

Language & region

Comeback / Guides

The Customer Account API deadline for Shopify returns apps

What Shopify's 1 December 2026 Customer Account API rule for returns apps requires, who it affects, and the stated consequence, sourced from shopify.dev.

Also available in Deutsch

From 1 December 2026, returns and exchanges apps with a self-service flow for buyers must sign customers in through the Customer Account API. It is a Built for Shopify requirement. Apps that miss it are, in Shopify's words, "at risk of losing Built for Shopify status". Neither source we checked mentions removal from the App Store.

What the rule says

Shopify announced it in its developer changelog on 17 June 2026: "Returns and exchanges and Subscription apps with buyer-facing self-service experiences must use the Customer Account API for customer authentication" (Shopify changelog, checked 2026-11-12). The deadline is 1 December 2026. The Built for Shopify requirements list it as item 5.12.4: "Your app must support the Customer Account API as the primary method for customer authentication" (Built for Shopify requirements, checked 2026-11-12). Neither page mentions a guest-checkout exception or a grace period.

The rule sits in the standing requirements list, not in a one-time migration notice. So we read it as applying to apps that want the badge, too, not only to apps that hold it. That is our reading; neither source says so outright.

Who it affects

This sits in Shopify's Built for Shopify requirements for returns and exchanges apps, next to three related requirements in the same section: syncing return lifecycle events to Shopify (5.12.1), including exchange line items when managing exchanges (5.12.2), and including shipping and restocking fees where applicable (5.12.3). On the pages we checked, it's one of the requirements an app must meet to gain or keep Built for Shopify status, not a rule every returns app must follow to stay listed. An app that never seeks the badge isn't described as bound by section 5.12.

What "New Customer Accounts" and "the Customer Account API" mean for a merchant

Shopify has two generations of customer accounts: the older ones, which Shopify's own documentation calls "legacy customer accounts," and New Customer Accounts, which are what the Customer Account API is built around. A merchant can check which one a store is on under Settings → Customer accounts in the Shopify admin. An app that authenticates buyers through the Customer Account API works with New Customer Accounts; an app built only against the older account system doesn't meet 5.12.4 as worded above.

What happens if a returns app doesn't migrate in time

The changelog states the consequence plainly: apps that miss the deadline are described as being at risk of losing Built for Shopify status. We found nothing saying a non-migrated app is removed from the App Store or loses its listing. So if your returns app carries the badge today, the badge could change after 1 December 2026; on these sources, the app itself wouldn't disappear.

Where Comeback fits

Comeback, our returns and exchanges app for Shopify stores, was built on New Customer Accounts and the Customer Account API from the start, not moved over later for this deadline. That's our build choice, not a claim about any other app: we haven't checked anyone else's migration status. Comeback is on the Shopify App Store. There is a free plan, and the pricing page lists what each paid plan adds.

What a returns page built on New Customer Accounts can offer: exchanges instead of refunds and store credit instead of a refund.

Sources checked

  • Shopify changelog, "Built for Shopify requirements for Returns and exchanges apps and Subscription apps (effective December 1, 2026)," published 2026-06-17, checked 2026-11-12.
  • Shopify, Built for Shopify requirements documentation, sections 5.12.1–5.12.4, checked 2026-11-12.