API Docs

{ "amount": 3073, "denomination": 100 }

{ "amount": 3073, "denomination": 100 }

sequenceDiagram
    participant P as Provider
    participant S as Game Server
    participant C as Web Client

    P ->>+ S: Send Session Init request
    S ->>- P: URL to application
    P ->>  C: Open URL in tab/iframe
    C ->>  S: Connect
    loop
        C ->>  S: Choose Machine
        C ->>+ S: Choose Amount
        S ->>- P: Send Update Balance request (withdraw)

        opt
            S ->>  P: Send Log Action request
        end

        C ->>+ S: Exit to lobby / Close tab / Go offline
        S ->>- P: Send Balance Update request (deposit)
    end
    Note over S: Session is closed

{
	"casino_id": "<identifier>", // required
	"game_id": "<game identifier>", // required
	"session": "<session identifier>", // required
	"user_id": "<user identifier>", // optional
	"currency": "USD", // required
	"locale": "en", // optional
	"geo": "", // optional
	"denomination": 1000,
	"balance": 17020,
	"return_url": "https://example.com", // optional
	"cashier_url": "https://example.com", // optional
	"sub_id": "<id1>,<id2>,<id3>", // optional
	"buffer": "<encoded internal state>", // optional
	"sign": "<payload signature, see below>" // required
}

{
	"casino_id": "<identifier>", // required
	"game_id": "<game identifier>", // required
	"session": "<session identifier>", // required
	"user_id": "<user identifier>", // optional
	"currency": "USD", // required
	"locale": "en", // optional
	"geo": "", // optional
	"denomination": 1000,
	"balance": 17020,
	"return_url": "https://example.com", // optional
	"cashier_url": "https://example.com", // optional
	"sub_id": "<id1>,<id2>,<id3>", // optional
	"buffer": "<encoded internal state>", // optional
	"sign": "<payload signature, see below>" // required
}

{
	"casino_id": "<identifier>",
	"sign": "<payload signature, see below>"
}

{
	"casino_id": "<identifier>",
	"sign": "<payload signature, see below>"
}

{
	"session": "<identifier>",
	"casino_id": "<identifier>",
	"sign": "<payload signature, see below>"
}

{
	"session": "<identifier>",
	"casino_id": "<identifier>",
	"sign": "<payload signature, see below>"
}

{
	"session": "<identifier>",
	"currency": "USD",
	"amount": 1332,
	"denomination": 100,
	"type": "win", // "win", "bet" or "refund"
	"transaction": "<tx identifier>",
	"betTransactionId": "<bet tx identifier>",
	"roundId": "<round number>",
	"sign": "string", // See Request signing
	"timestamp": 1644231487,
	"machine": "FFFF456789ABCDEF",
	"buffer": "<encoded internal state>" // optional
}

{
	"session": "<identifier>",
	"currency": "USD",
	"amount": 1332,
	"denomination": 100,
	"type": "win", // "win", "bet" or "refund"
	"transaction": "<tx identifier>",
	"betTransactionId": "<bet tx identifier>",
	"roundId": "<round number>",
	"sign": "string", // See Request signing
	"timestamp": 1644231487,
	"machine": "FFFF456789ABCDEF",
	"buffer": "<encoded internal state>" // optional
}

{
	"balance": 1332,
	"denomination": 100,
	"transaction": "<tx identifier>",
	"buffer": "<encoded internal state>" // optional
}

{
	"balance": 1332,
	"denomination": 100,
	"transaction": "<tx identifier>",
	"buffer": "<encoded internal state>" // optional
}

{
	"session": "<identifier>", // The identifier, sent by provider in init request
	"currency": "USD",
	"amount": 132,
	"denomination": 100,
	"type": "win", // "win", "bet" or "refund"
	"transaction": "<tx identifier>",
	"sign": "string", // See Request signing
	"timestamp": 1644231487,
	"buffer": "<encoded internal state>" // optional
}

