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.
• 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.
• Custom frequency is not supported for multi-line subscriptions. When you set the frequency manually (without selecting a selling plan), the upgrade works for customers whose subscription contains a single product line. Customers with a multi-product or bundle subscription (two or more active lines) will have the upgrade fail if no matching selling plan exists for the target frequency. To support those customers, create the corresponding selling plan in your Loop dashboard.

​

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)

When configuring a frequency change, you can either pick an existing selling plan or set the frequency manually:

• Use an existing selling plan. Pick from the selling-plan dropdown. The plan must already exist and be active in your Loop dashboard.
• Set the frequency manually. Enter the delivery frequency yourself. Loop accepts any cadence without requiring a matching selling plan. You can also apply a recurring discount when using a manual frequency.

​

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:

• You set the frequency manually and the customer’s subscription has two or more active product lines. In this case, Loop requires a matching selling plan for the target frequency. Create the selling plan in Loop, or switch to Use an existing selling plan in the offer configuration.
• You used Use an existing selling plan and the selected selling plan no longer exists in your Loop dashboard. 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?