Products

One-time or recurring. Your revenue, your rules.

Product = Billing Object

In Waffo Pancake, a product is the object used for checkout, taxation, and reporting. It is the commercial offer you charge for, not just a storefront card.

For professional use, think of products as billing entities:

• a fixed-price offer
• a subscription plan
• or a base product used with dynamic pricing at checkout

---

Core Models

One-Time

Customer pays once for a predefined offer.

• Digital downloads
• Lifetime licenses
• Templates, courses, assets

Subscription

Customer is billed on a recurring schedule.

• SaaS plans
• Memberships
• Service retainers

Dynamic Pricing

Amount is calculated at checkout time.

• Usage overage
• Credit top-ups
• Negotiated quotes

---

Create a Product

Dashboard —> Products —> Create Product

{
  "storeId": "your-store-uuid",
  "name": "Pro Plan",
  "prices": {
    "USD": { "amount": "29.00", "taxIncluded": false, "taxCategory": "saas" }
  }
}

Done. You get a permanent purchase link for fixed-price selling, or a reusable billing object for programmatic checkout.

---

Product Fields

Required

Field	What It Is
Name	What customers see
Price	How much you charge
Currency	USD, EUR, GBP, CNY, JPY, HKD, etc.
Type	One-time or Subscription
Tax Category	SaaS, Digital Goods, Software, etc.

Optional

Field	Default	Purpose
Description	—	Markdown. Sell your product.
Image	—	400x400px recommended
Redirect URL	—	Where the customer lands after checkout. Used for both successful and failed payments — only one URL is configurable.

Price Limits

Each currency has a minimum and maximum price you can set on a product. Values outside this range are rejected when you save the product.

Currency	Minimum	Maximum
USD	$1.00	$7,500.00
EUR	€1.00	€7,400.00
GBP	£1.00	£6,400.00
JPY	¥100	¥1,250,000
HKD	HK$8.00	HK$61,000.00

CNY is available for display in your dashboard analytics, but cannot currently be used as a product pricing currency.

---

Dynamic Pricing

Dynamic pricing is the right model when the final amount is not known until runtime.

Examples:

• usage-based overage billing
• prepaid credit packs with variable size
• contract-specific quotes
• temporary discounts calculated on your server

How It Works

1. Create a base one-time product in Waffo Pancake
2. Calculate the final amount on your server
3. Pass priceSnapshot when creating the checkout session

const session = await client.checkout.createSession({
  storeId: "store_id",
  productId: "usage-overage-product-id",
  productType: "onetime",
  currency: "USD",
  priceSnapshot: {
    amount: calculatedAmount,
    taxIncluded: false,
    taxCategory: "saas",
  },
});

priceSnapshot overrides the stored product price for that checkout session. Use it only from your server, never from untrusted client code.

If the amount is event-based, keep it as a one-time charge even if the customer is already on a subscription.

---

Free Trials

Let customers try subscription products before they buy.

Trial Abuse Protection

Waffo Pancake automatically tracks consumer trial history at the platform level. When a consumer starts a new subscription, the platform calculates the maximum available trial days based on their history — preventing repeated trial abuse without any effort from the merchant.

Merchants can also pass requested_trial_days via the API to shorten or skip the trial for specific customers.

Effective trial abuse prevention requires buyerIdentity. Use authenticated checkout to ensure each buyer can only claim one trial per product.

---

Billing Intervals

Interval	When	Best For
Weekly	Every 7 days	High-usage products
Monthly	Every month	Standard SaaS
Quarterly	Every 3 months	B2B software
Yearly	Every 12 months	Committed customers

Annual plans with 15-20% discount = lower churn + better cash flow.

---

Product Purchase Links

Every product gets a permanent purchase link that never expires:

https://checkout.waffo.ai/{store-slug}/{product-slug}

Test mode:

https://checkout.waffo.ai/{store-slug}/{product-slug}/test

Add to your website:

• Website button
• Twitter bio
• Email signature
• Discord server

Key benefits:

• Link is permanent — it stays the same even when you update product details
• No session or token management needed
• A checkout session is created automatically when the customer opens the link

Getting your link:

• Dashboard: Click “Copy Link” on any product
• API: For advanced use cases, create a Checkout Session via API with custom parameters (dynamic link, 7-day TTL)

Test vs Live:

• Toggle Test Mode in Dashboard header to preview with test links
• Test links use the /test suffix

---

Product Status

Active

Live. Customers can buy.

Inactive

Hidden. Existing subscriptions continue.

---

Updating Products

Products use immutable versioning:

Updates create new versions. Existing subscriptions keep their original version.

Field	Impact
Name/Description	Creates new version
Image	Creates new version
Price	New purchases only
Interval	Cannot change after creation

Environment Sync

Publish product versions from test to production:

POST /v1/actions/onetime-product/publish-product
{
  "id": "product-id"
}

Publishing is one-way (test → prod) and only needed for the first publish.

---

Best Practices

Naming

Include billing period:

• “Pro Plan - Monthly”
• “Pro Plan - Annual (Save 20%)”

Pricing

• Round numbers ($29, not$28.73)
• Annual discount (15-20%)
• Research competitors

Images

• 400x400px minimum
• PNG or JPG
• Under 2MB