API02007: トークンの更新に失敗しました
これが意味すること
POSは自動的に認証セッションを更新しようとしましたが、更新リクエストが失敗しました。通常、再度ログインする必要があります。
よくある原因
- リフレッシュトークンが期限切れ — リフレッシュトークン自体が期限切れ
- リフレッシュトークンが取り消されました — 管理者がすべてのセッションを無効にしました
- サーバーエラー — サーバーが更新リクエストを処理できませんでした
- ネットワークの問題 — 更新の試行中に接続の問題が発生
修正方法
1. 再度ログインする
最も信頼できる修正方法：
- POSからログアウトします
- クレデンシャルを使用して再度ログインします
- これにより、新しいトークンを持つ新しいセッションが作成されます
2. ネットワーク接続を確認する
ネットワークの問題でリフレッシュが失敗している場合：
- インターネット接続を確認する
- ブラウザでWordPressサイトにアクセスしてみる
- 少し待ってから再試行する
3. サーバーの状態を確認する
サーバーに問題がある場合：
- WordPressが正常に動作しているか確認する
- サーバーログにPHPエラーがないか確認する
- 認証プラグインがアクティブであることを確認する
4. セッションデータをクリアする
問題が解決しない場合に限り、以下を確認してから実行してください：
まず未保存の作業がないか確認してください
ローカルデータを消去するかアプリを再インストールすると、このデバイスから店舗に届いていないデータ（オフライン中の販売、開いているカート、保存されていない編集内容など）が削除されます。消去する前にStore health → Databaseを開き、保留中またはサーバーに一度も届いていないデータがないことを確認してください。次にStore health → Logsでstuck recordsが0件、changes waiting to sendが0件であることを確認し、すべての開いているカートを完了するか記録してください。WCPOSにStore healthページがない場合は、先にWCPOSを更新してから確認してください。項目が表示されている、送信待ちがある、または確認できない場合は消去せず、店舗オーナーに相談するかサポートに連絡してください。
- POSアプリのキャッシュをクリアする
- 保存されているクレデンシャルを削除する
- 新しいログインで新たに開始する
自動トークン更新
WCPOSは、セッションを維持するためにトークンが期限切れになる前に自動的に更新します。このプロセスが繰り返し失敗する場合、注意が必要な構成の問題があるかもしれません。