Authentication

All API requests must include a JWT signed with the shared secret provided by Splash.

Algorithm: HS256

The token is generated by the operator and sent with every request. Jackpot Product Integration Ver…

Header

X-Third-Party-Authorization: Bearer <jwt-token>

Required Claims

Claim Description
client Splash provided client identifier
sub Unique user identifier
iat Token issued time (Unix timestamp)
exp Token expiration time (Unix timestamp)
currency User 3 letter currency e.g. EUR

Optional Claims

Claim Description
username User display name
identifier Secondary user identifier
language User language (ISO-639-1 recommended)
country Country (ISO-3166-1 alpha-2 recommended)
region Region (ISO-3166-2 recommended)
brand Brand identifier
tags User tags

Example Payload

{
  "client":"abc123",
  "sub":"def456",
  "iat":1697202711,
  "exp":1697206311,
  "currency":"EUR",
  "username":"big-punter",
  "identifier":"another-identifier",
  "language":"fr",
  "country":"CA",
  "region":"QC",
  "brand":"subbrand1",
  "tags": ["VIP"]
}

Implementation

Contribute Endpoint

Registers a jackpot contribution for a user spin.