Skip to main content
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 product
  • Both – change frequency and replace product
  • Add another subscribable item to subscription (see Add an item)
  • 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 permissions Aftersell needs: Read and Write on Subscription contracts, and Read on Orders and Selling plans. Write access is only required for subscriptions.
  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 two states:
  • Green tick — “API key verified”. the token authenticated, all required scopes are present, and the token belongs to your store. Continue is now enabled.
  • Red cancel icon. The check did not come back clean. Read the message beside the icon: either the token was rejected or is missing required scopes. The message names the specific missing scopes. Fix the token in Loop and test again. or Aftersell could not complete the check (“Could not verify the API key. Please try again.”), which is a failed call rather than a bad token — in that case just test again.
A could-not-verify result looks exactly like a rejection, so go by the message rather than the icon. Continue stays disabled until the check comes back green, and editing the provider or the token clears the previous result.

​
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.
If you set the frequency manually and the customer’s subscription has two or more active product lines (a multi-product or bundle contract), the upgrade will fail unless a matching selling plan exists for the target frequency. See Limitations for details.

​
Selecting a recurring discount tier

Some Loop selling plans apply different discounts at different points in the subscription — for example, $20 off the first charge and $10 off from the second charge onward. When you select a plan like this, the Recurring discount field is replaced by a list of radio buttons showing each of the plan’s discount tiers with its charge range (for example, “Charge 1” or “Charge 2 onward”). Select the tier you want applied to every future renewal of the upgraded subscription. The selected tier is saved with the offer and applied when a customer accepts the upgrade. If the selected plan has no discount tiers, or you are setting the frequency manually, the standard free-entry discount field appears instead.

​
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. Loop’s upgrade calls are synchronous, so there is no processing delay on Aftersell’s side — the change is applied at Loop the moment the call returns. Loop’s own subscription list can take a little longer to catch up, so if it isn’t there yet, wait a few minutes and refresh before treating it as a failure. If the change isn’t there, it didn’t land — see below.

​
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 If the subscription is unchanged, 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: write on Subscription contracts, read on 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 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), so a temporary line can appear between the two. It resolves as soon as the second step lands.
← Back to Subscription upgrades overview · Setup & configuration · What are integrations?