Kernlift

Waffo

Accept payments through Waffo, a merchant of record that collects and remits sales tax.

  • Checkout Waffo hosted checkout, priced from your plan with tax included
  • Subscriptions Monthly and yearly, settled on the first payment
  • Portal No
  • Refunds In the Waffo dashboard only
  • Promotion codes Yes

Waffo is the merchant of record: it sells to the buyer and handles sales tax. Checkout needs products that already exist in Waffo, but you create only three, shared by every plan. The price of each session comes from the plan.

Before you begin

A public HTTPS site, an active plan on /admin/plans (see Manage pricing plans), and a Waffo merchant account with a store. Work in the Test environment until the whole flow works.

Expected result — a test purchase settled by a signed order.completed or subscription.activated webhook.

Set up Waffo

Create the API key

In the Waffo dashboard open API & Development → API Keys and click Create API Key with the Test environment. Download the private key at once; it is not shown again. The key's environment decides test or live mode. Record your merchant ID (MER_…) as well.

Create the products

Create one one-time product, one monthly subscription product and one yearly subscription product, and copy their IDs. Each checkout overrides the price, so the product prices do not matter.

Register the webhook

Under Settings → Webhooks, add an HTTP webhook in test mode with the URL https://<your-domain>/api/billing/webhook/waffo. Subscribe to order.completed and subscription.activated.

Copy the webhook public key

On the same page copy the Webhook Public Key for the Test environment. Test and production use different keys.

Provider documentation · Authentication · Create a checkout session · Webhooks

Configure the application

Open /admin/config/payment in the Kernlift admin console. Select Waffo. Enter your public Success URL and Cancel URL, and leave API base URL at https://api.waffo.ai.

Value from providerAdmin field
Merchant ID (MER_…)Merchant ID (MER_...)
The tax category of what you sell: saas, digital_goods, software, ebook, online_course, consulting or professional_serviceTax category (saas, digital_goods, software...); blank keeps saas
The three product IDsOne-time product ID, Monthly subscription product ID, Yearly subscription product ID
The downloaded API private keyMerchant private key
The Webhook Public Key of the same environmentWebhook public key

Enable the provider and click Save provider. The card shows Ready once the merchant ID, private key and at least one product ID are saved, and Webhook ready once the webhook public key is saved. To let buyers enter a code, turn on Allow promotion codes at checkout; create the codes in Waffo.

A plan needs its product

A one-time plan needs the one-time product, and a monthly or yearly plan the subscription product of its interval. Without it, checkout is refused. A subscription plan that renews on another interval cannot be sold through Waffo.
Kernlift settings for Waffo

Verify

  1. Sign in as an ordinary user, open /pricing and buy a plan. Expected: you are sent to the Waffo checkout, showing the plan's price.
  2. Pay with Waffo's test payment details. Expected: you return through /api/billing/callback/waffo, which looks up the order's payments in Waffo before marking it paid.
  3. Open /admin/billing-webhooks. Expected: an order.completed (one-time) or subscription.activated (subscription) event with a valid signature.
  4. Open /admin/orders. Expected: the order is paid, and its invoice shows the amount charged, lower than the plan price if a promotion code was used.

Go live

  1. Create a production API key and production products, and add the webhook again with test mode off.
  2. Save the production merchant private key, product IDs and the production webhook public key. A test key cannot verify production events.
  3. Make one real purchase and refund it in the Waffo dashboard.

Troubleshooting

Webhooks fail the signature check

The saved webhook public key belongs to the other environment, or is missing. Waffo signs t in milliseconds and retries reuse it, so events up to 45 minutes old are accepted; older ones are refused. A proxy that rewrites the request body also breaks the signature.

Checkout fails with "No Waffo subscription product is configured"

The plan is a subscription whose interval has no product ID. Save the monthly or yearly product ID, or change the plan's interval.

A refund or renewal does not appear on the order

Refunds and subscription changes are made in the Waffo dashboard. Their events, such as refund.succeeded and subscription.renewed, are stored as ignored: they do not change the local order, create a new order or grant the plan's credits again.

Next steps