期限なしのオフラインアクセストークンを使い続ける公開アプリは、App Store から非掲載になり新規インストールもできなくなる。新しく加わった「client credentials access」で、バックエンドだけでアクセスを取り戻せるようになった。
一度発行されたオフラインアクセストークンが、期限なしで使い続けられる。
有効期限付きのオフラインアクセストークンを使う。さらに client credentials access で、バックエンドが短命なアクセストークンを新しく取り直せる。
もともと 2027年1月1日の期限の対象だった既存の公開アプリに、今回の段階的スケジュールを適用。
この層に対する要件は変わらず有効のまま。
カスタムアプリと、マーチャントが作成したアプリは対象外。
| 項目 | 期限なしオフライントークン（未移行） | 期限付きオフライントークン（移行後） |
|---|---|---|
| App Store 掲載 | 1/1 から非掲載 | 掲載を継続 |
| 新規インストール | 1/1 からブロック | 受付を継続 |
| マーチャント管理画面 | 1/15 から警告表示 | 記載なし（警告の対象は未対応アプリのみ） |
| 対象の Admin API リクエスト | 4/1 から HTTP 403 | 継続して利用可 |
| アクセスの回復 | — | client credentials access 秘密鍵で署名したリクエストで再取得 |
期限付きオフラインアクセストークンを取得するように、取得処理を書き換える。
すでにインストールされているストアの分も移行する。
トークンの保存方法と、リフレッシュの扱いが正しく動くかを確認する。
API が止まるのは 4/1 でも、App Store 非掲載と新規インストール停止は 1/1 から。新規獲得が止まるので、4/1 ではなく 1/1 を締め切りとして計画を立てる。
期限なしトークンを使った対象の Admin API リクエストが HTTP 403 になる。どのエンドポイントが「対象」かの細かい範囲は記事に記載なし。
client credentials access はアプリの秘密鍵で署名したリクエストを使う。バックエンドで秘密鍵を安全に保管する設計が要る。
マーチャントがアプリを開き直すのを待たずに、バックエンドだけで新しい短命トークンを取得できる。リフレッシュ失敗時の復旧ルートとして使える。
今回の段階的スケジュールが適用されるのは既存の公開アプリ。2026/4/1 以降に作成された公開アプリの要件はそのまま有効。カスタムアプリ・マーチャント作成アプリは対象外。自社で扱うアプリをどの種別か仕分けてから対応範囲を決める。