Release Notes 2026.11.12

Today's Release Notes are dedicated to extensions to our gifting feature. 

For a quick look at how gifting works at Cleeng, take the interactive tour:

 

New in Hosted Customer Flows: Guest Checkout for Gift Subscriptions

You can now let customers buy a gift subscription without logging in or creating a Cleeng account. The new Guest Checkout Hosted Widget opens the gift purchase form directly, which shortens checkout for one-time gift buyers.

Coverage
Hosted Customer Flows only. 

What you need to know

  • Guest Checkout supports gift purchases only. The Checkout Hosted Widget also sells gifts, but the customer must log in or register first.
  • Recipients still need to log in or create an account to redeem the gift.
  • The Gift Report shows whether a guest or a registered customer bought each gift.

What you need to do
Contact Cleeng Support to enable guest checkout for sandbox and production environments, and then embed the Guest Checkout Hosted Widget. For prerequisites and integration steps, see the Guest Checkout Hosted Widget guide.

Learn more

 

Gift Subscriptions: Multi-Period Gifts and Redemption Options

With the improved gifting, you can now set up:

  • Gift length: Let gifters buy 1 to 12 billing periods of an offer in one gift.
  • Redemption options: Choose what recipients who subscribe to a different offer can do: extend their subscription, switch to the gifted offer, or start a new subscription.
  • Offer weight: Control whether recipients can switch to a lower-value offer.

Coverage
Hosted Customer Flows, MediaStore API and Core (3.1) API. 
Note: MediaStore Components don’t support the new options, so if you use MediaStore SDK Components, don’t change the settings in the dashboard.

What you need to know

  • If you already sell gift subscriptions: existing offers and settings keep your current gifting behavior.
  • Hosted Customer Flows: Checkout Hosted Widget: The gift purchase form includes a new field for the recipient’s name.

What you need to do
To use the extended gifting functionality, you need to set up new options for giftable offers, and turn on the redemption options you want.

  1. In the Cleeng Dashboard > Offers & Coupons > Offers, select Allowed billing periods in Pricing > Advanced options. Optionally, set Offer weight to rank your offers. 
  2. In the Cleeng Dashboard > Offers & Coupons > Gift Checkout, turn on the redemption options you want in Gift redemption behavior. If Allow switching to a lower plan is off, recipients can't switch to an offer with a lower weight. Please note that these settings are for recipients who are active subscribers already, and whenever a new subscriber redeems a gift, a new subscription is created.

Learn more

 

Transactional Emails: New and Updated Gift Emails

We've added two new emails, and updated two existing gift-related emails.

New emails

  • Gift Purchase Confirmation: Sent when a buyer purchases a gift.
  • Gift Redemption Confirmation: Sent when a recipient redeems a gift. It confirms the outcome: a new subscription, an extension or a switch.

Updated emails

  • Gift Subscription: The gifter's first name now uses SENDER_NAME parameter. New parameter:  GIFT_CODE .
  • Gift Successfully Delivered: It now includes new parameters DELIVERY_DATE and GIFT_CODE , so the gifter can forward the code if the recipient misses the gift email.

What you need to do

Basic Customization:
Important change - new templates are turned off by default. You need to turn them on in the Cleeng Dashboard if you want to use them. No action is required for existing templates. 

Advanced Customization (your own Mailchimp account): 
You need to sync templates in the Cleeng Dashboard > Admin & Tools > Transactional Emails > Mailchimp Integration to import the new templates. Then turn the email on in the Cleeng Dashboard > Admin & Tools > Transactional emails > Templates. Turn it on only after the template is in Mailchimp Transactional; otherwise, the email won't reach your customers.

Recommended actions for existing templates in Advanced Customization

Template sync doesn't change templates you already have, so update them by hand.

Gift Subscription: CUSTOMER_FIRST_NAME was used to display sender’s name. With this release, we have introduced a dedicated parameter for this: SENDER_NAME . We recommend replacing CUSTOMER_FIRST_NAME   with SENDER_NAME  in every language version:

<p>*We hope you enjoy the gift from *|SENDER_NAME|*</p>

You can also display the new GIFT_CODE parameter in this template.

