Fusion Payments is the fastest way to launch and scale subscription billing for your video service. Whether you're running a streaming platform, selling premium video courses, or launching a pay-per-view event, Fusion makes it easy to integrate secure, Stripe-powered payments — without writing custom billing logic or maintaining complex backend systems.

We’ve built Fusion to do the heavy lifting, so you can focus on what matters most: your content and your customers. With just a few lines of code, you can present pricing options to users, securely redirect them to a Stripe-hosted checkout page, and automatically grant access once payment is complete. No need to worry about PCI compliance, session management, or webhooks — Fusion handles it all for you.

Whether you're just getting started or scaling to thousands of subscribers, Fusion grows with you. Our API-first approach gives you the flexibility to design your own frontend while relying on our robust backend to manage sessions, pricing, and user access.

Guides

Step-by-step walkthroughs for setting up your first payment flow, integrating Stripe Checkout, handling success pages, and more.

API Reference

Complete technical documentation for Fusion’s endpoints, request/response formats, and authentication requirements.

Fusion Payments provides a complete toolkit to help you launch and manage paid subscription services with ease. Below is an overview of the platform's key features and what they enable you to do.

Authentication & Access Control

• JWT-Based Access All API calls are secured using JSON Web Tokens (JWT), allowing you to safely associate billing actions with your users.
• User-Scoped Operations Actions like creating checkout sessions or accessing billing portals are tied to authenticated users, ensuring secure and personalized payment flows.

Stripe-Powered Payments

• Hosted Checkout Sessions Create secure, Stripe-hosted checkout pages in seconds. No need to handle card details or PCI compliance — Stripe takes care of it.
• Customer Portal Support Let users manage their subscriptions, payment methods, and invoices via Stripe’s self-service billing portal.
• One-Time and Recurring Billing Support both subscription-based plans and one-time payments, depending on your business model.

Product & Pricing Management

• Dynamic Package Listing Use the API to fetch a list of active products and display them in your app — perfect for building pricing tables.
• Flexible Plan Configuration Plans can be created and managed in Stripe, then exposed through Fusion for seamless integration into your frontend.
• Multiple Currencies Prices are returned in structured formats, making it easy to display correct pricing for different regions.

Subscription Management

• Create Checkout Sessions Generate a checkout URL for any plan based on a user’s selection and redirect them to complete the purchase.
• Subscription Status Tracking Track which users are subscribed, when their plan renews, and if their payment was successful.
• Webhook-Ready Architecture Integrate with Stripe webhooks to handle events like successful payments, cancellations, and upgrades.

Invoicing & Payment History

• Invoice Access End users can view and download their billing history via the Stripe Customer Portal.
• Automated Receipts Stripe sends receipts and payment confirmations automatically, reducing support overhead.

Developer-Friendly Tools

• RESTful API Fusion’s API is clean, modern, and easy to use with any backend or frontend stack.
• Quickstart Guides Follow simple walkthroughs to implement billing, pricing tables, success pages, and more.
• Secure & Scalable Built on top of Stripe’s infrastructure and Fusion’s authentication system to handle scale and security from day one.

This section will explain the how to export transaction or customer data in Stripe.

Exporting Transaction Data

It is possible to export all/a subsection of Transaction Data from Stripe.

This would be useful for marketing to users and for data analysis of platform usage and patterns.

To export:

• Go to the Transactions area of Stripe
• Click Export
• You are then presented with the following screen:

On this screen you can amend the time period you would like to export transactions from.

Under Columns you can choose which datapoints to include. The default provides useful transaction information - the date, amount, currency, status and customer email.

By clicking on the dropdown, you can then choose to either export All columns, or select a custom range.

Some important columns here:

• Checkout Line Item Summary would include the subscription plan name

Click Export when you've selected the required columns.

The export will provide a download once complete - note that a large file size will take some time to complete. If you wish to leave the site, click the option to have the file sent by email.

Exporting Customer Data

To export:

• Go to the Customers area of Stripe
• Click Export
• You are then presented with the following screen:

As above, you can select a date range (recommend All if pulling a full list of customers) and see what the default columns will be.

The same Export process as above - if required to wait, you can choose to have the file sent via email.

To create a new PPV Package, you'll need to be logged into your Stripe Dashboard

In the Stripe Dashboard, navigate to the Product Catalogue.

This will list your created Subscription packages and Pay-Per-View packages. You can view All, Active and Archived passes. Archived passes are not available to be purchased by users.