{
	"session": "<identifier>", // The identifier, sent by provider in init request
	"currency": "USD",
	"amount": 132,
	"denomination": 100,
	"type": "win", // "win", "bet" or "refund"
	"transaction": "<tx identifier>",
	"sign": "string", // See Request signing
	"timestamp": 1644231487,
	"buffer": "<encoded internal state>" // optional
}

{
	"session": "<identifier>", // The identifier, sent by provider in init request
	"currency": "USD",
	"denomination": 100,
	"transaction": "<tx identifier>",
	"sign": "string", // See Request signing
	"timestamp": 1644231487,
	"buffer": "<encoded internal state>" // optional
}

{
	"session": "<identifier>", // The identifier, sent by provider in init request
	"currency": "USD",
	"denomination": 100,
	"transaction": "<tx identifier>",
	"sign": "string", // See Request signing
	"timestamp": 1644231487,
	"buffer": "<encoded internal state>" // optional
}

{
	"balance": 1332,
	"denomination": 100,
	"transaction": "<tx identifier>",
	"buffer": "<encoded internal state>" // optional
}

{
	"balance": 1332,
	"denomination": 100,
	"transaction": "<tx identifier>",
	"buffer": "<encoded internal state>" // optional
}

javascript

import { createHash } from 'node:crypto';

function encodeValueSorted(value) {
	if (value === null || typeof value !== 'object') {
		return JSON.stringify(value);
	}
	if (Array.isArray(value)) {
		return `[${value.map(encodeValueSorted).join(',')}]`;
	}
	const entries = Object.entries(value)
		.filter(([, val]) => val !== undefined)
		.sort(([key1], [key2]) => (key1 > key2 ? 1 : -1))
		.map(([key, val]) => `${JSON.stringify(key)}:${encodeValueSorted(val)}`);
	return `{${entries.join(',')}}`;
}

function getSignature(payload, key, algorithm) {
	const hashInput = `${encodeValueSorted(payload)}${key}`;
	const hash = createHash(algorithm);
	return hash.update(hashInput).digest('hex');
}

const key = '0d50d9b3-7d80-422a-a20d-ab4ca017737f';
const algorithm = 'sha256';

function signPayload(payload) {
	const sign = getSignature(payload, key, algorithm);

	return { ...payload, sign };
}

function checkPayload(payload) {
	const { sign, ...rest } = payload;
	return sign === getSignature(rest, key, algorithm);
}

import { createHash } from 'node:crypto';

function encodeValueSorted(value) {
	if (value === null || typeof value !== 'object') {
		return JSON.stringify(value);
	}
	if (Array.isArray(value)) {
		return `[${value.map(encodeValueSorted).join(',')}]`;
	}
	const entries = Object.entries(value)
		.filter(([, val]) => val !== undefined)
		.sort(([key1], [key2]) => (key1 > key2 ? 1 : -1))
		.map(([key, val]) => `${JSON.stringify(key)}:${encodeValueSorted(val)}`);
	return `{${entries.join(',')}}`;
}

function getSignature(payload, key, algorithm) {
	const hashInput = `${encodeValueSorted(payload)}${key}`;
	const hash = createHash(algorithm);
	return hash.update(hashInput).digest('hex');
}

const key = '0d50d9b3-7d80-422a-a20d-ab4ca017737f';
const algorithm = 'sha256';

function signPayload(payload) {
	const sign = getSignature(payload, key, algorithm);

	return { ...payload, sign };
}

function checkPayload(payload) {
	const { sign, ...rest } = payload;
	return sign === getSignature(rest, key, algorithm);
}

python

import json
import hashlib


def get_signature(payload, key, algorighm):
    hash_input = json.dumps(payload, sort_keys=True, separators=(",", ":"))
    hash_input += key
    hash = hashlib.new(algorighm, hash_input.encode())
    return hash.hexdigest()


