Salable Quick Start Guide

Get your first subscription up and running in around ten minutes. This guide walks you through, creating a product, adding a plan, completing a checkout, and performing an entitlement check. All you need is a Salable account and a few minutes to see the full subscription flow in action.

Step 1: Create a Product

A Product on Salable contains your pricing models in plans and feature access in entitlements. Click on the Products tab on the sidebar to navigate to the Products page. Provide a name for your Product in the Product Name field (eg "My SaaS Product") and click the Create Product button.

Step 2: Create a Plan

Plans allow you to define a pricing model and any entitlements your users to be able to access once they have subscribed.

In the Products list view, click the Edit Product button (pencil icon) on your Product. Provide a name for your Plan (eg "Basic Plan") on the Plan Name field and click the Create Plan button.

Step 3: Create an Entitlement

Entitlements grant access to features (eg export_pdf, generate_images) in your Product. When a user subscribes to a Plan, they receive these Entitlements.

To create an Entitlement, locate the Select Entitlements form field. Enter entitlement_one for your Entitlement name and click the (+) button to create and add the Entitlement to your Plan.

Step 4: Create a Line Item

Line Items are the components that make up your Plan's pricing model. Each pricing type (eg Per seat) has its own structure. For this guide, we will create a Flat Rate Line Item that charges a fixed fee each billing cycle.

Quick start guides: Per seat, Metered, Flat rate. Hybrid pricing is the most powerful; it allows any combination of the other models onto a single subscription, giving you a mix of flat-rate base fees, per-seat scaling, and usage-based charges on a single plan.

Click the Add Line Item button to pull up the Line Item form.

Provide a name for your Line Item in the Line Item Name field (eg Monthly Subscription Fee). This is the name that will appear on Stripe invoices, so be sure to name your Line Items accordingly.

We will leave the Interval Type set to Recurring and the Price Type set to Flat Rate.

Next, we will set up a Price, set the Currency to USD, and set the Unit Amount to $4.99. We will leave Interval set to Month and Interval Count set to one.

Click the Save Plan button.

We have a Product, a Plan with an Entitlement and a flat rate Line Item. Now, let's purchase a Subscription.

Scroll below the Plan form and click "Checkout Plan".

Select USD for the currency, month for the interval, and set the interval count to 1.

You will see two fields: Owner and Grantee. The Owner is the user's organisation ID, if your app doesn't have organisations just use the user ID. The Grantee is the ID of the user that will receive access to features in your application. The Grantee system is flexible by design, this field could also be represented by or any other entity ID in your application such as a board ID or workspace ID. Read more about Access control.

Enter organisation_one_id for the Owner field and click the (+) button, then enter user_one_id for the Grantee field.

Click Quick Checkout; you will be redirected to the Stripe checkout page with your flat rate plan in.

Salable also supports Cart functionationality; this enables a customer to build up a cart of any plan from any product in your business, giving you no restriction on what you can sell to a customer in one checkout.

Step 6: Complete Stripe Checkout

On Stripe’s checkout page, enter the following test payment details:

  • Email Address someone@example.com
  • Card number: 4242 4242 4242 4242
  • Expiry: Any future date
  • CVC: Any 3 digits
  • Postal code/Zip code: Any code

Note The actual fields may vary depending on your region

Click Subscribe to complete the checkout.

Step 7: Verify Your Subscription

Salable redirects you to the Subscriptions page in the dashboard. You should see your newly created Subscription with the Active status.

If you click on the Subscription to view details, you will see:

  • The Owner
  • The associated Plan
  • A list of Invoices, including a draft of the next Invoice

Step 8: Check Entitlement Access

Perform an Entitlement Check with your Subscription and Grantee to confirm they have access to the Entitlement.

  • Navigate to the Entitlement Check tab
  • In the Grantee field, enter user_one_id
  • Click Check Grantee

You should see the following response:

{
    "type": "object",
    "data": {
        "entitlements": [
            {
                "value": "entitlement_one",
                "type": "entitlement",
                "expiryDate": "2026-01-02T17:28:41.000Z"
            }
        ],
        "signature": "3045022054188fb22b12a9e8565beda67a9859a7e3eb23e31f806a1dccf7b551267e46b9022100b29021c7b579e36a63d6b1b6c1e2be55c64a285a15223119ab1b17f88410047b"
    }
}

Your Grantee has access to the Entitlement you created earlier.

The entitlement check also offers an owner field. This is to scope the entitlement check for a grantee to a specific tenant like an organisation. Useful if your system allows users to belong to multiple organisations, as the user switches organisation their level of access updates automatically to the organisation they are currently acting as.

Conclusion

In this guide, you:

  • Created a Product
  • Created a Plan
  • Created an Entitlement
  • Created a flat rate Line Item with a price, currency, and billing interval
  • Purchased a Subscription
  • Performed an Entitlement Check on a Grantee

You are now familiar with the core concepts of Salable.

For more detail, review core concepts.