Package creation

To create a new Subscription Package, click Create Product.

• Name will appear on the subscription page for users to understand what the package is called, i.e. Live Video Match Pass; Audio Match Pass; World Championship Event Pass.
• Description appears on the checkout page, so should communicate important policy information, i.e. “You will be charged £9.99 today. This package will expire at the end of its subscription. By clicking “Pay with Card,” you agree to our Terms and privacy policy. Your access to premium content starts immediately.”
• You can upload an image for use on the subscription page. Dimensions should be XxX.

Price entry - the below is for PPV passes only

• Select Recurring - we will change this later.
• Enter your desired value, currency; i.e. £9.99 GBP.

Additional Pricing Options

• Here you can add more currencies for purchase in the relevant markets. This allows you to set multiple, currency specific prices to better smooth your customer journey.
• Click Add a price by currency and select the currency you wish to set a price for.
• The price will automatically calculate from your price entered above, in this example £100 will translate to $134.07. These prices can be set manually for optimal user experience - in this case, we could set $130, $135 or $134.99, this is up to you.
• You can enter as many different currencies as required.
• Users in a territory where the currency is local, i.e. Euros in Germany, will see the Euro price. Users in territories with no specific currency price will see the default currency entered in the first currency box.

Geo-restricting PPV Subscription Packages

You can use the Metadata on a Subscription Packages to determine whether a country should be blocked/allowed from purchasing the package, similar to CloudPay.

Under More Options there is a Metadata section with empty boxes.

• The Key should be set to ‘geo-block’ to block the sale of the package, or ‘geo-allow’ to allow it.
• The Value box should contain the countries to be blocked/allowed using the Two-Letter Country Code.
• https://www.iban.com/country-codes - the column headed ‘Alpha-2 Code’ contains all codes.

Example below will only allow this package to be purchased in Great Britain (GB), Guernsey (GG), Gibraltar (GI), Jersey (JE), Isle of Man (IM) or Ireland (IE). Users in other countries would not see this package available to purchase.

Setting this to geo-block would ensure those countries can't purchase.

Time-limiting passes

Using metadata, it is possible to ensure that a user's pay-per-view access expires at the end of an event window.

For example, you wish to sell a pass that grants access to a single tournament that lasts 7 days. The on-sale date is 5 days before the tournament starts.

We would then set the duration to 12 days, to cover the 5 days that a user could purchase, plus 7 days of tournament.

Under More Options there is a Metadata section with empty boxes.

• The Key should be set to ‘duration_unit’ to specify the type of length - in the Value box, enter one of ‘days’, ‘weeks’ or ‘months’
• Add a new line by clicking ‘Add More’
• The Key should then be set to ‘duration_count’ to specify the duration - this is in number form.
• So for example, a pass lasting 12 days would look like the below.

Marketing Feature List

Under More Options you can add Marketing Features as a bullet-point list. This will populate on the subscription page and allows you to show information to users:

To complete the Package creation, click Add Product.

Reminder: Your subscription package will appear as Active immediately. To edit the details above, a package must be active.

Attaching an entitlement to a PPV package

PPV Packages need to have an entitlement attached to them. In Stripe, these are called Features. Features can only be added to recurring subscription packages, however there is a workaround for PPV packages below:

Feature creation

To create a Feature, go to the Product Catalogue and select Features. Here we can see a list of all features.

• Click Create Feature
• Give the Feature a Name - this is internal only and used for navigation, so naming this for the package/access level is recommended i.e. Video Match Pass 20/09/2025
• The Lookup Key can just be the same as the Name i.e. Video Match Pass 20/09/2025
• Click Create Feature
• Click to open the new feature you have created.

On the right hand side you will see a Feature ID i.e. feat_61T7tCaGoZ3GMbMe141D1XHGpSjWc43M - this replaces the CloudPay entitlements and cannot be edited.

• You will see a button Attach to Product in the top-right corner - click this
• A pop-up will appear. Search for the Product you want to attach the Feature to - in our example Video Match Pass 20/09/2025
• Select the Product to attach this Feature.
• Navigate to the Product again, and click on the Price set up above.
• Click Edit on this Price, and change it to a One-Off price and click Save.

Once attached, any customer who purchases the Product, is in effect purchasing the Feature/Entitlement.

To create a new Subscription Package, you'll need to be logged into your Stripe Dashboard

In the Stripe Dashboard, navigate to the Product Catalogue.

