Test Mode

Break things. Risk-free.

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 Mode	Live Mode
Transactions	Simulated	Real charges
Money	Fake	Real funds
Data	Isolated	Production
Webhooks	Fully functional	Fully functional
API Behavior	Identical	Identical

Switch modes: Dashboard header toggle or X-Environment header in API calls.

Header Value	Mode
X-Environment: test	Test Mode
X-Environment: prod	Live 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.

Environment	Purpose
Test	Development and testing
Production	Real payments

API Keys use key pair authentication, not prefixed secret keys. See Authentication for details.

---

Test Cards

Successful Payments

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

Declined Payments

Card	Type
4576 7500 0000 0220	Visa Credit
2226 9000 0000 0220	Mastercard Credit
4001 7000 0000 0220	Visa Debit
2226 9300 0000 0220	Mastercard 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 —> API & Development
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
• Add a payout account (Payout Accounts)
• Complete business details (Settings —> Business Details)
• Review product pricing
• Sync products from test to production using publish-product

Quickstart

Full going-live checklist.