Getting Started
Sandbox Setup
Configure your sandbox environment for development and testing.
The Cresora sandbox is a full-featured replica of production with no real money movement. Every API endpoint, webhook event, and portal action available in production is available in the sandbox.
Environment details
| Property | Value |
|---|---|
| API host | https://api.sandbox.cresoracommerce.ai/api/v1 |
| Credentials | Your sandbox key (csk_{prefix}_{secret}) |
| Settlement | None; no real money moves |
🔁Mode
Sandbox is a distinct host from production. You reach it by calling api.sandbox.cresoracommerce.ai with your sandbox credentials; the host selects the environment, not the key. There is no test_mode field on responses.
Creating a test merchant
Before you can process payments, you need a merchant under your partner account. In the Partner Portal:
- Go to Payments → Merchants → New Merchant
- Complete the application wizard (required: business name, contact email, MCC; plus principals, funding and processing details)
- Submit it for review — approval is a Cresora review action, not automatic, in the sandbox too. Track progress on the merchant's page; the state reference explains each stage
The returned merchant_id is a UUID (e.g. 0190a1b2-c3d4-7e5f-8901-23456789abcd) and is used in all payment API calls.
Next
With a test merchant ID, proceed to First API call →