Public apps that keep using non-expiring offline access tokens will be delisted from the App Store and can no longer be installed by new merchants. The new client credentials access lets your backend regain access on its own.
Once issued, an offline access token can be used indefinitely.
Use expiring offline access tokens. On top of that, client credentials access lets your backend obtain new short-lived access tokens.
The new phased schedule applies to existing public apps that were originally subject to the January 1, 2027 deadline.
Requirements for these apps remain unchanged.
Custom apps and merchant-created apps are not affected.
| Item | Non-expiring offline tokens (not migrated) | Expiring offline tokens (migrated) |
|---|---|---|
| App Store listing | Delisted from January 1 | Remains listed |
| New installs | Blocked from 1/1 | Still accepted |
| Merchant admin | Warnings shown from 1/15 | Not specified (warnings apply only to apps that haven't migrated) |
| Affected Admin API requests | HTTP 403 from 4/1 | Still usable |
| Restoring access | — | client credentials access Fetch a new token with a request signed by your private key |
Rewrite your token acquisition logic to obtain expiring offline access tokens.
Migrate stores that already have the app installed as well.
Confirm that token storage and refresh handling work correctly.
Even though the API stops on 4/1, App Store delisting and the halt on new installs start on 1/1. Since new customer acquisition stops,plan around 1/1 as your deadline, not 4/1.
Affected Admin API requests using non-expiring tokens will return HTTP 403. The article doesn't specify exactly which endpoints are affected.
Client credentials access usesrequests signed with your app's private key. Your backend needs to be designed to store the private key securely.
Your backend can obtain a new short-lived token on its own, without waiting for the merchant to reopen the app.It serves as a recovery path when a refresh fails.
This phased schedule applies toexisting public apps. Requirements for public apps created on or after 2026/4/1 remain in effect.Custom apps and merchant-created apps are not affected. Sort the apps you handle by type first, then decide what needs to be done.