Release Notes 2025.03.13

Important Upcoming Change

📢 Navigation Upgrade - Improved Analytics Experience

By our next release notes edition we will have rolled out your new analytics experience in the Cleeng dashboard. This change will make finding the insights that matter to you simpler and more intuitive. What's more, we're adding brand new performance monitoring tools for Hi5 and Merchant.

All existing dashboards will still be available in a dedicated legacy space. 

To see these changes for yourself, you are welcome to take the interactive tour:

Improvements

🚀 Apple In-App Purchases (StoreKit 2) - Testing Enhancements

We are happy to introduce StoreKit2 Sandbox Fallback. This new solution allows you to effectively test your Apple StoreKit 2 purchases in Cleeng’s production environment before your app goes live. It solves the earlier issue of being unable to test production integrations without a published app.

Once the feature is configured, in-app purchases from your production app will be handled via the Apple sandbox environment until your app is officially published.

Key Benefits:

• Effective pre-launch testing of your production application 
• Minimized post-launch risks

What do I need to do?
You can configure the StoreKit2 Sandbox Fallback feature in the Cleeng Dashboard -> Integration Hub and contact our support team to enable a test payment method.

Learn more
For more details, see our article on Apple In-App Purchases via StoreKit 2.

🚀 Multi-Channel Billing Enhancement

Exciting news! We have removed the limit of one active subscription or pass per offer.

Now, a single customer can have multiple active subscriptions or passes for the same offer. This is possible on condition that they come from different sources (like the web or app stores) or from the same external source, but have unique external identifiers.

Key Benefits:

• A smoother customer experience with minimized entitlements and cancellations issues
• Improved quality of reporting and data

This update also includes several enhancements to our Core APIs, which you can check out in the API Changes section below.

Want to know more?
Take a look at our documentation about multi-channel billing.

Issues Fixed

🛠️ ChurnIQ - Coupon Code Filter is Back

The Coupon Code filter has been reinstated in the Cleeng Dashboard: Overview → One-Time Purchase Overview.

It now offers additional options “Coupon code is blank” and “Coupon code is not blank” for more flexible reporting.

API Changes

Updated

🚀 API Endpoints

The following enhancements have been introduced to support Multi-Channel Billing:

• Create subscription (POST /3.1/subscriptions)
  - enabled: creation of subscription if a subscription for the same customer and offer exists
  - blocked: creating subscriptions when an active subscription for the same source and externalId exists
  - externalId must be unique for a given source (extracted via paymentMethodId)
• Create a pass (POST /3.1/passes)
  - enabled: creation of pass if a pass for the same customer and offer exists
  - blocked: creating a pass when an active pass for the same source and externalId exists
  - externalId must be unique for a given source (extracted via paymentMethodId)
• List subscriptions (GET /3.1/subscriptions)
  - filtering by customerId and offerId might return multiple subscriptions instead of one
• List passes (GET /3.1/passes)
  - filtering by customerId and offerId might return multiple passes instead of one
• Get entitlements (GET 3.1/entitlements/customer_id/{customerId}/offer_id/{offerId})
  - if there are two or more subscriptions/passes for the same offerId and the same customerId, it will return one object with the latest expiresAt date
• List entitlements (GET 3.1/entitlements)
  - if there are two or more subscriptions/passes for the same offer and the same customer, there will be as many entitlements returned as there are subscriptions/passes
• Update subscription (PATCH 3.1/subscriptions/{subscriptionId}
  - This endpoint allows to update expiration dates to earlier values for externally-managed subscriptions (subscriptions that come from external sources).

A new property source has been added. It will be returned for the following endpoints:

• Create subscription (POST /3.1/subscriptions)
• List subscriptions (GET /3.1/subscriptions)
• Get a subscription (GET /3.1/subscriptions/{subscriptionId})
• Update subscription (PATCH /3.1/subscriptions/{subscriptionId})
• Revive subscription (POST /3.1/subscriptions/{subscriptionId}/revive)
• Renew subscription (POST /3.1/subscriptions/{subscriptionId}/renew)
• Transfer subscription (POST /3.1/subscriptions/{subscriptionId}/transfer)
• Create a pass (POST /3.1/passes)
• List passes (GET /3.1/passes)
• Get a pass (GET /3.1/passes/{passId})
• Update a pass (PATCH /3.1/passes/{passId})
• Terminate a pass (POST /3.1/passes/{passId}/terminate)

->>><<<-

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