Single-Host Environment Model
Cresora uses one API host for all traffic. Your API key prefix selects whether requests run in test or live mode.
Cresora uses a single-host environment model: there is one API base URL for all traffic. Your csk_test_ or csk_live_ key prefix determines whether the request runs in test or live mode — the host is always the same.
How it works
| Key prefix | Mode | Effect |
|---|---|---|
csk_test_ | Test | Cresora routes internally to sandbox processor rails. No real money movement. Responses include "test_mode": true. |
csk_live_ | Live | Cresora routes internally to production rails. Real transactions. test_mode is never present. |
Single API host for all environments:
https://api.cresoracommerce.com/api/v1You do not need different base URLs for test vs. live. Swap only the API key prefix and Cresora handles the routing internally. This simplifies configuration — one base URL in your integration, two keys (one per environment).
Implications
- One base URL, two keys. Your integration code is identical for test and production. The only thing that changes is the
csk_test_→csk_live_key swap. - 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_ID created with a test key cannot be used with a live key and vice versa.
Capabilities endpoint
Some features are behind feature flags. Use the capabilities endpoint to discover which features your key has access to:
GET https://api.cresoracommerce.com/api/v1/capabilities
Authorization: Bearer csk_test_xxxxxxxxxxxxSee Capabilities → for the response shape.