Help Center/Plan Configurator & Compensation Models/How to create a product booking and confirm payment
Plan Configurator & Compensation Models•Last updated: 2026-10-20•4 min read

How to create a product booking and confirm payment

Create a tiered participation booking against a live plan and confirm its payment. Note the known defect described below: as written the "Confirm payment" prompt answer is sent under a field name the server does not read.

Have questions or need step-by-step guidance on this topic?

Ask AI Copilot

Step-by-Step Procedure

1

Open the bookings page

From the Plan Studio click "product bookings & service benefits". Read the note: participation amounts come only from the tier table, retail price is never used and no device is charged.

2

Fill "New booking"

Enter planId, clientId, memberDid and productSlug in the four boxes and click "Create". The booking appears in the table with its tier, participation amount and status PENDING_PAYMENT. Repeating the same clientId replays the first booking.

3

Click "Confirm payment"

For a PENDING_PAYMENT row the screen asks for "paymentRef (payment reference)" and sends the participation amount as the paid amount. The server requires the payment to equal the participation amount exactly.

4

Check the result

A confirmed booking shows CONFIRMED.

Expected Operational Outcome

The booking is listed as CONFIRMED with its payment reference, or you see the exact server error.

Troubleshooting & Failure Modes

Symptom: "A payment reference is required" even though you typed one
Likely Cause: Known defect in the screen: the prompt answer is stored under a lower-case key (paymentref) while the server reads paymentRef (bookings/page.tsx, line 36).
Resolution: Report it to engineering; until fixed this button cannot succeed from the screen.
Symptom: Error that the plan is not live or has no participation tiers
Likely Cause: The plan version is not ACTIVE or lacks tier configuration.
Resolution: Release a version that defines participationTiers and productTierMapping.
Symptom: Error AMOUNT_MISMATCH
Likely Cause: Paid amount differs from the participation amount.
Resolution: The screen sends the exact amount; check the booking table.

Was this guide helpful?

Help us refine our platform documentation