Guide: Claim subscription ownership after guest checkout
Available from Release 115 onwards.
The big idea
Limio supports a claim ownership flow that lets a customer link a subscription bought via guest checkout to their authenticated identity. Once claimed, the subscription appears in their self-service portal and behaves exactly like one they purchased while signed in. They can update payment, switch plans, see invoices, or cancel online.
This pairs with Limio's support for guest checkout so you can reduce friction at the point of sale without leaving customers stranded post-purchase.
Why do it
Give end users full self-service for subscriptions they didn't (or couldn't) buy while signed in.
Support B2B scenarios where the buyer is a different person from the end user.
Reduce support load by letting customers manage their own subscriptions instead of contacting you.
What the customer experiences
Purchase: a buyer places an order through anonymous checkout. The subscription is created with no authenticated owner; only the customer email and details are recorded.
Notify: the customer is shown the subscription reference (for example
A-S00012345) on the order-complete page and/or in their order confirmation email.Sign in: the end user signs in or registers an account on your Limio MMA portal.
Claim: a custom component calls
claimSubscriptionOwnership()with the subscription reference. If their email matches the email on the subscription's customer record, ownership transfers in real time.Self-service: the subscription appears in their Self-Service portal. They can manage it like any other subscription they own.
Constraints
Email must match. The authenticated user's email must match the email on the subscription's customer record (case-insensitive). If they differ, the claim is rejected.
Guest purchases only. A subscription already owned by another authenticated user cannot be claimed.
Authenticated session required. The user must be signed in before the claim is attempted.
When the claim succeeds, all related records (orders, offers, add-ons, payment methods, addresses, schedules) transfer to the authenticated user along with the subscription. The call is idempotent: calling it again on a subscription the user already owns returns success without side effects, so it's safe to retry.
How to enable
This feature is currently available only via the SDK. Your developers will need to build a custom component (typically a form or prompt on an MMA page) that calls claimSubscriptionOwnership from @limio/sdk.
Share the SDK reference for claimSubscriptionOwnership with your dev team.
Related
Last updated
Was this helpful?