9 min read Subscriptions

Shopify Customer Account API Deadline: Merchant Checklist

A merchant checklist for Shopify's December 1, 2026 Customer Account API requirement for subscription and returns apps.

Shopify's Customer Account API deadline is December 1, 2026. Subscription and returns apps with buyer-facing self-service must use this API for customer authentication to keep Built for Shopify status, so merchants should verify affected apps and test every account flow before the deadline.

What changes on December 1, 2026

Shopify's official changelog says the requirement applies to subscription apps and returns or exchanges apps that provide buyer-facing self-service. An app that misses the requirement risks losing Built for Shopify status. Shopify does not say every non-compliant app will stop working on that date.

The requirement is about customer authentication. It is not a general shutdown of subscriptions, returns, exchanges, or legacy app portals. Ask each affected vendor how its buyer-facing flow authenticates customers and whether the store needs any changes.

Which stores should run this audit

Run the audit if an installed app lets a buyer manage a subscription, request or track a return, manage an exchange, or take another order-related action through self-service. The requirement belongs to the app, but merchants own the full customer journey and should test it.

Shopify customer accounts let buyers view and manage orders, edit profile information, and take actions such as self-serve returns. Shopify also documents passwordless sign-in with a one-time verification code. Use these account features as reference points when checking whether an app creates a separate or confusing sign-in path.

Merchant checklist before the deadline

  • List every subscription, return, exchange, and cancellation app with a buyer-facing portal.
  • Ask each vendor whether the buyer flow uses the Customer Account API for authentication.
  • Ask whether the app expects new customer accounts, supports legacy customer accounts, or requires a migration.
  • Record every entry point: account menu, order status page, email, SMS, help center, and theme link.
  • Test with a real customer account on mobile and desktop.
  • Test a second market if policies, currencies, languages, or return rules differ.
  • Save the vendor's written answer and the date of your test.

Test subscription self-service

Start with the actions subscribers actually use. Do not rely on a vendor feature list or the merchant admin screen. Complete each action from the buyer's account.

  • Open the subscription portal from the customer account.
  • Pause and resume a subscription.
  • Skip the next order and change the delivery frequency.
  • Swap a product or variant, where supported.
  • Update the shipping address and payment method.
  • Cancel, then verify the confirmation and any retention offer.
  • Trigger the failed-payment path in a test environment where possible.

Record the expected and observed result for every action. A successful login is not enough if the buyer lands on the wrong subscription, sees a stale status, or cannot return to the account.

Test returns and exchanges

Use one eligible order and one ineligible order. Confirm that the buyer sees the correct items, policy result, refund estimate, shipping instructions, and status after submitting a request.

Shopify documents customer account extensions as the surface for app pages and order actions. These extensions are supported on the new version of customer accounts, not legacy customer accounts. That distinction belongs in the vendor answer and merchant test.

  • Request a return from the correct order.
  • Request an exchange if the app offers exchanges.
  • Check a partially fulfilled or partially returned order.
  • Check market-specific return windows and fees.
  • Verify customer emails and links after submission.

Questions to send to app vendors

  • Does your buyer-facing self-service use the Customer Account API for authentication?
  • Which subscription, return, or exchange flows are covered?
  • Will you retain Built for Shopify status after December 1, 2026?
  • Do merchants need to change account settings, theme links, portal URLs, emails, or SMS links?
  • How should existing customers and active subscription contracts be tested?
  • What is the support path if login or self-service fails?

A useful answer names the affected flow, account version, merchant action, and test procedure. A general statement such as "we are working on it" is not enough to close the audit.

A practical schedule for November 2026

Complete the vendor check and flow inventory now. Test the updated customer journey before the final week of November, then leave time to correct links, account settings, help content, and support instructions. This timing is a recommendation, not a Shopify requirement.

On December 1, repeat the shortest critical path: sign in, open the relevant order or subscription, complete one self-service action, and verify its status in the merchant admin. Monitor login and portal support tickets after the change.

Test your subscription portal

The Progus Subscriptions listing states that the app works with customer accounts and provides a self-service portal for skipping, pausing, swapping, adding extras, or cancelling. If you use it, run the same account-flow tests above and confirm your store's setup rather than treating a listing claim as proof of a specific authentication implementation.

FAQ

What is the Shopify Customer Account API deadline?

The deadline is December 1, 2026. It applies to subscription and returns or exchanges apps with buyer-facing self-service that want to maintain Built for Shopify status.

Will an app stop working on December 1?

Not necessarily. Shopify states that apps which miss the requirement are at risk of losing Built for Shopify status. Ask vendors about the operational effect on their specific flows.

Does every Shopify merchant need to change code?

No. The integration requirement is directed at affected app developers. Merchants should verify vendors, check account settings and links, and test the buyer journey.

Do legacy customer accounts support customer account UI extensions?

No. Shopify's developer documentation says customer account UI extensions are supported only on the new version of customer accounts.

What should a subscription merchant test first?

Test sign-in, opening the portal, pause, skip, product swap, address and payment updates, cancellation, and failed-payment recovery. Prioritize the actions customers use most often.

Sell subscriptions on Shopify. About Subscriptions ›