Skip to main content
Subscription Upgrades is currently a Beta feature. Contact support via the in-app chat to have it enabled on your account.
This page covers everything specific to using Recharge with Subscription Upgrades. For a full overview of how Subscription Upgrades work, see Subscription Upgrades.

​
Supported features

Recharge supports all Subscription Upgrade types:
  • Change delivery or billing frequency
  • Replace with a different subscription product
  • Change frequency and replace product
  • Prepaid and postpaid frequencies

​
Generating your Recharge API token

  1. Log in to your Recharge merchant portal.
  2. Navigate to Tools & Apps → API Tokens.
  3. Click Create an API Token.
  4. Enter a name and contact email.
  5. Set the following permissions to Read and Write: Orders, Subscriptions, Plans. Also enable Read on Products.
  6. Click Save and copy the API key.
The token must hold all four scopes: read_orders, read_subscriptions, write_subscriptions, and read_plans. Aftersell checks for all four when you test the key and names any missing ones in the error message. For more details, see Recharge’s API documentation.

​
Connecting Recharge in the setup wizard

When you reach Step 1: Connect provider in the Subscription Upgrade wizard:
  1. Select Recharge 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 Recharge and test again.
  • Warning (could not verify) — Aftersell could not reach Recharge to complete the check. Test the key again. You cannot save until the check passes or clears.

​
Verifying an upgrade in Recharge

After placing a test order and accepting the upgrade offer: Go to Customers in your Recharge dashboard, find the customer, and open Subscriptions. The active subscription should reflect the new frequency, product, or discount immediately. Recharge updates in near real-time after acceptance.

​
Troubleshooting Recharge-specific issues

The upgrade was accepted but the subscription was not modified The most common causes:
  • Your API token is expired or lacks the required permissions. The token must have read_orders, read_subscriptions, write_subscriptions, and read_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 Recharge. If the dropdown is empty:
  • Confirm selling plans are configured in your Recharge dashboard.
  • Make sure your API token has read_plans scope.
  • Go back to Step 1: Connect provider, re-test your API key, and continue.
← Back to Subscription upgrades overview · Setup & configuration · What are integrations?