Grosso
⌘K

Docs · Get started

Test mode

A full copy of the line that never moves money. Same API, same events, same signatures — separate data.

01 — Keys

Two prefixes, two worlds

The key decides the mode. Objects created with one are invisible to the other.

Test

gk_test_51Hc…2f9a

Simulated payers, Stripe test mode, no payouts. Free, forever.

Live

gk_live_51Hc…2f9a

Real payers and real money. Requires a verified account and a payee with Stripe onboarding done.

02 — Same

What’s the same

  • Endpoints, request bodies, response shapes and error codes
  • Event types, grosso-signature and the retry schedule
  • Idempotency, expiry and refund-approval rules

03 — Different

What’s different

  • Payments use Stripe test cards and test Apple Pay — no funds move
  • No payouts and no risk review on test payees
  • livemode is false on every object and event

04 — Go live

Going live checklist