Paywall

The Younium Paywall lets you sell subscriptions directly from your website through a secure, hosted checkout.

For your customers: They visit your site, select a subscription plan, choose billing terms, and pay with their credit card. All renewals are charged automatically to the same card. An Invoice will be sent to the customer.
For you as a Younium customer: The Paywall is hosted by Younium but fully configurable in your tenant. You decide which products and plans to expose, then place a JavaScript snippet on your website to display the checkout. Every purchase flows directly into Younium, where accounts, orders, and invoices are created and managed alongside your other subscriptions.

This makes it simple to offer self-service sign-up while keeping all subscription data centralized in Younium.

Getting Started with Younium Paywall

Before launching your first Paywall, make sure the essentials are in place:

Enable the permissions

Go to Settings > Admin > Roles > Paywall and assign the right access.
- View Paywall – allows users to see the setup.
- Edit Paywall – required to create or change a Paywall.
To build a Paywall, a user must have both permissions.
Connect Stripe

Younium uses Stripe to handle credit card payments and recurring charges. Make sure Stripe is connected to your tenant by following our Stripe setup guide.
Order settings

The Paywall inherits your tenant’s default order settings:
- Term type: If your default is Termed, all orders will be termed. If Evergreen, all orders will be evergreen.
- Effective start date: Recommended setting is On activation date. This makes the order start date equal to the purchase date.
- Order discount - Needs to be set to YES
Invoice settings

Orders must have a default Invoice template. Go to: Settings> Orders> Order Settings > Order default templates > Invoice template must be selected.

Once a paywall transaction is complete Younium will use the configured email settings to send out a email with a invoice based on the template added above. This requires the customer to run Accounts receiveble in Younium.

Products

The supported product type is Multiple Charge Plans:
- The charge plans related to the product are what your customers see on the Paywall.
- One product per Paywall is supported. To sell multiple products, create multiple Paywalls.
- Supported charge models:
  - Flat
- Each Paywall supports multiple currencies. Add the desired currencies to each charge plan on the product. If not all charge plans have the same currencies set up the currencies will not be displayed.
Custom fields

You can expose custom fields in the Paywall. They can be created on the Account (data saved on the account) or Order (data saved on the order).
- Supported field types: Text, Integer, Boolean
- Tip: If data is not saved, check that the field type is set correctly.
VAT - The paywall will apply tax to the purchased based on the default tax template added to Younium. To set for what countries to charge tax or not go to Settings > Accounts Receivable > Tax template and make sure that the marked countries are correct.

Setup Your Younium Paywall

Navigate to Sales > Paywall and click + Create Paywall. Configure the following:

Name – Internal name of your Paywall.
Annual discount percentage – Younium Paywall supports monthly and annual pricing. Use this setting to offer a discount for annual subscriptions.
- Example: Monthly price = €100 → Annual price = €1200. With 10% discount: €1080.
Product configuration – Select the product you want to expose. Only multiple charge plans are supported.
Customize charge plan – Add custom text for:
- Plan subtitle
- Feature header section
- Plan features
  
  A live preview shows how each plan will look.
Appearance & styling – Adapt the Paywall to match your brand guidelines.
Legal
- Legal: A user cannot complete a Paywall transaction without accepting your terms and conditions. Paste the link in the provided field.
Whitelisting: Younium must whitelist your domain. Enter the domains where you will host the Paywall. Multiple domains are supported, separated by commas (e.g., https://www.yourdomain.com,
Security Summary for Paywall Integration
At Younium, we’ve designed the Paywall component with security as a first-class priority to ensure it’s safe to include on any website:

Secure Script Delivery – All assets are served exclusively over HTTPS from our controlled CDN. We support Subresource Integrity (SRI) and strong cache policies to guard against tampering.
Token Safety – The token used in the <paywall-main> element is scoped and validated by our backend.
Strict Isolation – The component is built as a web component with its own encapsulated DOM, preventing leakage or unwanted access to your site’s scripts, cookies, or global variables.
CSP Compatibility – We follow best practices for Content Security Policy (CSP) and do not require unsafe inline scripts or eval. This makes the integration work under strict CSP settings.
Minimal Data Handling – The component only transmits the data strictly necessary for paywall logic. No unnecessary PII, analytics, or tracking is included.
Audited Build Pipeline – Our build and deployment process is protected, versioned, and monitored to prevent supply-chain tampering.
Fail-Safe Behavior – If the script cannot load for any reason, the <paywall-main> tag gracefully degrades with optional fallback content you can define.

User experience

Add a thank-you message after purchase.
Optionally redirect users after a completed transaction. Paste the redirect URL in the field. The redirect occurs within 5 seconds.

Edit Checkout Fields

You can configure which checkout fields are optional.

Mandatory account checkout fields:

Street
Company legal name
Zip
Billing email
City
State
Country

Get JavaScript Snippet

When finished, click Get JavaScript Code. Two options are available:

Integration code – Recommended option.
CMS compatible – Use only if your CMS does not allow custom HTML elements

Install the JavaScript snippet on your website.

Webhooks and API

The paywall will provide the Younium customers with a way to sell their subscriptions online without any manual work.

This means that you also need to create the customer in your SaaS solution. To support this process, you are going to create a new webhook that sends the following events.

Create Paywall webhook

Go to Settings > Webhooks > ADD NEW

Paste the URL that is going to receive the webhook
Add a description of the webhook
Add the following events to your webhook:
- Account - AccountCreated
- Invoice - InvoicePosted
- Payment - PaymentPosted
- Subscription - SubscriptionActivated

In the request body of the webhook, we have added two new values:

SubscriptionSource
CorrelationID

Example request body:

{
  "Token": "971074c2-6cd9-415e-944b-2d4ebf12c2ab",
  "EventId": "evt_2rF0Qk1gjtSJOCpTfwNAPZaIe",
  "EventType": "PaymentPosted",
  "Source": "Paywall",
  "CorrelationId": "b6136873-9911-40b1-8483-abaf76aa86f4",
  "LegalEntityName": "Paywall demo",
  "LegalEntityId": "1c17f206-b731-4c40-860a-08ddfc2bb516",
  "Timestamp": "2025-10-03T13:55:16.8036319Z",
  "Data": {
    "Id": "80726664-6483-4f47-47d2-08de027f0094",
    "PaymentDate": "2025-10-03T13:55:07.2721106",
    "PostedDate": "2025-10-03T13:55:07.4647925",
    "reference": "I-000016",
    "description": "Default",
    "Amount": {
      "Amount": 12.5,
      "CurrencyCode": "EUR",
      "CurrencyConversionDate": "2025-10-03T13:55:07.2721106",
      "BaseCurrencyAmount": 12.5,

The response above is the data from one of the events in the webhook. As you can see, there is:

Webhook Source:Paywall
CorrecationID: b6136873-9911-40b1-8483-abaf76aa86f4

This means that webhooks with including this informations are orders that are made from the paywall. If it is a order that is made another way they will not have this data provided.

The purpose of these values is for your service to know that a specific order is purchased via the Paywall so you can fetch the data needed through our API. Fore more information on the Younium API check the Development Portal.l