Интеграция с серверной частью

Transfer Wallet API введение

примечание

Партнер - сторона, интегрирующая игры.

Бренд - вебсайт казино партнера на котором пользователи играют в игры и делают ставки.

Провайдер - сторона, предоставляющая игры (Aviatrix).

В данной секции описаны методы, которые уже реализованы на стороне провайдера. Они могут быть вызваны партнером для запуска игры и для менеджмента внутриигрового баланса игрока на стороне провайдера.

важно

Не совместимо с Seamless Wallet API

Transfer Wallet API методы

к сведению

Все POST запросы содержат HTTP заголовок X-Auth-Signature, необходимый для подтверждения подлинности хоста. Эта операция позволяет отказаться от IP whitelist при интеграции, так как последний лишает возможности провайдера оперативно масштабироваться (горизонтально), не предупреждая при этом бренд.

подсказка

Базовый url можно получить по запросу у интеграционного менеджера.

/transferwallet/launchGame

Предоставление URL для встраивания в iFrame.

Пример запроса

POST /transferwallet/launchGame HTTP/1.1
Content-Type: application/json
Accept: application/json
X-Auth-Signature: <signature>

{
  "cid": "someplatform",
  "playerId": "john",
  "productId": "nft-aviatrix",
  "currency": "EUR",
  "lang": "en",
  "lobbyUrl": "https://someplatform.com",
  "isDemo": false
}

Параметр	Описание	Тип	Требования	Пояснение
cid	уникальный идентификатор платформы	string	обязательный	идентификатор одинаковый для всех окружений в рамках платформы
productId	идентификатор игры	string	обязательный	примеры идентификаторов: `nft-aviatrix`, `second-chance`, `aviatrix-fruits`. С полным списком можно ознакомиться на странице всех продуктов
playerId	идентификатор пользователя	string	обязательный	уникальный в рамках платформы
currency	валюта ставки	string	обязательный	3-5 символов. Валюта, в которой пользователь будет делать ставки
lang	код языка	string	опциональный	код формата ISO 639-1. Значение по умолчанию: `en`
lobbyUrl	lobby url	string	опциональный	нужен для редиректов на домашнюю страницу платформы
isDemo	isDemo= значения true или false	string	опциональный	нужен для включения демо-режима игры. Обязательный параметр для запуска демо-режима

Пример ответа от сервера

HTTP/1.1 200 OK

{
  "url": "https://domain.com?cid=someplatform&productId=nft-aviatrix&sessionToken=abcd1234&lang=en&lobbyUrl=https://someplatform.com"
}

Параметр	Описание	Тип	Требования	Пояснение
url	url для встраивания в iFrame	string	обязательный	url для front-end интеграции

/transferwallet/checkTx

Предоставление информации о транзакции.

Пример запроса

POST /transferwallet/checkTx HTTP/1.1
Content-Type: application/json
Accept: application/json
X-Auth-Signature: <signature>

{
  "cid": "someplatform",
  "txId": "4df40f77-2b38-43f4-b264-1d850f5a6715"
}

Параметр	Описание	Тип	Требования	Пояснение
cid	уникальный идентификатор платформы	string	обязательный	идентификатор одинаковый для всех окружений в рамках платформы
txId	идентификатор транзакции	string	обязательный	идентификатор транзакции передаваемый в /transferwallet/deposit или /transferwallet/withdrawal

Пример ответа от сервера

HTTP/1.1 200 OK
{
  "txId": "4df40f77-2b38-43f4-b264-1d850f5a6715",
  "playerId": "john",
  "type": "deposit",
  "currency": "EUR",
  "amount": 1234,
  "createdAt": "2020-12-03T12:15:30.000Z",
  "postTransactionBalance": 5678
}

Параметр	Описание	Тип	Требования	Пояснение
txId	идентификатор транзакции	string	обязательный	идентификатор транзакции передаваемый в /transferwallet/deposit или /transferwallet/withdrawal
playerId	идентификатор пользователя	string	обязательный	уникальный в рамках платформы
type	тип транзакции	string	обязательный	deposit или withdrawal
currency	валюта транзакции	string	обязательный	3-5 символов
amount	сумма транзакции	integer	обязательный	сумма транзакции в формате minor currency unit (учитывая центы, т.е. число умноженное на 100)
createdAt	время транзакции	timestamp	обязательный	format: yyyy-MM-dd’T’HH:mm:ss.SSSZ
postTransactionBalance	баланс после транзакции	integer	обязательный	баланс пользователя после транзакции в формате minor currency unit (учитывая центы, т.е. число, умноженное на 100)

/transferwallet/getBalance

Предоставление баланса пользователя по всем валютам.

Пример запроса

POST /transferwallet/getBalance HTTP/1.1
Content-Type: application/json
Accept: application/json
X-Auth-Signature: <signature>

{
  "cid": "someplatform",
  "playerId": "john"
}

