> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Stay AIでのサブスクリプションアップグレード
> Stay AIを接続してAftersellでサブスクリプションアップグレードをセットアップする手順を、前払いプラン、キャンセル、通貨に関するStay AI固有の制限事項も含めてステップごとに解説します。
このページでは、**Stay AI**をサブスクリプションアップグレードで使用する際に固有の内容を、Stay AI特有の制限事項も含めてすべて説明します。サブスクリプションアップグレードの仕組みの全体像については、[サブスクリプションアップグレード](/ja/aftersell/subscription-upgrades)を参照してください。
## 対応機能
Stay AIはすべてのサブスクリプションアップグレードタイプに対応しています。
* 配送または請求頻度を変更(サブスクリプション全体に適用)
* 別の商品に置き換え
* 両方 - 頻度を変更して商品を置き換え
* サブスクリプションに別のサブスク可能なアイテムを追加([アイテムを追加する](/ja/aftersell/subscription-upgrades-add-item)を参照)。顧客がすでにその商品を購読している場合、Stayは新しいラインを追加する代わりにその数量を増やします(これには価格一致の条件があります - 下記の制限事項を参照)。
* 後払い(配送ごとの支払い)の頻度。後払いのサブスクリプションを先払いプランに移行することも含みます(下記の条件があります)
商品の入れ替えには対応していますが、**先払いプランでのみ販売されている商品への入れ替えは除きます** - 下記の前払いに関する制限事項を参照してください。
### サブスクリプションを先払いプランに移行する
後払いのサブスクリプションを先払い(前払い)プランに切り替えることは、次の2つの条件のもとで可能です。
* **先払いプランがStay AIにすでに存在し、商品に割り当てられている必要があります。** Aftersellはプランを作成できません。オファーでは、Stay AIですでに設定されているプランからのみ選択できます。
* **移行すると新しいサブスクリプションが作成され、古いサブスクリプションはキャンセルされます。** Stayはこの変更を、先払いプランで新しいサブスクリプションを作成し、元のサブスクリプションをキャンセルすることで行うため、サブスクリプションには**新しい参照**が割り当てられます。参照でサブスクリプションを追跡している倉庫、3PL、レポートツールは再同期が必要です。[サブスクリプションアップグレードのフルフィルメントと3PLマッピング](/ja/aftersell/subscription-upgrades-fulfillment)を参照してください。
## Stay AI固有の制限事項
* **前払い(先払い)のサブスクリプションは変更できません。** Stayでは、アップグレードタイプにかかわらず、顧客が先払いしたサブスクリプションへの変更は一切許可されていません。前払いプランの顧客がアップグレードオファーを受け入れた場合、アップグレードはキャンセルされて返金され、サブスクリプションはそのまま残ります。同じ理由で、先払いプランでのみ販売されている商品へのサブスクリプションの入れ替えもできません。
* **キャンセルの通知は1アカウントにつき1つのアプリに限られます。** Stayはキャンセルの更新を**1アカウントにつき1つのアプリ**にのみ送信します。Aftersellより前に別のアプリや連携がStayのキャンセルWebhookに登録している場合、Aftersellはそれらの更新を受け取れず、[Subscriptions cancelled チャート](/ja/aftersell/analytics_metrics_reference#subscriptions-cancelled-chart)にStayのキャンセルが反映されません。キャンセルの追跡を機能させるには、接続するAPIキーに**Webhooks**権限が含まれている必要があります(下記参照)。
* **頻度の変更はサブスクリプション全体に適用されます。** Stayではサブスクリプションごとにスケジュールが1つしかないため、届く頻度を変更すると、そのサブスクリプション上のすべての商品が移動します。サブスクリプションに2つ以上の商品が含まれている場合は、オファーで**Keep on existing subscription**をオンにする必要があります。オンにしないと、頻度アップグレードは拒否され、購入者に返金されます。これが必要なのは頻度の変更の場合のみで、商品の入れ替えやアドオンは影響を受けず、この設定なしで機能します。
* **顧客がすでに購読している商品を追加する場合は、価格の一致が必要です。** アドオンが顧客がすでに持っている商品である場合、Stayはラインを追加するのではなく数量を増やします。ただし、これはオファーの価格が顧客がすでにその商品に支払っている価格と一致する場合に限ります。価格が異なる場合(たとえば、アドオンが20%オフで、顧客のプランが10%オフの場合)、アップグレードは拒否され、サブスクリプションは変更されません。アドオンに顧客のプランと同じ割引を設定するか、別の商品を提案してください(別の商品であれば影響はありません)。
* **通貨はストアの価格設定と一致している必要があります。** 顧客のサブスクリプションが、ストアで価格設定していない通貨で請求されている場合、アップグレードは拒否されます。
* **1つの注文から作成された重複サブスクリプションは区別できません。** 1つの注文で、どちらもオファーの商品を含む2つのStayサブスクリプションが開始された場合、Aftersellは顧客がどちらを意図したのか判断できないため、誤ったコントラクトに適用するのではなくアップグレードを拒否します。
* **レート制限によりスループットが制限されます。** Stayでは1アカウントにつき1分あたり60リクエストまで許可されています。1回のアップグレードには4〜6リクエストが必要なため、ストアのピーク時の上限は1分あたり約10〜15件のアップグレードです。
## Stay AI APIキーを生成する
1. Stay AIダッシュボードで、**Account → API tokens → Add API key**に移動します。
2. キーを作成するときに、**All permissions**を選択します。Aftersellには、**Subscriptions**、**Orders**、**Selling Plan Groups**、**Webhooks**へのアクセスが必要です。Webhooks権限により、Aftersellはキャンセルを把握できます。
3. キーをコピーして、安全な場所に保管します。パスワードと同様に扱ってください。
詳細については、[Stay AIのAPI認証ドキュメント](https://docs.stay.ai/reference/authentication)を参照してください。
## セットアップウィザードでStay AIを接続する
サブスクリプションアップグレードウィザードの**ステップ1: Connect provider**に到達したら:
1. **Subscription provider**ドロップダウンから**Stay AI**を選択します。
2. **API key**フィールドにAPIキーを貼り付けます。
3. **Test API key**をクリックします。Aftersellはキーを検証し、正しく認証されること、あなたのストアに属していることを確認します。
4. テストに合格したら(緑のチェック)、**Continue**をクリックしてステップ2に進みます。
テスト結果は2つの状態のいずれかを示します。
* **緑のチェック - 「API key verified」。** キーが認証され、あなたのストアに属しています。**Continue**が有効になります。キーに**Webhooks**権限がない場合でもテストには合格しますが、サブスクリプションのキャンセルが記録されない旨の警告が表示されます。キャンセルを追跡したい場合は、Stay AIで**All permissions**を付与してキーを作成し直してください。
* **赤のキャンセルアイコン。** チェックが正常に完了しませんでした。アイコンの横のメッセージを読んでください: キーが拒否されたか、Aftersellがチェックを完了できなかったか(「Could not verify the API key. Please try again.」)のいずれかです。後者はキーの問題ではなく呼び出しの失敗です - その場合は再度テストするだけで構いません。
「検証できなかった」結果は拒否とまったく同じ見た目になるため、アイコンではなくメッセージで判断してください。チェックが緑になるまで**Continue**は無効のままで、プロバイダーやキーを編集すると前回の結果はクリアされます。
## Stay AIでアップグレードを確認する
テスト注文を行い、アップグレードオファーを受け入れた後:
Stay AIダッシュボードの**Subscriptions**に移動し、顧客のサブスクリプションを見つけます。請求頻度、商品、または次回の請求日に変更が反映されているはずです。
変更自体はAftersellが受け入れを処理した時点で適用されますが、Stayは新しい注文の取り込みに時間がかかることがあります。アップグレードは通常数分以内に反映されますが、最も遅い場合は最大24時間かかります。変更がまだ反映されていない場合は、失敗と判断する前に少し時間を置いてください。
## アップグレードを適用できない場合
Stay AIのアップグレードは安全を前提に設計されており、実行されなかったアップグレードに対して購入者に請求されることはありません。
* **失敗したアップグレードは自動的に再試行されます。** Stay AIへの呼び出しが失敗した場合、Aftersellはバックグラウンドワークフローで再試行します。
* **それでも適用できない場合は、購入者に返金されます。** サブスクリプションアップグレードでは、Shopify注文上の小さなプレースホルダーライン(購入者が受け取る商品ではありません)にのみ請求されるため、アップグレードを完了できない場合、Aftersellはその請求を返金します。
* **確認できないものは、推測せずに手動レビューの対象としてフラグが付けられます。** そのため、実行されなかったアップグレードに対して購入者に請求されることはありません。
再試行と照合の仕組みの詳細(プロバイダー共通)については、[サブスクリプションアップグレードの仕組み](/ja/aftersell/subscription-upgrades#how-subscription-upgrades-work)を参照してください。
## Stay AI固有の問題のトラブルシューティング
**アップグレードは受け入れられたが、サブスクリプションが変更されなかった**
最もよくある原因は次のとおりです。
* 顧客が\*\*前払い(先払い)\*\*プランを利用している。Stayでは前払いのコントラクトを変更できないため、アップグレードはキャンセルされ、返金されます。これは想定どおりの動作です。
* サブスクリプションが**ストアで価格設定していない通貨**で請求されているため、アップグレードが拒否された。
* サブスクリプションに**2つ以上の商品**があり、**Keep on existing subscription**をオンにせずに頻度を変更した。
* 1つの注文で、どちらもオファーの商品を含む**2つのStayサブスクリプション**が開始されたため、Aftersellがどちらをアップグレードすべきか判断できなかった。
* APIキーが別のストアのものであるか、必要な権限(**Subscriptions**、**Orders**、または**Selling Plan Groups**)が不足している。Stay AIでキーを作成し直すか選択し直し、**ステップ1: Connect provider**に移動して再テストしてください。
* ファネル内の対象商品が、顧客が実際に購読しているものと一致していない。
Aftersellは、失敗したプロバイダー呼び出しをバックグラウンドワークフローで自動的に再試行します。すべての再試行が失敗した場合は、ストアのURL、Shopifyの注文ID、顧客のメールアドレス、アップグレードが受け入れられたおおよその時刻、使用しているプロバイダーを添えてサポートにお問い合わせください。
**Stayのキャンセルが分析に表示されない**
Stayはキャンセルの更新を1アカウントにつき1つのアプリにのみ送信します。Aftersellより前に別のアプリがStayのキャンセルWebhookに登録している場合、Aftersellはそれらを受け取れません。StayのキャンセルWebhookを他の連携が使用していないことを確認し、接続しているAPIキーに**Webhooks**権限が含まれていることを確認してください。
***
← [サブスクリプションアップグレードの概要](/ja/aftersell/subscription-upgrades)に戻る · [セットアップと設定](/ja/aftersell/subscription-upgrades-setup) · [連携とは?](/ja/aftersell/subscription-upgrades-integrations)