Sandbox basics

A real, stateful test world — not a mock.

The sandbox is a full copy of the merchant experience running on test data. Payments settle, invoices are issued, disputes open and close, payouts pay out — all with fake money, on a real ledger.

What is isolated

  • Its own test merchants, one per environment
  • Its own credentials (test client id / secret, spat_test_… tokens)
  • Its own webhook endpoints and delivery logs
  • Its own rate-limit counters

Nothing in the sandbox can read or write live data, and no email is ever sent to a real customer.

Instant verification

Sandbox payout onboarding completes immediately: no documents, no bank details, no real identity. Bank management and live-access UI stay hidden until you switch to live mode.

Seeding

Seed data fills an environment with a plausible merchant: products, prices, customers, a handful of settled payments and one open dispute. Wipe data clears objects but keeps the environment and its installs.

Resetting

Resetting an environment clears data, installs and webhook logs and re-issues the test merchant. Use it when a broken test state is faster to throw away than to repair.