Environments
The Truss API provides different environments to support development, testing, and production use cases.
Available Environments
| Environment | Base API URL | Base Auth URL |
|---|---|---|
| Development | https://api.foundation.dev.trusspayments.com |
https://auth.foundation.dev.trusspayments.com |
| Sandbox | https://api.foundation.sandbox.trusspayments.com |
https://auth.foundation.sandbox.trusspayments.com |
| Production | https://api.foundation.trusspayments.com |
https://auth.foundation.trusspayments.com |
Use the Base API URL for Foundation resource endpoints (payment intents, company, etc.). Use the Base Auth URL for token exchange and refresh endpoints (/v1/oauth2/token).
Corex Base URLs
Corex uses a separate API host from Foundation, with the /fdx/v6 base path:
| Environment | Corex Base URL | Base Auth URL |
|---|---|---|
| Development | https://api.dev.trusspayments.com/fdx/v6 |
https://auth.foundation.dev.trusspayments.com |
| Production | https://api.trusspayments.com/fdx/v6 |
https://auth.foundation.trusspayments.com |
Contact Truss to confirm Corex access and routing for your integration in each environment before making requests. Listing these URLs does not indicate that Corex is enabled for your application. Corex requires the accounts:read scope; use the matching environment's credentials and Auth URL from this table. See the Corex integration guide.
Development Environment
Development supports OAuth integration testing for both Foundation and Corex. Corex testing currently uses this environment.
Authorize users at https://app.dev.trusspayments.com/oauth/authorize, then exchange and refresh tokens at https://auth.foundation.dev.trusspayments.com/v1/oauth2/token. Use the development API URL for the API you are calling from the tables above.
Contact Truss for development access, OAuth credentials, and test account setup. Development is separate from sandbox: use development credentials and onboard users and companies at https://app.dev.trusspayments.com. See the OAuth Integration Guide for the full flow.
Sandbox Environment
The sandbox environment is designed for integration testing before going live.
Base API URL: https://api.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://api.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. Resource requests use the Base API URL for Foundation or the Corex Base URL for Corex. See authentication requirements for a guide on how to authenticate.
