Products

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, JPY, HKD — CNY for one-time products only. Several currencies can apply at once; see Multi-Currency Pricing
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	$10,000.00
EUR	€1.00	€9,400.00
GBP	£1.00	£8,150.00
JPY	JP¥100	JP¥1,600,000
CNY	CN¥1.00	CN¥1,000.00
HKD	HK$8.00	HK$77,600.00

CNY prices one-time products only — subscription products cannot be priced in CNY. CNY-priced orders are payable by WeChat Pay only, and each buyer can pay you at most ¥1,000 via WeChat per calendar month. See Method and currency support.

Multi-Currency Pricing

Price the same product deliberately per market — $9.99, JP¥980, CN¥68 — instead of pushing one base price through a live rate into awkward numbers.


Where	Product create / edit form
Per currency	Own price and tax category
Validation	Each currency checked against its own price limits
At checkout	Display currency resolved deterministically; amounts localized

Reference prices

Adding a currency prefills the amount by converting your existing price at the current rate.

That figure is a reference price, not a commitment. Round it to whatever suits the market — the rate hint stays beside the currency while more than one is configured.

Yen disambiguation

CN¥ for Chinese yuan, JP¥ for Japanese yen — applied everywhere, so the two are never confused at checkout.

Currencies are priced independently rather than converted, so a subscription cannot change plan across currencies. See Changing Plans.

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

Create a base one-time product in Waffo Pancake
Calculate the final amount on your server
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.

Trial Periods

Let customers try subscription products before they commit. A trial can be free or carry a price — see Paid Trials.

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

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, 45-minute default TTL configurable up to 7 days)

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 from checkout; existing subscriptions continue. Products cannot be deleted — completed orders, invoices and settlement records reference them. Renaming or repricing adds a new version and keeps the product ID.

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”

Pricing

Round numbers ( $29, not$ 28.73)
Research competitors

Images

400x400px minimum
PNG or JPG
Under 5MB

Get Started

Features

Merchant

Store

Merchant of Record

Product = Billing Object

Core Models

One-Time

Subscription

Dynamic Pricing

Create a Product

Product Fields

Required

Optional

Price Limits

Multi-Currency Pricing

Reference prices

Yen disambiguation

Dynamic Pricing

How It Works

Trial Periods

Trial Abuse Protection

Billing Intervals

Product Purchase Links

Product Status

Active

Inactive

Updating Products

Environment Sync

Best Practices

​Product = Billing Object

​Core Models

One-Time

Subscription

Dynamic Pricing

​Create a Product

​Product Fields

​Required

​Optional

​Price Limits

​Multi-Currency Pricing

​Reference prices

​Yen disambiguation

​Dynamic Pricing

​How It Works

​Trial Periods

​Trial Abuse Protection

​Billing Intervals

​Product Purchase Links

​Product Status

Active

Inactive

​Updating Products

​Environment Sync

​Best Practices

Product = Billing Object

Core Models

Create a Product

Product Fields

Required

Optional

Price Limits

Multi-Currency Pricing

Reference prices

Yen disambiguation

Dynamic Pricing

How It Works

Trial Periods

Trial Abuse Protection

Billing Intervals

Product Purchase Links

Product Status

Updating Products

Environment Sync

Best Practices