Changelogs Archive - Page 5 of 16

Freemius Checkout translations out of beta

Great news! The Freemius Checkout now fully supports the following languages out of the box.

Spanish
German
French
Italian
Dutch

Loading the checkout page in a buyer’s native language significantly improves conversion rates. That’s why we’ve prioritized translating the Checkout into the most popular languages.

To display the Checkout in a specific language, you can use the language parameter when configuring the Checkout JavaScript SDK. For example:

const handler = new FS.Checkout({
  plugin_id: 'x',
  public_key: '...',
  language: 'de_DE',
});

The example above will load the Checkout in German. Alternatively, you can use the value 'auto', which automatically determines the buyer’s location and loads the Checkout in their supported language. For more information please see our documentation here.

New JavaScript SDK for Freemius Checkout – Calling for testers

We have released a new beta version of our JS SDK for our Checkout. This version aims to:

Remove jQuery from the dependencies.
Provide better Developer Experience (DX) through type documents.
Provide both CDN and npm packages for any type of consumer.

We’ve also open-sourced it under the MIT license to accept contributions from our makers. You can find the repository here on GitHub along with the usage guide.

While we aim to replace the Legacy JS SDK soon, we would like to call for testers to help with this new system. Please read below to get started quickly.

Using the new JS SDK

Instead of https://checkout.freemius.com/checkout.min.js, please use the new CDN under https://checkout.freemius.com/js/v1/. Here’s a quick code example:

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

<select id="licenses">
    <option value="1" selected="selected">Single Site License</option>
    <option value="2">2-Site License</option>
    <option value="unlimited">Unlimited Sites License</option>
</select>
<button id="purchase">Buy Button</button>
 
<script
    type="text/javascript"
    src="https://checkout.freemius.com/js/v1/"
></script>
 
<script type="text/javascript">
    const handler = new FS.Checkout({
        plugin_id: '9885',
        plan_id: '16634',
        public_key: 'pk_ccca7be7fa43aec791448b43c6266',
        image: 'https://your-plugin-site.com/logo-100x100.png',
    });
 
    document.querySelector('#purchase').addEventListener('click', (e) => {
        handler.open({
            name: 'My Awesome Plugin',
            licenses: document.querySelector('#licenses').value,
            // You can consume the response for after purchase logic.
            purchaseCompleted: function (response) {
                // The logic here will be executed immediately after the purchase confirmation.
                // alert(response.user.email);
            },
            success: function (response) {
                // The logic here will be executed after the customer closes the checkout, after a successful purchase.
                // alert(response.user.email);
            },
        });
 
        e.preventDefault();
    });
</script>

The difference with the Legacy JS SDK is:

We don’t need jQuery anymore. So you can remove it if you’re not using it for anything else.
Instead of accessing the singleton handler from FS.Checkout.configure, we now create a new handler with new FS.Checkout and use the instance accordingly.

You are free to create any number of instances if you’re selling multiple products from the same page. Cart recovery will also work as soon as you’ve instantiated and will only target the product the instance is responsible for.

Easy migration from the Legacy JS SDK

To make it easy to migrate without changing much of your code, we have also developed a compatibility layer.

In your code, where you do

1 2	`<script` `src="https://code.jquery.com/jquery-1.12.4.min.js"></script>` `<script` `src="https://checkout.freemius.com/checkout.min.js"></script>`

Remove the jQuery script tag if you aren’t using jQuery.
Replace the checkout script with the new one.

1	`<script` `src="https://checkout.freemius.com/js/v1/legacy/"></script>`

Now all your existing code should work as-is.

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

const handler = FS.Checkout.configure({
    plugin_id: '1234',
    plan_id: '5678',
    public_key: 'pk_ccca7be7fa43aec791448b43c6266',
    image: 'https://your-plugin-site.com/logo-100x100.png',
});
 
document.querySelector('#purchase').addEventListener('click', (e) => {
    handler.open({
        name: 'My Awesome Plugin',
        licenses: document.querySelector('#licenses').value,
        // You can consume the response for after purchase logic.
        purchaseCompleted: function (response) {
            // The logic here will be executed immediately after the purchase confirmation.
            // alert(response.user.email);
        },
        success: function (response) {
            // The logic here will be executed after the customer closes the checkout, after a successful purchase.
            // alert(response.user.email);
        },
    });
 
    e.preventDefault();
});

