Learn more about One-time to Subscription Quick Actions here.
Step 1: Get a valid Shopify order ID
For the One-time to subscription Quick Action only
If you’re using the One-time to Subscription Quick Action, you’ll need to get a valid Shopify Order ID for an order that contains an eligible one-time product for testing.
In your Shopify admin, open any one-time order that does not contain a subscription.
Look at the order URL in your browser. The Shopify order ID is the number at the end of the URL.
Example:
https://admin.shopify.com/store/your-store/orders/1234567890In this example,
1234567890is the order ID you need.
Copy this order ID—you'll use it in Step 4.
On the same order page, copy the customer's email address. You'll use this to log in as the customer in the next step.
Step 2: Log in as the customer using Magic Login
In the left-hand menu of your Skio Dashboard, go to Customer Management.
Search for the customer using the email address you copied in Step 1.
Click on Magic Login next to the customer's name.
Confirm you're now viewing your storefront as this customer.
Step 3: Test the quick action URL
Once logged in as the customer, paste your Quick Action URL into your browser.
Replace the
event.orderPlatformvariable in the URL with the Shopify order ID from Step 1.Example URL format:
https://yourstore.com/a/account/quick-action-v3?orderPlatformId=ORDERIDGOESHERE&stackId=12867d4f-e5a3-45a4-b830-0a31a5617eb1Updated URL:
https://yourstore.com/a/account/quick-action-v3?orderPlatformId=1234567890&stackId=12867d4f-e5a3-45a4-b830-0a31a5617eb1
Press Enter. The quick action should now load and display the expected action (e.g., product swap, reactivation, upsell).
What to check when testing
When testing your quick action link, verify the following:
No unsubstituted variables: Ensure the URL doesn't contain placeholders like
{{ person.skio_qaToken|default:'' }}or/{{ person.skio_nextBillingActiveSubscriptionId|default:'' }}/. All variables should be replaced with actual values.Correct subscription state: If you're testing a reactivation quick action, the subscription should be canceled. If you're testing a product swap, the subscription must contain the variant you're swapping from.
Customer session: The quick action must be accessed while logged in as the correct customer. Use Magic Login from your Skio Dashboard to ensure you're in the right session.
Incognito mode: Test in a new incognito or private browsing window to avoid cached data interfering with the test.
Preview feature: Use the Preview feature in the Quick Actions tool within your Skio Dashboard to see how the action will appear before sending it live.
FAQ
Why isn't my Quick Action link working?
Quick Action links won't work if you're not logged in as the customer. Make sure you've used Magic Login from your Skio Dashboard to view the storefront under the correct customer session.
Why am I getting a “link improperly set up” error when I test a Quick Action link?
You’ll see this error when a checkout link fails key validation checks before processing.
This usually happens when order doesn’t belong to the currently logged-in customer. Checkout links are customer-specific. If a logged-in customer tries to access a link that was generated for someone else, it will fail.
To resolve the error:
Confirm that the subscription is eligible for the specified action.
Verify that the logged-in customer matches the one assigned to the checkout link.
What if the quick action doesn't load after I update the URL?
Double-check that you've replaced the event.orderPlatform variable with a valid Shopify order ID and that you're logged in as the correct customer. Also ensure the subscription is in the appropriate state for the action you're testing (e.g., canceled for reactivation).
Can I test multiple quick actions at once?
Yes, but test each quick action URL separately to isolate any issues. Follow the same steps for each link, ensuring you're logged in as the correct customer and using the appropriate order ID.