Параметр	Описание	Тип	Требования	Пояснение
cid	уникальный идентификатор платформы	string	обязательный	идентификатор одинаковый для всех окружений в рамках платформы
playerId	идентификатор пользователя	string	обязательный	уникальный в рамках платформы

Пример ответа от сервера

HTTP/1.1 200 OK
{
  "EUR": 1234,
  "USD": 5678
}

Параметр	Описание	Тип	Требования	Пояснение
Код Валюты	баланс пользователя в указанной валюте	integer	обязательный	ISO-4217-3 format.

/transferwallet/getHistory

Предоставление информации о deposit и withdrawal транзакциях. Транзакции отсортированы по времени создания от поздних к ранним.

Пример запроса

POST /transferwallet/getHistory HTTP/1.1
Content-Type: application/json
Accept: application/json
X-Auth-Signature: <signature>

{
  "cid": "someplatform",
  "playerId": "john",
  "limit": 20,
  "from": "2020-12-03T12:15:30.000Z"
}

Параметр	Описание	Тип	Требования	Пояснение
cid	уникальный идентификатор платформы	string	обязательный	идентификатор одинаковый для всех окружений в рамках платформы
playerId	идентификатор пользователя	string	обязательный	уникальный в рамках платформы
limit	количество транзакций в ответе	string	опциональный	0 < limit < 100, если не указан, то применяется значение по умолчанию (20 транзакций)
from	максимальное значение createdAt в ответе	timestamp	опциональный	format: yyyy-MM-dd’T’HH:mm:ss.SSSZ

Пример ответа от сервера

HTTP/1.1 200 OK
[
  {
    "txId": "4df40f77-2b38-43f4-b264-1d850f5a6715",
    "playerId": "john",
    "type": "deposit",
    "currency": "EUR",
    "amount": 1234,
    "createdAt": "2020-12-03T12:15:30.000Z",
    "postTransactionBalance": 5678
  }
]

Параметр	Описание	Тип	Требования	Пояснение
txId	идентификатор транзакции	string	обязательный	идентификатор транзакции передаваемый в /transferwallet/deposit или /transferwallet/withdrawal
playerId	идентификатор пользователя	string	обязательный	уникальный в рамках платформы
type	тип транзакции	string	обязательный	deposit или withdrawal
currency	валюта транзакции	string	обязательный	3-5 символов
amount	сумма транзакции	integer	обязательный	сумма транзакции в формате minor currency unit (учитывая центы, т.е. число умноженное на 100)
createdAt	время транзакции	timestamp	обязательный	format: yyyy-MM-dd’T’HH:mm:ss.SSSZ
postTransactionBalance	баланс после транзакции	integer	обязательный	баланс пользователя после транзакции в формате minor currency unit (учитывая центы, т.е. число, умноженное на 100)

/transferwallet/getGameHistory

Предоставление информации об игровых транзакциях. Транзакции отсортированы по времени создания от поздних к ранним.

Пример запроса

POST /transferwallet/getGameHistory HTTP/1.1
Content-Type: application/json
Accept: application/json
X-Auth-Signature: <signature>

{
  "cid": "someplatform",
  "productId": "nft-aviatrix",
  "limit": 20,
  "from": "2020-12-03T12:15:30.000Z"
}

Параметр	Описание	Тип	Требования	Пояснение
cid	уникальный идентификатор платформы	string	обязательный	идентификатор одинаковый для всех окружений в рамках платформы
productId	идентификатор игры	string	обязательный	примеры идентификаторов: `nft-aviatrix`, `second-chance`, `aviatrix-fruits`. С полным списком можно ознакомиться на странице всех продуктов
limit	количество транзакций в ответе	string	опциональный	0 < limit < 100, если не указан, то применяется значение по умолчанию (50 транзакций)
from	максимальное значение createdAt в ответе	timestamp	опциональный	format: yyyy-MM-dd’T’HH:mm:ss.SSSZ

Пример ответа от сервера

HTTP/1.1 200 OK
[
  {
    "betId": "1a2b3c4d-6f5e-4d3c-b2a1-f6e5d4c3b2a1",
    "playerId": "john",
    "txId": "4df40f77-2b38-43f4-b264-1d850f5a6715",
    "type": "bet",
    "currency": "EUR",
    "amount": 1234,
    "createdAt": "2020-12-03T12:15:30.000Z",
    "postTransactionBalance": 5678
  }
]

Параметр	Описание	Тип	Требования	Пояснение
betId	идентификатор ставки	string	обязательный	создается на стороне провайдера
playerId	идентификатор пользователя	string	обязательный	уникальный в рамках платформы
txId	идентификатор транзакции	string	обязательный	идентификатор внутриигровой транзакции, генерируется на стороне провайдера
type	тип транзакции	string	обязательный	bet, win, cancel или promoWin
currency	валюта транзакции	string	обязательный	3-5 символов
amount	сумма транзакции	integer	обязательный	сумма транзакции в формате minor currency unit (учитывая центы, т.е. число умноженное на 100)
createdAt	время транзакции	timestamp	обязательный	format: yyyy-MM-dd’T’HH:mm:ss.SSSZ
postTransactionBalance	баланс после транзакции	integer	обязательный	баланс пользователя после транзакции в формате minor currency unit (учитывая центы, т.е. число, умноженное на 100)

