Skip to main content
This page covers everything specific to using Skio with Subscription Upgrades. For a full overview of how Subscription Upgrades work, see Subscription Upgrades.

​
Supported features

Skio 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)
  • Prepaid and postpaid frequencies

​
Generating your Skio API token

  1. In your Skio dashboard, go to API & Integrations → API.
  2. Enter a name for your new API key and click Generate API key.
  3. Copy the key immediately. It will only be shown once.
  4. Skio issues a single full-access API key, so there are no separate scopes to select. The key grants the subscription edit, create, and cancel access the upgrade needs.
For more details, see Skio’s API documentation.

​
Connecting Skio in the setup wizard

When you reach Step 1: Connect provider in the Subscription Upgrade wizard:
  1. Select Skio 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 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 and 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 does not have access to your Skio account. Generate a fresh key in Skio 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.

​
Verifying an upgrade in Skio

After placing a test order and accepting the upgrade offer: Go to Subscriptions in your Skio dashboard and find the customer’s subscription. The line item, interval, and selling plan should reflect the change immediately. Skio updates in near real-time after acceptance.

​
Troubleshooting Skio-specific issues

The upgrade was accepted but the subscription was not modified The most common causes:
  • Your API token is expired or no longer valid. Skio uses a single full-access key, so generate a fresh key in Skio, go to Step 1: Connect provider, and re-test it.
  • 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 Skio. If the dropdown is empty:
  • Confirm selling plans are configured in your Skio dashboard.
  • Make sure your API key is valid and still has access to your Skio account.
  • Go back to Step 1: Connect provider, re-test your API key, and continue.
← Back to Subscription upgrades overview · Setup & configuration · What are integrations?