Environments
The Truss API provides different environments to support development, testing, and production use cases.
Available Environments
| Environment | Base API URL | Base Auth URL |
|---|---|---|
| Sandbox | https://foundation.sandbox.trusspayments.com |
https://auth.foundation.sandbox.trusspayments.com |
| Production | https://foundation.trusspayments.com |
https://auth.foundation.trusspayments.com |
Use the Base API URL for all resource endpoints (payment intents, company, etc.). Use the Base Auth URL for token exchange and refresh endpoints (/v1/oauth2/token).
Sandbox Environment
The sandbox environment is designed for integration testing before going live.
Base API URL: https://foundation.sandbox.trusspayments.com
Base Auth URL: https://auth.foundation.sandbox.trusspayments.com
Characteristics:
- Test credentials and test data only
- No real payment processing
- Rate limits may differ from production (see Rate Limiting)
The sandbox should not be used for integrations in production environments.
Production Environment
The production environment is for live transactions and real-world usage.
Base API URL: https://foundation.trusspayments.com
Base Auth URL: https://auth.foundation.trusspayments.com
Characteristics:
- Real payment processing
- Production-grade rate limits and SLA
Authentication
Each environment requires separate API credentials. Credentials from one environment cannot be used in another environment. Token exchange and refresh requests must be sent to the environment's Auth URL, while all other API requests use the API URL. See authentication requirements for a guide on how to authenticate.
