Games Integration

Let's discover Integration process.

1. Document Overview

This document describes the system integration process that enables merchants to integrate with HyperionPlay Casino games platform. It contains a description of the integration process and the tasks involved.

2. Integration Overview

The HP Games Casino is a B2B system that allows online merchants to offer games to their clients through their existing systems. Games can be opened by calling our game launch URL and can be displayed in a popup or as part of the merchant site in an iframe. Merchant need to implement 8 methods for wallet integration: validateToken, getPlayerBalance, debit, credit, bulkCredit, cancelDebit, bulkCancelDebit, gameList.

3. Protocol

The integration uses Http's POST and GET communications based on JSON message type. The merchant must use HTTPS to communicate with our server but we need to configure it in advance. All the field types specified in this document refer to Java and Postgres field type definitions. In an integration not using Java and Postgres, we will need to map the field types across the two systems to ensure compatibility.

4. Hash Check

We are using HMAC SHA-256 to ensure the integrity and authenticity of each request by generating a secure hash. For every request, specific fields are selected and concatenated into a string in a defined order. This concatenated string is then combined with a secret key to generate the HMAC SHA-256 hash. The generated hash is compared with the hash sent in the request to verify that the data has not been altered and that it originates from a trusted source. Each request has a predefined list of fields, included in the hash generation process in a specific order, ensuring consistency and security across all requests.

Example: HMAC SHA256 Code Snippet