Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.waffo.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Choose Your Starting Point

AI Integration

Fastest to shipBest for teams with an existing codebase that want Claude Code or another coding agent to plan the model, implement the integration, and drive validation.

API / SDK

Most controlBest when you need custom checkout flows, server-side orchestration, dynamic pricing, or tighter control over integration behavior.

Hosted Checkout

SimplestBest when you want to launch a payment link quickly first and deepen the integration later.

​
Understand the Product Model

In Waffo Pancake, a product is the billing object used for checkout and tax handling. It is not just a storefront card or SKU.
If you sellCreate in WaffoWhy
Fixed-price download, template, licenseOne-time productCustomer pays once for a predefined price
Monthly or annual planSubscription productCustomer is billed on a recurring schedule
Starter / Pro / Enterprise plansMultiple subscription productsEach plan option is its own billable product
Usage overage, credits top-up, negotiated quoteOne-time checkout with priceSnapshotThe final amount is calculated at checkout time, so pricing stays dynamic
If your business is subscription-based, you may still create one-time charges for setup fees, add-ons, overage billing, or credit packs. That is expected behavior.

​
Integrate with AI

​
The Simple Version

Tell your AI assistant: 
Read https://docs.waffo.ai/llms-full.txt, load the official Waffo Pancake skill from https://docs.waffo.ai/integrate/skill, and integrate Waffo Pancake payments into the current project.
That’s it. The skill file contains everything your AI needs — API endpoints, SDK patterns, webhook handling, and best practices.

​
The Full Version

You can also describe your stack for a tailored integration: 
Read https://docs.waffo.ai/llms-full.txt, load the official Waffo Pancake skill from https://docs.waffo.ai/integrate/skill, and use Waffo Pancake SDK to
integrate Waffo Pancake payments into the current project and run through
the full checkout flow:
1. Get Merchant ID from Dashboard → Merchant → Integration
2. Create an API Key from Dashboard → Merchant → Integration → API Keys
3. Use only `WAFFO_MERCHANT_ID` and `WAFFO_PRIVATE_KEY` as required env vars for the first working integration
4. Install @waffo/pancake-ts SDK
5. Create checkout and webhook endpoints
6. Test with card 4576750000000110
7. Verify webhook receives order.completed event
Use test environment. My stack: [your stack — e.g., "Next.js with TypeScript"]

AI Integration Guide

View the unified AI integration entry point for skill context, SDK patterns, code examples, catalog design, and dynamic pricing workflows.

​
Ship Revenue in 5 Minutes

No credit card required. No LLC needed. Just sign up and start selling.
Get Started Steps

​
1. Create Account

Visit Merchant Dashboard and sign up with Google, GitHub, or Magic Link.

Merchant Dashboard

Sign up with Google, GitHub, or Magic Link — no credit card required.
Three options:
  • Google OAuth — One click. Done.
  • GitHub OAuth — For developers. Quick and easy.
  • Magic Link — Email. Click link. In.

​
2. Create Store

First login triggers store setup:
FieldWhat It Does
Store NameYour brand name
No business registration required. Solo founders welcome.

​
3. Create Your First Product

Dashboard → Products → Create Product
Create Product Form
{
  "name": "Pro Monthly",
  "prices": {
    "USD": { "amount": "29.00", "taxIncluded": false, "taxCategory": "saas" }
  }
}
For subscriptions, also set billingPeriod (weekly, monthly, quarterly, yearly). If your merchant account has multiple stores, confirm which store this product should belong to before creating it. If you offer multiple plans such as Starter / Pro / Enterprise:
  • Create one subscription product per plan
  • Start by defining the pricing and billing period for each plan clearly
If you need dynamic pricing:
  • Create a base one-time product such as Usage Overage
  • Calculate the final amount on your server
  • Pass priceSnapshot when creating the checkout session
Think of the product catalog as your billing model: fixed-price products for standard offers, subscription products for recurring access, and priceSnapshot for runtime pricing.

​
4. Integrate Payments

Product created? You get a checkout link to add to your website: 
https://checkout.waffo.ai/{store-slug}/{product-slug}
Add it to your website’s product page. Done.
This link is permanent — it never expires and stays valid even when you update the product. Just click “Copy Link” in the Dashboard.

​
5. Get Paid

Customer pays → We handle taxes → You receive payout. Funds go directly to your bank account. No intermediary. No delays.
Finance Payout Setup

​
Test vs Live

Test Mode

  • No real charges
  • Safe to experiment
  • Separate test data

Live Mode

  • Real payments
  • Real payouts
  • Toggle when ready
Switch in Dashboard header. Toggle via X-Environment header in API. Always test first.

​
Test Cards

​
Successful Payments

CardType
4576 7500 0000 0110Visa Credit
2226 9000 0000 0110Mastercard Credit
4001 7000 0000 0110Visa Debit
2226 9300 0000 0110Mastercard Debit

​
Declined Payments

CardType
4576 7500 0000 0220Visa Credit
2226 9000 0000 0220Mastercard Credit
4001 7000 0000 0220Visa Debit
2226 9300 0000 0220Mastercard Debit
Any future expiry. Any CVC.

​
Going Live Checklist

Before flipping to Live Mode:
  • Test checkout flow end-to-end
  • Verify webhook endpoints (if using)
  • Add bank account for payouts (Finance → Payout Setup)
  • Complete business details (Settings → Business Details)
  • Review product pricing
  • Sync products from test to production

​
What’s Next?

Products

Pricing models. Trials. Intervals.

Subscriptions

Recurring billing. Dunning. Lifecycle.

Checkout

Your brand. Your colors. Our infra.

Integrations

API keys. Webhooks. Your backend.

​
Need Help?

Join Discord

Community support. Fast answers.