This will list your created Subscription packages and Pay-Per-View packages. You can view All, Active and Archived passes. Archived passes are not available to be purchased by users.

Package creation

To create a new Subscription Package, click Create Package.

• Name will appear on the subscription page for users to understand what the package is called, i.e. Annual Pass; Monthly Pass; World Championship Event Pass.
• Description appears on the checkout page, so should communicate important policy information, i.e. “You will be charged £49.99 today. This package will renew at the end of its subscription. By clicking “Pay with Card,” you agree to our Terms and privacy policy. Your access to premium content starts immediately.”
• You can upload an image for use on the subscription page. Dimensions should be XxX.

Price entry

• Recurring Prices are for repeating subscriptions - Weekly, Monthly, Annual, custom length.
• One-off Prices are for Pay-Per-View passes.
• Enter your desired value, currency and specify the recurring billing period. i.e. £100 GBP.

Additional Pricing Options

• Here you can add more currencies for purchase in the relevant markets. This allows you to set multiple, currency specific prices to better smooth your customer journey.
• Click Add a price by currency and select the currency you wish to set a price for.
• The price will automatically calculate from your price entered above, in this example £100 will translate to $134.07. These prices can be set manually for optimal user experience - in this case, we could set $130, $135 or $134.99, this is up to you.
• You can enter as many different currencies as required.
• Users in a territory where the currency is local, i.e. Euros in Germany, will see the Euro price. Users in territories with no specific currency price will see the default currency entered in the first currency box.

Geo-restricting Subscription Packages

You can use the Metadata on a Subscription Packages to determine whether a country should be blocked/allowed from purchasing the package, similar to CloudPay.

Under More Options there is a Metadata section with empty boxes.

• The Key should be set to ‘geo-block’ to block the sale of the package, or ‘geo-allow’ to allow it.
• The Value box should contain the countries to be blocked/allowed using the Two-Letter Country Code.
• https://www.iban.com/country-codes - the column headed ‘Alpha-2 Code’ contains all codes.

Example below will only allow this package to be purchased in Great Britain (GB), Guernsey (GG), Gibraltar (GI), Jersey (JE), Isle of Man (IM) or Ireland (IE). Users in other countries would not see this package available to purchase.

Setting this to geo-block would ensure those countries can't purchase.

Marketing Feature List

Under More Options you can add Marketing Features as a bullet-point list. This will populate on the subscription page and allows you to show information to users:

To complete the Package creation, click Add Product.

Reminder: Your subscription package will appear as Active immediately. To edit the details above, a package must be active.

Attaching an entitlement to a subscription package

Subscription Packages need to have an entitlement attached to them. In Stripe, these are called Features

Feature creation

To create a Feature, go to the Product Catalogue and select Features. Here we can see a list of all features.

• Click Create Feature
• Give the Feature a Name - this is internal only and used for navigation, so naming this for the package/access level is recommended i.e. Annual Pass
• The Lookup Key can just be the same as the Name i.e. Annual Pass
• Click Create Feature
• Click to open the new feature you have created.

• You will see a button Attach to Product in the top-right corner - click this
• A pop-up will appear. Search for the Product you want to attach the Feature to - in our example Annual Pass
• Select the Product to attach this Feature.

Once attached, any customer who purchases the Product, is in effect purchasing the Feature/Entitlement.

This section will explain the how to apply Stripe entitlements to video content in CloudMatrix.

How to create a Feature ID

Stripe uses Feature IDs instead of entitlement strings to grant users access to content where they have bought the relevant subscription.

To create a Feature ID, open Stripe and navigate to Products then Features.

Click Create Feature. The Feature Name can be entered as something for internal use to enable you to understand at a glance what this entitlement is for - for example, Season Pass.

The Lookup Key can be the same as the Feature Name and is not used externally.

Click Create Feature to finish the process.

Once created, you will notice it has been added to your list of Features. Clicking on the Feature will show the products it is associated with, and the Feature ID on the right hand side (appears as feat_92150713fnog26u for example)

Adding the Feature to a Product

We now need to add the Feature to a Product. When our users are purchasing a Product, the Feature ID is added to their account in the same way as a CloudPay entitlement was added to a user in the old checkout flow.

Click Features then select the Feature you wish to add.

Click Attach to Product then select the desired Product from the list.

A product with the correct Feature attached:

Adding a Feature ID to content in CloudMatrix

