Test mode (sandbox)

A qk_test_ key is a full sandbox. Test clients and routes are created and readable exactly like live ones, but test routes never reach caregivers and move no money. Objects carry "livemode": false.

Use POST /routes/{id}/simulate (test keys only) to drive a test route through its whole lifecycle — bid → accept → clock in/out → timesheet — so your webhook receiver gets real bid.*, visit.*, and timesheet.* events without a real caregiver.

Build and test everything on a qk_test_ key, then swap in a qk_live_ key for production. No code changes are needed — only the key.