/transferwallet/deposit

Депозит суммы на пользовательский баланс.

Пример запроса

POST /transferwallet/deposit HTTP/1.1
Content-Type: application/json
Accept: application/json
X-Auth-Signature: <signature>

{
  "cid": "someplatform",
  "playerId": "john",
  "txId": "4df40f77-2b38-43f4-b264-1d850f5a6715",
  "currency": "EUR",
  "amount": 1234
}

Параметр	Описание	Тип	Требования	Пояснение
cid	уникальный идентификатор бренда	string	обязательный	идентификатор одинаковый для всех окружений в рамках бренда
playerId	идентификатор пользователя	string	обязательный	уникальный в рамках бренда
txId	идентификатор транзакции	string	обязательный	идентификатор транзакции передаваемый в /transferwallet/deposit или /transferwallet/withdrawal
currency	валюта депозита	string	обязательный	3-5 символов
amount	сумма депозита	integer	обязательный	ISO-4217-3 format.

Пример ответа от сервера

HTTP/1.1 200 OK
{
  "txId": "4df40f77-2b38-43f4-b264-1d850f5a6715",
  "playerId": "john",
  "currency": "EUR",
  "balance": 1234
}

Параметр	Описание	Тип	Требования	Пояснение
txId	идентификатор транзакции	string	обязательный	идентификатор транзакции передаваемый в /transferwallet/deposit или /transferwallet/withdrawal
playerId	идентификатор пользователя	string	обязательный	уникальный в рамках бренда
currency	валюта баланса пользователя	string	обязательный	3-5 символов
balance	баланс пользователя	integer	обязательный	ISO-4217-3 format.

/transferwallet/withdraw

Вывод суммы с пользовательского баланса.

Пример запроса

POST /transferwallet/withdraw HTTP/1.1
Content-Type: application/json
Accept: application/json
X-Auth-Signature: <signature>

{
  "cid": "someplatform",
  "playerId": "john",
  "txId": "4df40f77-2b38-43f4-b264-1d850f5a6715",
  "currency": "EUR",
  "amount": 1234
}

Параметр	Описание	Тип	Требования	Пояснение
cid	уникальный идентификатор бренда	string	обязательный	идентификатор одинаковый для всех окружений в рамках бренда
playerId	идентификатор пользователя	string	обязательный	уникальный в рамках бренда
txId	идентификатор транзакции	string	обязательный	идентификатор транзакции передаваемый в /transferwallet/deposit или /transferwallet/withdrawal
currency	валюта вывода	string	обязательный	3-5 символов. Валюта, в которой пользователь будет делать ставки
amount	сумма вывода	integer	обязательный	ISO-4217-3 format.

Пример ответа от сервера

HTTP/1.1 200 OK
{
  "txId": "4df40f77-2b38-43f4-b264-1d850f5a6715",
  "playerId": "john",
  "currency": "EUR",
  "balance": 1234
}

Параметр	Описание	Тип	Требования	Пояснение
txId	идентификатор транзакции	string	обязательный	идентификатор транзакции передаваемый в /transferwallet/deposit или /transferwallet/withdrawal
playerId	идентификатор пользователя	string	обязательный	уникальный в рамках бренда
currency	валюта баланса пользователя	string	обязательный	3-5 символов. Валюта, в которой пользователь будет делать ставки
balance	баланс пользователя	integer	обязательный	ISO-4217-3 format.

Transfer Wallet API введение​

Transfer Wallet API методы​

/transferwallet/launchGame​

Пример запроса​

Пример ответа от сервера​

/transferwallet/checkTx​

Пример запроса​

Пример ответа от сервера​

/transferwallet/getBalance​

Пример запроса​

Пример ответа от сервера​

/transferwallet/getHistory​

Пример запроса​

Пример ответа от сервера​

/transferwallet/getGameHistory​

Пример запроса​

Пример ответа от сервера​

/transferwallet/deposit​

Пример запроса​

Пример ответа от сервера​

/transferwallet/withdraw​

Пример запроса​

Пример ответа от сервера​

Transfer Wallet API введение

Transfer Wallet API методы

/transferwallet/launchGame

Пример запроса

Пример ответа от сервера

/transferwallet/checkTx

Пример запроса

Пример ответа от сервера

/transferwallet/getBalance

Пример запроса

Пример ответа от сервера

/transferwallet/getHistory

Пример запроса

Пример ответа от сервера

/transferwallet/getGameHistory

Пример запроса

Пример ответа от сервера

/transferwallet/deposit

Пример запроса

Пример ответа от сервера

/transferwallet/withdraw

Пример запроса

Пример ответа от сервера