Core Concepts
Two-Host Environment Model
Cresora uses two API hosts — sandbox for testing and production for live traffic — selected by your API key prefix.
Cresora uses a two-host environment model: sandbox (sandbox-api.cresoracommerce.com/api/v1) for testing and certification; production (api.cresoracommerce.com/api/v1) for live traffic.
How it works
| Key prefix | Mode | Effect |
|---|---|---|
csk_test_ | Sandbox | No real money movement; responses include "test_mode": true |
csk_live_ | Production | Real transactions; never includes test_mode |
| Mode | Host |
|---|---|
| Sandbox (test/certification) | https://sandbox-api.cresoracommerce.com/api/v1 |
| Production (live) | https://api.cresoracommerce.com/api/v1 |
🔁Mode
Use csk_test_ keys with the sandbox host and csk_live_ keys with the production host. Test keys must be used with the sandbox host.
Implications
- Two hosts, two keys. Point your integration at the sandbox host with your test key, then switch both host and key prefix when going to production.
- Webhook events are mode-scoped. Test-mode webhooks are delivered to your test endpoint registration; live-mode webhooks to your live endpoint. Register separate endpoints in the Partner Portal for each.
- Merchant IDs are mode-specific. A
mrch_created in test mode cannot be used with a live key.
Capabilities endpoint
Some features are behind feature flags. Use the capabilities endpoint to discover which features your key has access to:
GET https://sandbox-api.cresoracommerce.com/api/v1/capabilities
Authorization: Bearer csk_test_xxxxxxxxxxxxSee Capabilities endpoint → for the response shape.