Skip to main content

Sandbox Overview

Waffo Pancake provides a complete sandbox environment for development and testing. No real money moves. Everything works identically to production.

Safe

No real money moves.

Full Features

Everything works like production.

Test vs Production

Sandbox (Test)Production (Live)
TransactionsSimulatedReal charges
MoneyFakeReal funds
DataIsolatedProduction
WebhooksFully functionalFully functional
API BehaviorIdenticalIdentical

Switching Environments

In the Dashboard

Toggle Test/Live mode in the Dashboard header.

In API Calls

Use the X-Environment header:
Header ValueMode
X-Environment: testSandbox
X-Environment: prodProduction
Always verify you’re in the correct environment before sharing payment links or deploying.

API Keys

API Keys are created for a specific environment. When using API Key authentication, the environment is determined by the key — no X-Environment header needed.

Test Cards

Successful Payments

CardBrand
4242 4242 4242 4242Visa
5555 5555 5555 4444Mastercard
3782 822463 10005Amex

Declined Payments

CardError
4000 0000 0000 0002Declined
4000 0000 0000 9995Insufficient funds
4000 0000 0000 0069Expired card

3D Secure

CardBehavior
4000 0027 6000 3184Requires authentication
4000 0000 0000 3220Authentication fails
Any future expiry date and any 3-digit CVC will work with test cards.

Test Webhooks

Webhooks fire normally in the sandbox. To test:
  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 production

Test Subscriptions

Test the full subscription lifecycle:
  1. Create — Subscribe via test checkout
  2. Bill — Billing occurs on schedule
  3. Update — Change plans via Customer Portal or API
  4. Cancel — Test cancellation flow (takes effect at period end)

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

Going Live

When ready to go live, sync your products from test to production:
curl -X POST https://waffo-pancake-auth-service.vercel.app/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.

Go-Live Checklist

  • Complete end-to-end testing in sandbox
  • Test edge cases (declined cards, failures)
  • Verify webhook handling
  • Test checkout on mobile devices
  • Complete business details
  • Review product pricing
  • Sync products from test to production