In the future, we will replace the Legacy JS SDK with this compatibility layer to reduce the footprint.

Please note that if you’re getting started or willing to refactor your code a little bit, kindly consider using the regular pattern instead of the legacy singleton pattern.

Performance improvements

While working on the new JS SDK, we also looked into improving performance. Here are the results:

The new JS SDK loads about 60% faster than the Legacy JS SDK – Your pricing page will load faster by 1 second on average.
The Checkout app itself also loads 40% faster – Once users click the buy button the checkout will appear faster than before.

We hope you’ll help us test the new JS SDK so that we can get it out in the wild as soon as possible. If you have any questions, please don’t hesitate to write to our support.

Misc User Dashboard bug fixes

In this week’s release, we have fixed the following couple of bugs we discovered in our User Dashboard.

Both of them are related to the contact form we show in the app.

We discovered the contact form wrongly showed the developer’s email address instead of the store’s support address. We have fixed it.
We also noticed a typo in a word. We have fixed it as well.

Misc Developer Dashboard bug fixes and improvements

This week’s release brings the following bug fixes and enhancements to the Developer Dashboard.

Mailchimp integration improvement

Following up on the Mailchimp integration improvement – When unlinking a connection, the connection will be deleted from our server if it is not used by any other products.

This helps clean up any leftover connection data that is not in use anymore.

Plan deletion bug fix

When deleting plans we will now show a notice if there are active licenses associated with the plan. If you want to deprecate some plan, we recommend hiding it instead of deleting it. We will come up with more follow-up updates to ease the deprecation of plans with active usage.

Right now, deleting a plan with active licenses can create issues for existing customers. Hence we have disabled this for the time being.

Composer integration

We added a notice in the “Deployment” page of WordPress products to use a proper semantic version to support composer integration.

Data export now available for Subscriptions

Following up on our data liberation project, we are glad to announce the immediate availability of subscription exports from the Developer Dashboard.

Previously we worked on improving the User Export and also introduced the Payment Export.

With this week’s release exporting Subscriptions is now possible. Go to the “Subscription” page under your Developer Dashboard and click the “Download” button to start.

We are not done with the data liberation project yet. Please stay tuned for more updates.

Easier API authentication with Bearer Auth protocol

To push Freemius for SaaS products, we have released yet another new feature. Now it is easier to communicate with our API using Bearer Authentication.

Go to “Settings” > “API Token” of any product and you will see the token that you can use as bearer auth. We have also included a few examples to get you started.

Please note that the API Token works only for product-scoped endpoints for now. We are also working on a new API documentation website using OpenAPI schema to ease the consumption of different endpoints. Please stay tuned for more updates.

Checkout licensing UI bug fixes

A maker provided us with some bug reports for the Checkout’s licensing UI.

We noticed we did not show the short label in the “License label” (where it says “Single Site”) when there was only one unit available. It was wrongly showing “Single Site License” causing inconsistency in the UI. We have fixed that.

We also noticed a broken UI in case the error message when entering a license key was long. Previously the “Try again?” button would try to appear in the same line, breaking the flow of the UI. We have improved that as well.

General SaaS improvements

We have various small and medium tweaks to our system to make it more useful for SaaS makers. The changes were made across the Developer Dashboard, the backend, and the User Dashboard. Please find the details below.

Decluttering the Developer Dashboard

We have removed or enhanced many things that do not pertain to SaaS products.

We improved the Plans configuration.

The Customization section was also simplified.

The Settings page also got a revamp.

The setup page also updated some inline documentation.

Removed License related information from the User Dashboard

Recently we pushed a change to allow SaaS products to decide whether to expose licenses to the users.

Following up, we’ve updated the User Dashboard to show or hide any license-related information depending on the configuration.

CCing payment emails to user billing address

Freemius sends various payment-related emails to the users. For example

When a new subscription is made.
When a renewal of a subscription happens.
When a refund is issued.

We have been sending the emails to the primary address of the user.

The users can also have a different “Billing Address” defined through the User Dashboard.