key = "0d50d9b3-7d80-422a-a20d-ab4ca017737f"
algorithm = "sha256"


def sign_payload(payload):
    sign = get_signature(payload, key, algorithm)
    return {**payload, "sign": sign}


def check_payload(payload):
    payload = {**payload}
    expected = payload.pop("sign")
    actual = get_signature(payload, key, algorithm)
    return expected == actual

import json
import hashlib


def get_signature(payload, key, algorighm):
    hash_input = json.dumps(payload, sort_keys=True, separators=(",", ":"))
    hash_input += key
    hash = hashlib.new(algorighm, hash_input.encode())
    return hash.hexdigest()


key = "0d50d9b3-7d80-422a-a20d-ab4ca017737f"
algorithm = "sha256"


def sign_payload(payload):
    sign = get_signature(payload, key, algorithm)
    return {**payload, "sign": sign}


def check_payload(payload):
    payload = {**payload}
    expected = payload.pop("sign")
    actual = get_signature(payload, key, algorithm)
    return expected == actual

go

package signing

import (
	"crypto/sha256"
	"encoding/hex"
	"encoding/json"
	"errors"
	"hash"
)

type Signable interface {
	SetSign(sign string)
	ExtractSign() string
}

var hashCtors = map[string]func() hash.Hash{
	"sha256": sha256.New,
}

func getSignature(payload any, key string, algorithm string) (string, error) {
	createHash, ok := hashCtors[algorithm]
	if !ok {
		return "", errors.New("Unsupported hash algorithm")
	}
	var enc []byte
	var err error
	if enc, err = json.Marshal(payload); err != nil {
		return "", err
	}
	// Sort keys alphabetically by unmarshaling back into map and then marshallng the result from it
	pMap := make(map[string]any)
	if err = json.Unmarshal(enc, &pMap); err != nil {
		return "", err
	}
	if enc, err = json.Marshal(pMap); err != nil {
		return "", err
	}
	hash := createHash()
	if _, err = hash.Write(enc); err != nil {
		return "", err
	}
	if _, err = hash.Write([]byte(key)); err != nil {
		return "", err
	}
	sum := hash.Sum(nil)
	return hex.EncodeToString(sum), nil
}

var key = "0d50d9b3-7d80-422a-a20d-ab4ca017737f"
var algorithm = "sha256"

func SignPayload[T Signable](payload T) error {
	sign, err := getSignature(payload, key, algorithm)
	if err != nil {
		return err
	}
	payload.SetSign(sign)
	return nil
}

func CheckPayload[T Signable](payload T) (bool, error) {
	expected := payload.ExtractSign()
	actual, err := getSignature(payload, key, "sha256")
	if err != nil {
		return false, err
	}
	return expected == actual, nil
}

package signing

import (
	"crypto/sha256"
	"encoding/hex"
	"encoding/json"
	"errors"
	"hash"
)

type Signable interface {
	SetSign(sign string)
	ExtractSign() string
}

var hashCtors = map[string]func() hash.Hash{
	"sha256": sha256.New,
}

func getSignature(payload any, key string, algorithm string) (string, error) {
	createHash, ok := hashCtors[algorithm]
	if !ok {
		return "", errors.New("Unsupported hash algorithm")
	}
	var enc []byte
	var err error
	if enc, err = json.Marshal(payload); err != nil {
		return "", err
	}
	// Sort keys alphabetically by unmarshaling back into map and then marshallng the result from it
	pMap := make(map[string]any)
	if err = json.Unmarshal(enc, &pMap); err != nil {
		return "", err
	}
	if enc, err = json.Marshal(pMap); err != nil {
		return "", err
	}
	hash := createHash()
	if _, err = hash.Write(enc); err != nil {
		return "", err
	}
	if _, err = hash.Write([]byte(key)); err != nil {
		return "", err
	}
	sum := hash.Sum(nil)
	return hex.EncodeToString(sum), nil
}

