Начисление выигрыша игроку
Общая информация
| Тип запроса | URL |
|---|---|
| POST | <server-partner>/win |
Метод позволяет совершить зачисление выигрыша игроку.
Примечание
Запрос выполняет провайдер.
Параметры
Запрос
Optional (необязательные) поля не учитываются при расчете hash.
Optional* поля учитываются в расчете hash только в том случае, если они переданы.
| Название | Тип | Описание | |
|---|---|---|---|
| amount | string | Cумма транзакции | |
| currency | string | Валюта, в которой будет осуществляться игра | |
| partnerId | bigint | Уникальный идентификатор партнера | |
| playerId | string | Уникальный идентификатор игрока в системе клиента | |
| gameId | bigint | Уникальный идентификатор игры | |
| roundId | bigint | Уникальный идентификатор раунда ставки | |
| betTransactionId | bigint | Уникальный идентификатор транзакции ставки в системе клиента | |
| transactionId | bigint | Уникальный идентификатор транзакции выигрыша провайдера | |
| sessionId | string | optional* | Уникальный идентификатор игровой сессии в системе клиента |
| hash | string | Подпись (sha256 от hash строки) | |
| finished | boolean | optional | Флаг, показывающий завершен ли раунд |
Если установлена настройка /bet/win на каждый фриспин:
| isFreespinWin | boolean | optional | Флаг, показывающий был ли раунд сыгран в рамках фриспин кампании |
| campaignExtId | string | optional | Уникальный идентификатор кампании фриспинов в системе клиента |
| leftSpins | bigint | optional | Количество доступных фриспин раундов после завершения текущего раунда |
| spinCount | bigint | optional | Общее количество фриспинов |
| currentSpins | bigint | optional | Количество уже отыгранных фриспинов |
Hash строка
"win" + amount + currency + partnerId + playerId + gameId + roundId + betTransactionId + transactionId + sessionId* + apiKey
Ответ
| Название | Тип | Описание |
|---|---|---|
| balance | string | Актуальный баланс игрока |
| transactionId | string | Уникальный идентификатор транзакции выигрыша в системе клиента |
Пример
Запрос
js
{
amount: '20.00',
currency: 'USD',
partnerId: 1,
playerId: '432',
gameId: 3,
roundId: 7665,
betTransactionId: 1333882827,
transactionId: 36,
sessionId: '123',
finished: true,
hash: 'd919a11d4cb1b0dc4cc0d5f880c6970fd160d434b3a779a66a9a7f6451d108fd'
}Ответ
js
{
status: 'success'
data: {
balance: '10123.63',
transactionId: '1333882829'
}
}Ошибки
Возможные сообщения ошибок:
| Сообщение | Описание |
|---|---|
| RequiredParamsNotFound | Некорректное количество параметров в запросе |
| InvalidParamType | Некорректный тип параметра |
| CurrencyNotFound | Валюта с таким кодом не найдена |
| IncorrectHash | Некорректно рассчитан hash |
| ServerError | Ошибка сервера |