Skip to main content
Stabyl exposes separate production and staging base URLs. API keys are environment-specific. Create staging API keys in the Stabyl staging app. Use those keys only with the staging API base URL. Production API access requires completed KYB and an explicit invitation from Stabyl. Staging access alone does not authorize production use. The invitation contains the instructions for provisioning production credentials.

​
Request Conventions

Use query strings for GET filters and JSON bodies for POST, PATCH, and DELETE operations that accept a body. Send all times in UTC. Treat amount fields as decimal strings.

​
Simulation

Simulation endpoints are non-production utilities. They can create test deposits, test withdrawal records, test KYB states, and test product update notifications outside production. They are useful for end-to-end testing when you need deterministic activity without moving real funds.
Simulation withdrawals are testing records only. Production Partner API withdrawals require an explicitly enabled key and signed quote or submit request.

​
Environment Checklist

  • Use a staging key with https://api-staging.stabyl.com/v1.
  • Complete KYB and receive an explicit invitation from Stabyl before production onboarding.
  • After invitation, use the provisioned production key only with https://api.stabyl.com/v1.
  • Do not route simulation calls from production code.
  • Keep separate storage for staging and production cursors, order IDs, transaction IDs, and saved recipients.
  • Verify base URL and key environment before investigating authentication or access failures.