To make the user experience better, we are now CCing such emails to the billing email too. For example, if the address of the user is jane@example.com and the billing email is set as billing@example.com, Freemius will now send payment-related emails to both addresses.

API-related enhancements for Licenses and SaaS

We are pushing more enhancements in our system to cater to SaaS. Recently we looked deeply at our API and how SaaS makers can consume our API. In the process, we delivered the following enhancements.

Using `product` scope in API endpoint paths

We’ve been using and documenting our API endpoints as plugin scopes. The endpoint path usually looks like this:

v1/plugins/{plugin_id}/users.json
v1/stores/{store_id}/plugins/{plugin_id}/carts.json

While it makes sense for WP products, for general software, term product is more appropriate.

Therefore all our product-scoped endpoints can now be accessed with products instead of plugins. For examples:

v1/products/{product_id}/users.json
v1/stores/{store_id}/products/{product_id}/carts.json

For backward compatibility purposes, the plugins will keep on working. This is just a small change to make the terminology easier for SaaS makers.

Correcting public license activation endpoint

We realized we mistakenly published the license activation and deactivation endpoints under

v1/products/{product_id}/activate.json
/v1/products/{product_id}/deactivate.json

We fixed it by instead publishing under

v1/products/{product_id}/licenses/activate.json
v1/products/{product_id}/licenses/deactivate.json

The old endpoints are now deprecated and will be removed in the near future. We will also update our LiteSDK.

New public endpoint for license validation

To ease license validation for software makers, we have introduced a new endpoint.

/v1/products/{product_id}/installs/{install_id}/license.json (public)

It requires the following parameters:

uid – The UID of the install which was used during the license activation.
license_key – The license key that was used to activate the install.

On a GET request, the endpoint will give back an license entity with details like expiration date, whether it is canceled etc.

You can read the previous changelog to under more about the license activation system. A proper documentation will be published soon.

Consistent parameter naming

We realized the endpoints responsible for creating licenses were using a request parameter named is_blocking although the license entity itself has the property is_block_features. This property determines whether all “premium” features of a product should be blocked when the license expires.

To make it consistent we have introduced a backward-compatible change in the API endpoints to accept is_block_features. The following endpoints are affected

/v1/products/{product_id}/installs/{install_id}/plans/{plan_id}/pricing/{pricing_id}/licenses.json
/v1/products/{product_id}/plans/{plan_id}/pricing/{pricing_id}/licenses.json

The endpoints are particularly useful when creating licenses for migrated products or from SaaS.

EU Finland VAT updates

Being a Merchant of Record (MoR), we at Freemius handle VAT and Sales tax for you. This includes the complexities of handling the collection and submission of taxes and tracking and updating tax rate changes.

Finland has increased the VAT rate from 24% to 25.5% starting September 2024. In response, we have also updated our system. All existing subscriptions will also be updated accordingly.

The buyers can of course enter their VAT number to get an exemption.

You can read our blog to learn how Freemius handles taxes.

New Checkout Feature for SaaS – Readonly user mode + Bug fix

This week’s deployment brings enhancements to the Freemius Checkout.

Read-only user mode – aimed for SaaS integrations

This is yet another push to make our Freemius platform more friendly for SaaS integrations. For SaaS, we understand most solutions would have their own user system. When loading the Checkout you can already populate the fields with the following parameters.

user_firstname – The first name of the user.
user_lastname – The last name of the user.
user_email – The email address of the user.

Freemius Checkout with prefilled user data

However, the user could still change their information if they wanted to from the checkout. This could make it difficult for SaaS products to consume webhook events and find the right user.

To solve this, we have introduced a new parameter readonly_user.

Freemius checkout with readonly user data

When set to true the fields will not let the user edit the information anymore. It works for both JS integration as well as standalone mode (when the checkout is opened directly).

Bug fix in success dialog

We discovered that the ‘support’ email address was mistakenly shown as the sender in the thank you dialog after a purchase. Emails should be sent from the ‘system’ email you’ve configured. This bug has now been fixed.

You can configure the email addresses on the ‘Emails’ page of your product or store.

Miscellaneous Developer Dashboard enhancements and bug fixes

This week’s deployment comes with the following misc enhancements and bug fixes.

