Quickstart (Transaction API): Retrieve accounts

This quickstart verifies that your integration with the Transaction API is working.

The steps are:

1. Obtain an access token
2. Retrieve your accounts

Obtain an access token

Request an OAuth token from the Vitesse Identity service.

POST https://staging-identity.vitessepsp.com/connect/token
Content-Type: application/x-www-form-urlencoded

client_id=YOUR_CLIENT_ID&
client_secret=YOUR_CLIENT_SECRET&
grant_type=client_credentials&
scope=API

Example response

{
  "access_token": "eyJhbGciOi...",
  "token_type": "Bearer",
  "expires_in": 3600
  "scope": "API"
}

Retrieve your accounts

Retrieve the accounts available to your organisation.

GET https://staging-api.vitessepsp.com/api/accountBalances
Authorization: Bearer <access_token>

curl --request GET \
  --url https://staging-api.vitessepsp.com/api/accountBalances \
  --header "Authorization: Bearer <access_token>" \
  --header "Content-Type: application/json"

Example response

[
  {
    "AccountId": 339,
    "Name": "Claims Account USD",
    "Balance": 9998409.35,
    "Currency": "USD",
    "LastUpdatedOn": "2026-01-29T07:56:16.96Z"
  }
]

If the request succeeds, your Transaction API integration is working correctly.

If the request fails, check the following:

• The Authorization header contains a valid bearer token
• The Authorization header is formatted correctly: Authorization: Bearer <access_token>
• The token was issued for the correct environment (staging vs production)
• The request URL is correct for the environment
• The token includes the required scope (API)
• Vitesse has included your infrastructure on the allowlist

For common issues and troubleshooting guidance, see Troubleshooting payment requests.