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.

​
Test Everything. Break Nothing.

Build and test your entire integration without real transactions. No real charges. No real payouts. Just safe experimentation.

Safe

No real money moves.

Full Features

Everything works like Live Mode.

​
Test vs Live

Test ModeLive Mode
TransactionsSimulatedReal charges
MoneyFakeReal funds
DataIsolatedProduction
WebhooksFully functionalFully functional
API BehaviorIdenticalIdentical
Switch modes: Dashboard header toggle or X-Environment header in API calls.
Header ValueMode
X-Environment: testTest Mode
X-Environment: prodLive Mode
Always verify you’re in the correct mode before sharing payment links.

​
API Keys by Environment

API Keys are created for a specific environment (test or production). When creating an API key in the Dashboard, you select which environment the key belongs to.
EnvironmentPurpose
TestDevelopment and testing
ProductionReal payments
API Keys use key pair authentication, not prefixed secret keys. See Authentication for details.

​
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 date. Any 3-digit CVC.

​
Test Payment Methods

​
Digital Wallets

Test Mode shows simulated UI:
  • Apple Pay — Safari/iOS
  • Google Pay — Chrome/Android

​
Test Webhooks

Webhooks fire normally in Test Mode. To test your webhook endpoints:
  1. Register your webhook endpoint in Dashboard —> Developers
  2. Switch to Test Mode
  3. Perform actions that trigger events (create orders, complete payments)
  4. Your endpoint receives webhook events just like in Live Mode

​
Test Subscriptions

Test the full lifecycle:
  1. Create — Subscribe via test checkout
  2. Bill — Billing occurs on schedule (use short intervals for faster testing)
  3. Update — Change plans via the Customer Portal or API
  4. Cancel — Test cancellation flow
  5. Expire — Verify expired subscription behavior

​
Test Data

​
Isolation

Test data is completely separate:
  • Test products don’t appear in Live Mode
  • Test customers are separate
  • Test transactions don’t affect live reports

​
Environment Sync

When ready to go live, sync your products from test to production: 
curl -X POST https://api.waffo.ai/v1/actions/onetime-product/publish-product \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY_TOKEN" \
  -d '{
    "id": "product-uuid"
  }'
The publish-product endpoint is a one-way operation from test to production. It does not require an X-Environment header.

​
Going Live Checklist

Before accepting real payments:
  • Complete end-to-end testing in test mode
  • Test edge cases (declined cards, failures)
  • Verify webhook handling
  • Test checkout on mobile devices
  • Connect bank account (Finance —> Payout Setup)
  • Complete business details (Settings —> Business Details)
  • Review product pricing
  • Sync products from test to production using publish-product

Quickstart

Full going-live checklist.