Recurring Billing: Setting up Products and Prices

Paddle structures payments using Products and Prices. To build a SaaS subscription business model, you must define these catalog items.

1. Catalog Objects Structure

graph TD
    A[Product: Developer Platform] --> B[Price 1: Basic Plan $15/month]
    A --> C[Price 2: Premium Plan $40/month]
    A --> D[Price 3: Enterprise Plan $350/year]

2. Defining Catalog Items in Dashboard

1. Navigate to your Paddle Sandbox Dashboard -> Catalog -> Products.
2. Click Create Product. Enter the name (for example, Pro SaaS Tier) and description.
3. Click Add Price.
   • Set the type to Recurring.
   • Define the interval cycle (monthly, yearly).
   • Specify pricing currencies (for example, USD 29.00 or EUR 27.00).
4. Save the product catalog details.

3. Retrieve Catalog Codes

Once created, copy the unique identifiers to map them in your frontend plans page:

• Product ID: Unique string starting with pro_....
• Price ID: Unique string starting with pri_....

// Config mapping for pricing cards UI
export const pricingPlans = [
  {
    name: "Starter",
    priceId: "pri_01hsabcd1234567890starter",
    amount: "$15/mo",
  },
  {
    name: "Enterprise",
    priceId: "pri_01hsabcd1234567890enterprise",
    amount: "$120/mo",
  },
];