Environments
Martis provides two isolated environments: Sandbox and Production. Each environment operates independently with separate API keys, data, and resources. This separation ensures testing and development activities never interfere with live financial operations.
Base URLs
All API requests must be sent to the appropriate base URL for the target environment.
| Environment | Base URL | Description |
|---|---|---|
| Sandbox | https://api-staging.martis.id | For testing and development |
| Production | https://api.martis.id | For live transactions |
API keys are environment-specific. A sandbox API key cannot authenticate requests to the production environment, and vice versa.
Sandbox
The sandbox environment is designed for integration development and testing. Transactions processed in sandbox mode do not involve real money or affect actual financial records.
Capabilities
- Simulated payment processing
- Test balance operations
- Payout flow validation
- Webhook event simulation
- Full API feature access
Use Cases
- Building and testing integrations
- Validating payment flows before launch
- Training and demonstrations
- Debugging and troubleshooting
Production
The production environment handles real transactions and live operations. All resources, payments, and events in production affect actual customers and financial records.
Capabilities
- Real payment processing
- Actual balance management
- Live payout operations
- Production webhook events
Requirements
- Completed account verification
- Production API key
- Verified bank account (for payouts)
Environment Isolation
Resources created in one environment are not accessible from the other. This includes:
- Payment charges
- Payouts and transfers
- Webhook destinations
- API keys
- Transaction history
When transitioning from sandbox to production, ensure the application is configured with production API keys and the production base URL. Test thoroughly in sandbox before processing live transactions.
Versioning
The Martis API uses URL path versioning. The current version is v1.
https://api-staging.martis.id/api/v1/payments/charges
All API endpoints include the version in the path. When new versions are released, existing integrations continue to function on their specified version. Migration guides will be provided for version upgrades.