Subscription upgrades with Loop

This page covers everything specific to using Loop with Subscription Upgrades, including its unique limitations. For a full overview of how Subscription Upgrades work, see Subscription Upgrades.

​

Supported features

Loop supports all Subscription Upgrade types:

• Change delivery or billing frequency
• Replace with a different subscription product
• Change frequency and replace product
• Postpaid frequencies only (prepaid is not supported — see Limitations below)

​

Loop-specific limitations

• Billing frequency must equal delivery frequency. Loop does not support prepaid subscriptions through this integration. The billing frequency field is disabled and automatically synced to the delivery frequency. This is the biggest constraint to be aware of if your store relies on prepaid plans.
• Selling plans must be pre-configured. Loop requires a matching selling plan to already exist in your Loop dashboard for the target frequency.
• Multi-line subscriptions are handled in two steps: the target product line is split into a new subscription with the desired frequency, then removed from the original. This involves multiple API calls and may surface temporary in-progress lines in your Loop dashboard during the sync window.

​

Generating your Loop API token

1. Open the Loop app and navigate to Settings in the bottom left.
2. Under Admin, click API Tokens.
3. Set the following permissions to Read and Write: Subscription contracts, Orders, Selling plans.
4. Click Generate New Token.
5. Provide a name, select the appropriate scopes, and click Generate Token.
6. Click Show Token to view and copy your key. Treat it like a password and store it somewhere safe.

For more details, see Loop’s API documentation.

​

Connecting Loop in the setup wizard

When you reach Step 1: Connect provider in the Subscription Upgrade wizard:

1. Select Loop from the Subscription provider dropdown.
2. Paste your API token into the API token field.
3. Click Test API key. Aftersell validates the token, checking that it authenticates correctly, holds all required scopes, and belongs to your store.
4. Once the test passes (green check), click Continue to move to Step 2.

The test result shows one of three states:

• Green check (valid) — the token authenticated, all required scopes are present, and the token belongs to your store.
• Red X (invalid) — the token was rejected or is missing required scopes. The message names the specific missing scopes. Fix the token in Loop and test again.
• Warning (could not verify) — Aftersell could not reach Loop to complete the check. Test the key again. You cannot save until the check passes or clears.

​

Before you configure the upgrade (Step 3)

Because Loop requires selling plans to exist before you configure the upgrade, confirm the following in your Loop dashboard before reaching Step 3:

• The target selling plan for the frequency you want to offer already exists.
• The selling plan is active and assigned to the correct product.

If the selling plan does not exist, the upgrade will fail silently — the offer product is added to the Shopify order but the subscription is not changed.

​

Verifying an upgrade in Loop

After placing a test order and accepting the upgrade offer: Go to Subscriptions in your Loop dashboard and find the customer’s subscription. Wait up to 24 hours. Loop’s APIs sync asynchronously and the change may not appear immediately, even on a successful upgrade. Do not assume failure until the full 24-hour sync window has passed.

​

Troubleshooting Loop-specific issues

I cannot change the billing frequency This is expected. Loop does not support prepaid subscriptions through this integration. The billing frequency field is disabled and automatically synced to the delivery frequency. The upgrade was accepted but the subscription was not modified Before assuming failure, wait the full 24-hour sync window. If the subscription is still unchanged after 24 hours, the most common causes are:

• The target selling plan does not exist in your Loop dashboard for the configured frequency. Create the selling plan in Loop and retry.
• Your API token is expired or lacks the required permissions. The token must have Read and Write access to Subscription contracts, Orders, and Selling plans. Go to Step 1: Connect provider, re-test your key, and check the error message for the specific missing scopes.
• The eligible product in the funnel does not match what the customer actually subscribed to.

Aftersell automatically retries failed provider calls in a background workflow. If all retries fail, contact support with your store URL, the Shopify order ID, the customer’s email, the approximate time the upgrade was accepted, and the provider you are using. The selling plan dropdown is empty The “Use an existing selling plan” option pulls plans directly from Loop. If the dropdown is empty:

• Confirm selling plans are configured in your Loop dashboard.
• Make sure your API token has Read and Write access to Selling plans.
• Go back to Step 1: Connect provider, re-test your API key, and continue.

Temporary in-progress lines appear in my Loop dashboard This is expected for multi-line subscriptions. Loop handles them in two steps (split, then remove), which can surface temporary lines during the 24-hour sync window. They resolve automatically once the sync completes.

---

← Back to Subscription upgrades overview · Setup & configuration · What are integrations?