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