PayIn

Overview

The PayIn endpoint is used to register a user's bet when the Game Provider sends a request from their system to the Aggregator. Essentially, this method “accepts” the bet by deducting or locking the corresponding funds from a user’s account before the game outcome is determined. It represents the initial phase of the bet lifecycle, ensuring that the wagering amount is properly recorded and linked through a unique identifier.

The PayIn method allows to:

Accept the Bet: It registers the bet by deducting or earmarking the wagered amount from the user's account as the first step of processing a bet.

Link Cash Flow Transactions: The bet identifier provided by the Game Provider (via the field betId) is essential, as it unites all subsequent cash flow transactions (like payouts or refunds) to a single bet. This ensures consistency and traceability across the betting lifecycle.

Update User Balance: After the bet is accepted, the user’s account balance is updated accordingly, which is reflected in the response.

CAUTION

If taxes apply, the betAmount parameter value must be the gross amount (before tax deduction).

Security and Authentication

The PayIn endpoint, like other API requests within this integration, requires strict authentication to ensure that only authorized parties can interact with it. This is achieved through the use of mandatory HTTP headers. Please see the required headers below in the Header Params section.

📌

Signature of the request shall be calculated using HMAC-SHA256 algorithm and sent in "X-Sign" header of the request.
Please see How to calculate the X-Sign value.

Path Parameters

Parameter	Type	Required	Description
sessionId	string	Yes	Game Session id.

curl --location --globoff '/v1/sessions/{{sessionId}}/bets/pay-in' \ --header 'X-Counterparty-Id: 933a215f-a9e6-4f88-9d91-52a87cd50499' \ --header 'X-Timestamp: 1719766120806' \ --header 'X-Request-Id: 5a0679b6e5fa48f6892c777b0fa92392' \ --header 'X-Sign: c4d62f77cdfaadb6690b3bcbe5a0ca9ef1e5bf41d746d361a1269558eeb7ccd1' \ --header 'Content-Type: application/json' \ --data '{ "betId": "95", "sessionId": "37", "gameRoundId": "77", "betAmount": 781.89, "taxAmount": 153.39, "maxPossibleWinAmount": 753.39, "maxPossibleWinTaxAmount": 794.69 }'

Overview#

Security and Authentication#

Path Parameters#

Request

Responses

Overview

Security and Authentication

Path Parameters