Gift Subscriptions Setup via Hosted Customer Flows
Hosted Customer Flows let your customers buy a subscription as a gift and let recipients redeem it, with no custom purchase or redemption UI to build. The Checkout widget or Guest Checkout widget handles the purchase and the Redeem Gift widget handles redemption.
Overview
Gift subscriptions feature allows you to configure gift offers and let your customers buy them for their friends and family.
Gift subscriptions feature involves:
- Gifter - a person who buys a gift. With the Guest Checkout widget, the gifter doesn't need a Cleeng account.
- Recipient - a person who receives a gift: a current subscriber or a person that doesn't have a subscription yet.
- Gift - a subscription offer that is purchased by a gifter for a recipient.
The Checkout widget or Guest Checkout Hosted Widget is used by the gifter to purchase the gift. The recipient redeems it through the Redeem Gift Hosted Widget.
Sell Offers As Gifts
To enable selling offers as gifts you need to do configuration in the Cleeng Dashboard that involves:
- enabling Purchasable as a gift on a subscription offer
- setting other offer parameters
- setting the URL of your redemption page
- configuring redemption options.
For details of the setup, see Gift Subscriptions.
Choose How Gifters Check Out
Gifters can check out in one of two ways.
| Authenticated Checkout | Guest Checkout | |
|---|---|---|
| Use when | Your gifters already have accounts, or you want every purchase linked to an account. | You want gifters to buy without creating an account. |
| Sign-in | Required. If the customer is not signed in, the widget shows login or registration first. If you use an external identity provider (Single Sign-On (SSO)) you need to pass tokens with window.cleeng.setAuthTokens(). | Not required. Gifters enter their name and email at checkout. |
| Purchase record | Linked to the gifter's account and shown in their transactions list. | The gift purchase appears in the Cleeng dashboard. The transaction appears in the Gift Report. Additionally, the gifter appears in the Customer Accounts as a guest. |
| How to enable | Enabled by default. You can select a checkout mode. | Contact the Cleeng Support Team to enable it. Embed the Guest Checkout hosted widget. |
Authenticated Checkout - Choose The Checkout Mode
For a giftable offer, the Checkout widget shows Purchase for myself and Purchase as a gift tabs by default. Set checkout.mode in data-cleeng-props to standard or gift to lock the checkout into one flow, for example behind a “Buy a gift” link. For details, see Checkout mode configuration.
Guest Checkout - Allow Buying A Gift Without An Account
Guest checkout lets gifters buy a gift without signing in or registering. Embed the Guest Checkout Hosted Widget and contact the Cleeng Support Team to enable it. For details of guest checkout configuration, see Guest Checkout Hosted Widget.
Let Recipients Redeem Gifts
Embed the Redeem Gift widget on your redemption page. When the recipient opens the link from the gift email, the widget presents the login/registration page (or you need to pass tokens if you are using external SSO), verifies the gift code, and activates the subscription. Recipients can also enter the code manually via Redeem Gift in the Checkout widget. See Redeem Gift Hosted Widget.
Test Before Going Live
Test both purchase and redemption in Sandbox. See the gift testing steps.
Updated 15 minutes ago