Feature IDs are the same as CloudPay entitlements and function in the same way.

Open your CloudMatrix environment and log in.

Navigate to the content you want to add the Feature ID to.

Click on the video content and locate the SysEntryEntitlements field.

Copy the Feature ID from your Stripe Feature, and paste it into the field and click Save.

Example of a Feature ID added correctly below:

In order for a customer to be able to purchase your subscription/PPV package, they must be Active

Navigate to the Product Catalogue - you will see you can view All, Active or Archived products.

Archived Products and not on-sale.

How to put a Package on-sale

• Find the Package in the list of ‘All ’
• If it is Archived, it will display a tag ‘Archived’ next to the title.
• To make a Package available for purchase, simply click the three-dot menu on the right hand side of that Package, and click Unarchive Product
• This will make the Package available for purchase instantly.

How to take a Package off sale

• Find the Package in the list of ‘Active ’
• To make a Package unavailable for purchase, simply click the three-dot menu on the right hand side of that Package, and click Archive Product
• This will make the Package unavailable for purchase instantly..

This section will explain the Customer profile page.

The image below shows a typical customer profile in Stripe:

• Subscriptions shows their history of recurring subsriptions.
• This will show what the Product is and whether this is Active, Cancelled or Inactive
• This will also show the billing frequency, their next invoice and their price.
• The subscription can be cancelled on the right hand side (see image below):

In the below image, you can see the Customer's transactions, and whether this was successful or unsuccessful. Hovering over the ‘unsuccessful’ flag will show the reason for the failure. i.e. insufficient funds, expired card.

The transaction can be refunded here too via the 3-dot button on the right hand side.

Below this we can also see the customer's saved payment method(s).

In the next section we can see the user's Entitlement section. These are the Features attached to the Package in section 1 of this guide.

In this case, the Annual Plan gives the entitlement paid.

This allows us to check if a user has the correct entitlement.

This section will explain the how to apply a Complimentary Subscription to a user in Stripe.

Creating a Subscription for a User

Sometimes you may want to give a customer free access to one of your products. You can do this in Stripe by creating a subscription and applying a 100% Off Coupon.

This can be used for staff/VIP access.

Log into your Stripe Dashboard and navigate to Subscriptions and click Create Subscription (found under Billing > Subscriptions)

Next, enter the Customer's email address.

Note: the Customer must already exist in Stripe - ask them to register if they haven't already.

Creating a 100% off Coupon

If you have already done this before, then skip this step.

Coupons are how Stripe provides Complimentary Access.

Navigate to Products then click Coupons and click Create Coupon.

A new window will open. Fill in the details:

• Name: 100% off
• Discount type: Percentage off
• Percentage discount: 100
• Duration: Forever (grants access until you cancel a user)
• Click Create Coupon at the bottom.

Return to the Subscriptions > Create Subscriptions page mentioned above.

Applying a Product to the Customer

In the Product box, select the Product that you want the Customer to receive.

Select the Product to apply, then click the Add Coupon button.

Select the Coupon created in the step above that grants 100% off the price.

Review the subscription details and Click Create Subscription.

The customer now has a free subscription to your product and will not be charged.

Once your Fusion Payments account is set up, you’re ready to start accepting payments using Stripe Checkout. Fusion Payments securely handles the Stripe session creation for you — all you need to do is call our API and redirect your customers to the provided URL.

 
window.location.href = response.checkout_url;

The Customer Portal functionality enables your users to manage their own billing, subscriptions, and payment methods — all through a secure, Stripe-hosted experience. With a single API call, you can generate a link that takes your authenticated customer directly to their Stripe billing portal.

This eliminates the need to build subscription management UI yourself, and ensures your billing processes are secure.

The List Products endpoint allows you to dynamically retrieve and display available pricing packages on your site or app. This is ideal for creating a pricing table that reflects the products you've configured in your Fusion dashboard — including product names, prices, and status.

By integrating this flow, you can present users with real-time subscription options and let them select a package before starting the checkout process.

Code Example

The following example demonstrates how to use the Fusion Payments API to display a list of active subscription products. It fetches product data from the List Products endpoint and renders each plan with its name, description, and formatted price. This lightweight, client-side implementation helps you quickly create a dynamic pricing table based on the products you've configured in your Fusion dashboard.