var key = "0d50d9b3-7d80-422a-a20d-ab4ca017737f"
var algorithm = "sha256"

func SignPayload[T Signable](payload T) error {
	sign, err := getSignature(payload, key, algorithm)
	if err != nil {
		return err
	}
	payload.SetSign(sign)
	return nil
}

func CheckPayload[T Signable](payload T) (bool, error) {
	expected := payload.ExtractSign()
	actual, err := getSignature(payload, key, "sha256")
	if err != nil {
		return false, err
	}
	return expected == actual, nil
}

php

<?php
function is_json_array(array $arr): bool {
	if ($arr === []) {
		return true;
	}
	return array_keys($arr) === range(0, count($arr) - 1);
}

function encodeValueSorted($value): string {
	if (!is_array($value) && !is_object($value)) {
		return json_encode($value);
	}

	if (is_object($value)) {
		$value = (array)$value;
	}

	if (is_json_array($value)) {
		$encoded_elements = array_map('encodeValueSorted', $value);
		return '[' . implode(',', $encoded_elements) . ']';
	}

	$entries = [];
	foreach ($value as $key => $val) {
		$entries[(string)$key] = $val;
	}

	ksort($entries);

	$encoded_entries = [];
	foreach ($entries as $key => $val) {
		$encoded_key = json_encode((string)$key);
		$encoded_value = encodeValueSorted($val);
		$encoded_entries[] = $encoded_key . ':' . $encoded_value;
	}

	return '{' . implode(',', $encoded_entries) . '}';
}

function getSignature($payload, string $key, string $algorithm): string {
	$hashInput = encodeValueSorted($payload) . $key;

	return hash($algorithm, $hashInput);
}

const key = '0d50d9b3-7d80-422a-a20d-ab4ca017737f';
const algorithm = 'sha256';

function signPayload(array $payload): array {
	$sign = getSignature($payload, key, algorithm);

	return array_merge($payload, ['sign' => $sign]);
}

function checkPayload(array $payload): bool {
	$sign = $payload['sign'] ?? null;
	$rest = $payload;
	unset($rest['sign']);

	return $sign !== null && $sign === getSignature($rest, key, algorithm);
}
?>

<?php
function is_json_array(array $arr): bool {
	if ($arr === []) {
		return true;
	}
	return array_keys($arr) === range(0, count($arr) - 1);
}

function encodeValueSorted($value): string {
	if (!is_array($value) && !is_object($value)) {
		return json_encode($value);
	}

	if (is_object($value)) {
		$value = (array)$value;
	}

	if (is_json_array($value)) {
		$encoded_elements = array_map('encodeValueSorted', $value);
		return '[' . implode(',', $encoded_elements) . ']';
	}

	$entries = [];
	foreach ($value as $key => $val) {
		$entries[(string)$key] = $val;
	}

	ksort($entries);

	$encoded_entries = [];
	foreach ($entries as $key => $val) {
		$encoded_key = json_encode((string)$key);
		$encoded_value = encodeValueSorted($val);
		$encoded_entries[] = $encoded_key . ':' . $encoded_value;
	}

	return '{' . implode(',', $encoded_entries) . '}';
}

function getSignature($payload, string $key, string $algorithm): string {
	$hashInput = encodeValueSorted($payload) . $key;

	return hash($algorithm, $hashInput);
}

const key = '0d50d9b3-7d80-422a-a20d-ab4ca017737f';
const algorithm = 'sha256';

function signPayload(array $payload): array {
	$sign = getSignature($payload, key, algorithm);

	return array_merge($payload, ['sign' => $sign]);
}

function checkPayload(array $payload): bool {
	$sign = $payload['sign'] ?? null;
	$rest = $payload;
	unset($rest['sign']);

	return $sign !== null && $sign === getSignature($rest, key, algorithm);
}
?>