We resolved an issue where the payment refund form sometimes failed to honor the ‘Cancel subscription’ checkbox.
We enhanced overall responsiveness and optimized cross-platform font stacks across various UIs and pages.
For the affiliate system, we are now blocking the rejection of referrals already included in the payout calculation. We realized rejecting them after payout calculation is mostly a mistake. But if you have any reason to do it, please get in touch with our support.

New feature: Added authentication support for custom webhook events

We understand that custom webhook events are the cornerstone for integrating Freemius with any SaaS product. To make it even easier to consume webhooks sent from Freemius, we have introduced support for direct authentication using an HTTP signature.

From now on every webhook request that Freemius sends, will carry a HTTP_X_SIGNATURE header, which you can use to validate the request. Previously we’ve been asking to use the event_id and re-retrieve the event from Freemius API to consume it. But with this update, you can skip the extra step and after authentication, you can directly consume the webhook request.

Example usage

The HTTP_X_SIGNATURE header will have the sha256 of the request payload encrypted with the secret key of your product.

Go to the Settings page of the product from the Developer Dashboard to get the secret key. Once you have it, you have to calculate the hmac hash with the sha256 algorithm of the RAW HTTP payload using the secret key as the encryption key.

<?php
    // Retrieve the request's body payload.
    $input     = @file_get_contents("php://input");
    $hash      = hash_hmac('sha256', $input, '<PRODUCT_SECRET_KEY>');
    $signature = $_SERVER['HTTP_X_SIGNATURE'] ?? '';
 
    if ( ! hash_equals($hash, $signature))
    {
        // Invalid signature, don't expose any data to attackers.
        http_response_code(200);
        exit;
    }
 
    $event_json = json_decode($input);
    // Handle the event JSON as needed

The above shows how the hash_hmac can be used to calculate the sha256 of the request payload with your product’s secret key with PHP.

Please note that getting the raw body is important here, instead of decoding the JSON and then encoding again, to avoid issues with JSON stringification. Here’s another example of a nodejs server using express.

const crypto = require('crypto');
const express = require('express');
const bodyParser = require('body-parser');
 
const app = express();
 
app.post('/webhook', bodyParser.raw({ type: '*/*' }), (req, res) => {
    const input = req.body.toString('utf8');
    const secret = '<PRODUCT_SECRET_KEY>';
    const hash = crypto.createHmac('sha256', secret).update(input).digest('hex');
    const signature = req.headers['x-signature'] || '';
 
    if (hash !== signature) {
        // Invalid signature, don't expose any data to attackers.
        res.status(200).send();
        return;
    }
 
    const eventJson = JSON.parse(input);
    // Handle the event JSON as needed
});
 
app.listen(3000, () => {
    console.log('Server is listening on port 3000');
});

We hope you find this feature useful when integrating your product with Freemius. You can read here about all the events we have available. For any queries please feel free to head to our support.

Checkout phase2 final rollout with some bug fixes

Following our rollout schedule, we’ve made the new Checkout design the default in production. From today onwards the new checkout design will show up, regardless of the status of the CSS migration.

If you aren’t using custom CSS or have already migrated your custom CSS, then you are all set. Otherwise, we request you to do that as soon as possible. Please read our changelog and documentation for help with the CSS migration.

If for some reason you still want to use the legacy checkout, you can use the JavaScript parameter checkout_style: 'legacy'. But please note, you have until September 29th, 2024, after which the legacy Checkout will be completely removed.

Enabling the monthly switch by default

While introducing the upsell concept, we made the annual/monthly upsell switch hidden when the Checkout already loads in the “annual” billing cycle.

Following our maker’s feedback and discussing some cases, we understand it can be a bit confusing for some specific cases. Especially when:

The checkout is loaded from the WordPress SDK – Since users can miss the billing cycle when clicking some promotional notice coming from the plugin/theme itself.
The checkout is in license renewal/upgrade mode – A user may want to change the billing cycle from annual to monthly or vice-versa.

Hence for the two cases, we are now showing the switch by default. Additionally, you can always use the show_monthly_switch parameter and choose to show it all the time.

You can find more about all the new configuration options here.

Other bug fixes

Fixed the positioning of the exit intent modal.
Fixed refund policy UI showing up incorrectly in some edge cases.