Setup, Authentication & Testing

Before sending Driver Events, your system must authenticate using Basic Auth with valid API credentials.

Step 1: Request API Credentials

To start integrating with the Driver Events API, contact your Suntransfers Supplier Manager or email us at [email protected] to request your API credentials.

Subject: Driver Events API - Credential Request

Once the credentials are ready, you'll receive:

• Username
• Password

Step 2: Authenticate Your Requests

All API requests must include the Authorization header using the Basic Auth scheme:

Authorization: Basic <base64(username:password)>

Username: your_username
Password: your_password

Authorization: Basic eW91cl9zdXBwbGllcl9jb2RlOnlvdXJfc2VjdXJlX3Bhc3N3b3Jk

The credentials must be Base64-encoded in the format username:password.

Step 3: Test in the Staging Environment

Before going live, test your integration in our staging environment.

Staging URL: Tracking - Staging

• The API structure and authentication method are the same as in production.
• Use the staging environment to test a complete transfer journey by sending events in sequence, following the Recommended Event Workflow.
• Once testing is complete, request your production credentials and production URL from your Suntransfers contact.

Important Security Notes

• Your username and password are confidential. Do not expose credentials in frontend applications.
• Invalid or missing credentials will return a 401 Unauthorized response.
• To reset or rotate your credentials, contact Suntransfers technical support.