Documentation
Learn how to integrate Salable into your application, manage subscriptions, and build sophisticated pricing models.
Salable Quick Start Guide
Get your first subscription up and running in around ten minutes. This guide walks you through setting up a payment integration, 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.
Getting Started with Salable
This guide will walk you through everything you need to know to get your subscription billing up and running. In less than 30 minutes, you'll have a complete pricing structure ready to accept payments.
Core Concepts
This reference covers the core terminology in Salable. From products and plans to entitlements and grantee groups, each concept is explained to help you understand how the pieces fit together and get up and running quickly.
Products & Pricing
Salable gives you complete control over your pricing model. Design products with any combination of flat-rate, per-seat, metered, and Tiered pricing across multiple currencies. This guide walks you through products, plans, and line items so you can set up once and ship immediately.
Understanding Entitlements
Every SaaS app faces the challenge of keeping feature access synchronised with billing. Entitlements put you in control of which features each plan unlocks, while Salable takes care of the Subscription from purchase to cancellation.
Grantees & Groups
Manage subscriptions for teams, not just individuals. The Grantee and Group system controls who has access, handles seat limits, and keeps everything in sync as teams grow and change. In this guide we cover how to manage team access in your application.
Subscriptions & Billing
Salable manages the full subscription lifecycle, ensuring entitlements stay in sync as customers upgrade, downgrade, or cancel. This guide walks you through how subscriptions work and the control you have from checkout to cancellation.
Cart & Checkout
Carts support multi-Plan purchases on a single Subscription, enabling plugin and add-on pricing models without requiring signup. This guide covers the flow from Cart creation to completed checkout.
Metered Usage
Charge customers based on what they actually consume. Track API calls, storage, messages, or any measurable activity in your application. Salable calculates charges at the end of each billing cycle and adds them to the invoice automatically.
Dashboard & Admin
The dashboard is your control centre for configuring products, managing subscriptions, and handling customers. This guide walks through each section and how to use it.
Testing & Development
Test everything before processing real payments. Salable's Test Mode is a complete sandbox with its own Products, Subscriptions, API keys, and data. Develop features, test edge cases, and validate changes with full Stripe test card integration. No risk to production.
Caching Strategies for Entitlements
Speed up entitlement checks with caching. This guide covers strategies for Node.js and Next.js applications, balancing performance with data accuracy. When to cache, how to invalidate, and patterns that scale.
Webhooks
Set up webhook event notifications. Configure destinations, verify signatures, handle retries, and monitor delivery. All the tools you need to keep your application in sync with Salable.