Plandalf
Browse Product guides

Products

Products describe what the customer is buying. Prices describe how they pay.

Create a product from your checkout

Start with a saved checkout. In its editor:

  1. Open Products → Create a new product.
  2. Enter Product name and a unique Lookup key. The lookup key is the stable identifier used in code and API requests. The image is optional.
  3. Click Create product. The Add a price dialog opens.
  4. Give the price a name and a unique lookup key. For this example, keep List Price, choose One time, and enter 50.00 USD.
  5. Leave Price active on and click Create price.
  6. Wait for the product to appear under Primary item. Confirm the order summary shows the intended amount and quantity.

Use distinct names such as Standard USD 50 and Early bird USD 25 so you can recognise the correct price later. This example uses one-time prices; recurring and other pricing models have additional settings.

Add another price for the same item

  1. Under the existing checkout item, click Add a price.
  2. Select the same product and click Next.
  3. On Pricing, click Create new price. Enter its name, unique lookup key, amount and currency, then click Create price.
  4. Back in Select product and prices, confirm both prices appear under Your selected prices show here. Click Save.
  5. Wait for All changes saved, then reload. Both prices should remain under the same checkout item. In this example, the original Standard USD 50 price remains marked Default.
Checkout editor with Standard USD 50 and Early bird USD 25 attached to one required item, and the default order total of 50 dollars.

Real local setup, 2 October 2026. Both prices persisted after reload. Stripe is still unconnected, so this screen proves catalog setup only.

  1. The original price remains Default.
  2. A second price for the same item.
  3. Add a price within this item.

Add a price adds a pricing option within the item. Add another product creates another checkout item. Creating two prices alone does not schedule a price change; configure a promo’s tier prices for that.

Verify payment readiness

Catalog setup can be completed before connecting Stripe. If the checkout shows Connect Stripe to take payments or Payment Setup Required, finish the payment-provider setup before attempting a purchase.

For a test purchase, verify the actual sandbox connection, selected price, currency and billing period. A saved product, an editor total, or a rendered checkout does not establish a successful charge. Follow the checkout testing steps and reconcile the result with the provider and Plandalf invoice.

Why catalog context matters

Checkout sessions and invoices can carry product and price context into:

  • customer records
  • invoice line items
  • webhooks
  • automations
  • CRM and email integrations
  • tax and accounting-adjacent workflows

API route

Protected API clients can create products and prices through the v1 catalog endpoints.

POST /api/v1/products
Authorization: Bearer <api_key>
Content-Type: application/json

See catalog API for endpoint notes.

Feature detail