<body> 
  <h2>Choose a Plan</h2> 
  <div id="plans"></div> 
  <script>
    
    const token = "YOUR_API_KEY";
    
    fetch("/api/products", {
      headers: { X-API-Key: token },
    })
    .then((res) => res.json())
    .then((products) => {
      
       const plans = document.getElementById("plans");
       
       products
        .filter((p) => p.active)
        .forEach((p) => {
          const btn = `<button onclick="checkout('${p.id}')">Choose ${p.name} - {(p.price)}</button>`;
          plans.innerHTML += <p>${p.description}<br>${btn}</p>;
        });
      });

      function checkout(productId) {…}
  </script>
</body> 

Overview

If you are currently on our legacy CloudPay API, this guide outlines what is being replaced with the new Fusion API, which integrates directly with Stripe Checkout and Stripe Customer Portal. This migration greatly simplifies integration by reducing custom API endpoints and shifting more functionality into Stripe’s hosted flows.

🔧 Technical Differences at a Glance

✅ Key Takeaways

• Fusion offloads flows to Stripe, cutting down custom code.
• Hosted Stripe Checkout and Customer Portal now cover most user interactions.
• IAP require external configuration.
• JWT + API key auth replaces CloudPay sessions.

Do I still need to manage sessions?

No. Fusion does not use device locks or /sso/start. Authentication is handled by JWT expiry. Concurrency limit is set in your playback configuration by StreamAMG.

Where do I apply discount codes?

Fusion does not have a /discount API. Discounts are managed in Stripe as Coupons configured in your Stripe account.

How do customers update billing details?

Previously /billing-update was used. Now, redirect them to the Stripe-hosted Customer Portal, where they can update payment methods and billing info self-serve.

How do I prevent customers from repurchasing the same subscription?

Use Fusion’s /subscriptions endpoint to check entitlements before displaying purchase options.

How are transactions and receipts tracked?

Instead of /transaction, use the session_id from checkout success. Query the Checkout Session in Stripe, fusion subscribes to Stripe webhook events for payments, renewals, and failures.

What about mobile IAP flows?

CloudPay supported them via /verify. Fusion does not. Integrators must validate receipts directly with the App Store / Play Store APIs, requires a new integration.

Do we still control payment methods shown?

Yes. Stripe Checkout determines the payment methods available, which are configurable in your Stripe Dashboard with over 40+ localised payment methods now available.

Can we still show what active subscriptions a user has on our own webpage and not just in the stripe customer portal?

Yes, you can call the /subscriptions endpoint to understand what subscription a user has purchased.

Use this guide to set up your subscription plans and passes in just a few steps.

1. Create a Feature (Access Level)

A Feature is the type of access a product gives (e.g., Paid Access).

👉 In Stripe:

• Go to Product Catalogue → Features
• Click Create Feature → Name it (e.g., “Paid Access, premium, monthly,annual”) → Save

✅ Now you have a content access level ready to attach to products.

2. Create a Product

A Product is what your customer sees and buys (e.g., Monthly Pass, Yearly Pass).

👉 In Stripe:

• Go to Product Catalogue → All Products → Create Product
• Add Name, Description, and (optional) Image
• Add Marketing Features → highlights for customers (e.g., “Watch live matches”, “Exclusive replays/content”)
• Save

✅ Products are now displayed on your webs/app as purchasable packages via the fusion API.

3. Add Prices

A Price is how much and how often customers pay.

👉 In Stripe:

• Open your Product → go to Pricing → + Add Price
• Choose Recurring (e.g., monthly, yearly) or One-off (e.g., day pass, tournament ticket)
• Enter amount(s) and currency → Save

✅ You can add multiple prices or currencies to the same product.

4. Attach Features to Products

Now link the access level (Feature) to your Product.

👉 In Stripe:

• Go to Product Catalogue → Features
• Select your Feature → click Attach Product → pick your Product

✅ This connects your Product to the correct entitlement so buyers get access automatically.

5. (Optional) Geo Restriction

Want to sell only in certain countries? Add metadata to your Product or Price:

• geo-allow → list of countries where it’s available
• geo-block → list of countries where it’s blocked

API for managing monetization operations and proxying Stripe calls.

Authentication

This API uses two primary authentication methods:

• API Key - All calls must be made with your Fusion API Key in the X-API-KEY header
• JWT Token - All calls specific to a user e.g. checkout sessions and subscriptions must also contain a valid JWT token in the Authorization header in the format ‘Bearer TOKEN’. This token must contain the ‘sub’ claim which serves as the unique ID for the customer across the Fusion system.