Gift Successfully Delivered: Add the new parameters where they suit your design:

<p>Your gift subscription has been successfully delivered to *|RECIPIENT_EMAIL|* on *|DELIVERY_DATE|*.</p>

<p>Gift code: *|GIFT_CODE|*</p>

Learn more

 

Gift Analytics: Multi-Period and Guest Gifts in Reporting

The Gift Report and the Gift Analytics Dashboard now cover gifts of several billing periods and gifts bought through guest checkout. You can report the full value of each gift and filter gifts by buyer type and number of periods.

What's new in the Gift Report

  • Buyer Type: customer (a registered account) or guest (bought without registering).
  • Quantity (periods): Number of billing periods the gift covers.
  • Total Duration: Quantity combined with the offer's billing period, for example 3 * monthly.
  • Total Value and Total Value Currency: Total revenue from the gift purchase, in your publisher currency.

What's new in the Gift Analytics Dashboard

  • Filters: Buyer Type and Quantity (periods).
  • Gifts Purchased: Includes guest checkout gifts. A multi-period gift counts as one gift.
  • Offer Period of a Gift: A multi-period gift is shown under its offer's billing period. For example, a 3-month gift of a monthly offer is shown as monthly.

What you need to know
Until you sell multi-period gifts or guest gifts, the Quantity (periods) filter shows only 1 and the Buyer Type filter shows only customers.

What you need to do
If your saved reports or schedules sum Offer Price to measure gift revenue, switch them to Total Value. Offer Price is the list price of one billing period, in the offer's currency and before discounts. Total Value is the revenue from the whole gift in your publisher currency.

Where to find it

  • Cleeng Dashboard > Offers & Coupons > Gift Analytics. 
  • Cleeng Dashboard > Analytics > Data Export > Gift Report tab.

Learn more 

 

API Changes

Gifts can now cover more than one billing cycle, and there are more gift redemption options to choose from. These changes affect Core (3.1) API, MediaStore API and webhooks.

Offer object
Core (3.1) API endpoints that return an offer and MediaStore API [V2] Fetch offer details endpoint now return these new fields:

  • weight: it ranks an offer against your other offers. A higher weight means a higher-value offer. It's used when a gift is redeemed.  
  • gift.allowedCycles: the numbers of billing cycles that can be bought in one gift. 
  • price.giftCycles: the price for each allowed number of cycles. This is read-only.

You can set weight and gift.allowedCycles with the following endpoints:

Core (3.1) API

Order object
Core (3.1) API and MediaStore API endpoints that return an order now return these new fields:

  • giftedCycles: the number of billing cycles the gift covers
  • deliveryDetails.gifter: the gifter's email, firstName and lastName

You can set both with the following endpoints:

Core (3.1) API

MediaStore API

Gift object
The Get a gift and Update a gift endpoints now return these new fields:

  • gifter:  who sent the gift (email, firstName, lastName) 
  • giftedCycles: the number of billing cycles the gift covers. 

Core (3.1) API

MediaStore API 

Gift verification
Verify a gift API endpoints below now return these new fields: 

  • gift: the gift's value (value, currency) and length (duration.days)
  • redeemOptions[]: the ways the recipient can redeem the gift 
  • unavailableOptions[]: options that can’t be used, each with a reason

New refusal reasons: NO_REDEEM_OPTION_AVAILABLE, SEASONAL_SUBSCRIPTION, ACTIVE_PASS.

Core (3.1) API

MediaStore API

Gift redemption 
Redeem a gift API endpoints below accept new optional request body parameters:

  • mode: the redemption option to apply (NEW, EXTEND or SWITCH) 
  • subscriptionId: the subscription to apply the gift to. 

The response includes an outcome object describing the applied redemption option.

Core (3.1) API

MediaStore API

Subscription object
Core (3.1) API endpoints that return a subscription object now return a new field:

  • giftPeriodStart: the Unix timestamp from which a gift starts paying for access.

Webhooks 

->>><<<-

Click here to subscribe to our release notes emails and we will send them over to your inbox.

 

 

Was this page helpful?
0 out of 0 found this helpful

Related articles

In this article