Seamless wallet чи transfer wallet
В агрегації казино існують дві моделі гаманця. У seamless (єдиному) гаманці провайдер гри звертається до вашого гаманця за кожною ставкою й кожним виграшем у реальному часі; у гравця один баланс на все. У transfer wallet кошти переводять у суббаланс провайдера перед грою і назад після неї. Seamless — це те, чого очікують гравці і що регулятори воліють для звітності; transfer виживає лише в кількох легасі-студіях. Наш API — seamless передусім: ви один раз реалізуєте чотири колбеки (баланс, списання, зарахування, відкат), і всі студії за агрегацією користуються ними.
Що модель гаманця змінює після запуску
Вибір зазвичай роблять на схемі, а платять за нього в операційці. У таблиці дві моделі зіставлені з тим, що ваша каса, ваша підтримка і ваш фінвідділ роблять щодня.
| Після запуску | Seamless wallet | Transfer wallet |
|---|---|---|
| Баланс гравця | Один баланс на всі студії, а також на казино й букмекера | Основний баланс плюс суббаланс для кожного провайдера, у якого йде гра |
| Запуск гри | Гра відкривається і грається проти основного балансу | Спершу переводяться кошти, і гравець не може поставити те, чого не перевів |
| Вихід із гри | Робити нічого не треба | Кошти лежать у суббалансі, доки їх не переведуть назад; застряглі баланси — рутинний тикет у підтримку, а не краєвий випадок |
| Виведення | Доступне — це і є баланс | Доступний лише основний баланс, тож виведення зривається, поки гроші гравця лежать деінде |
| Бонус на кілька студій | Одна вимога щодо відіграшу може діяти на всі студії, бо є один баланс, проти якого її відстежувати | Бонусні гроші прив’язані до того, куди їх перевели |
| Звірка | По кожному раунду й кожній транзакції, у момент події | По пакету переказів, тож розбіжність знаходять на пакеті, а потім шукають усередині нього |
| Спір щодо одного раунду | Історія раунду лежить у вашому власному реєстрі | Історію раунду запитують у провайдера |
Наш API — seamless передусім, а студію лише з transfer ми несемо як виняток за ним, а не як другу модель у вашій касі. Питання, яке варто поставити про таку студію: чи просять її ваші гравці на ім’я. Якщо так — операційний хвіст вище варто оплатити. Якщо вона там, щоб підняти лічильник каталогу, — не варто.
Життєвий цикл запуску й сесії
Між тим, як гравець клікає на гру, і закриттям раунду відбувається вісім кроків. Команди, які будують свій перший гаманець, найбільше дивують кроки п’ять і сім.
- Ваш сервер запитує URL запуску, передаючи гравця, валюту, мову, контекст ліцензії й те, реальна це сесія чи демо. Ми його підписуємо. URL одноразовий і короткоживучий, тож ним не можна поділитися й не можна його відтворити.
- Браузер відкриває гру в студії. Тепер сесією володіє студія.
- Студія запитує баланс. Ваш гаманець відповідає. Це єдиний із чотирьох колбеків, який не рухає гроші.
- Кожен спін чи роздача надсилає списання з ідентифікатором раунду й ідентифікатором транзакції. Ідентифікатор раунду групує все, що належить одному ігровому раунду; ідемпотентним ви робите ідентифікатор транзакції.
- Виграш надсилає зарахування з тим самим ідентифікатором раунду. Деякі раунди зараховують більше одного разу — так роблять раунди фриспінів і бонусні фічі, — тож раунд це не одне списання й одне зарахування.
- Раунд закривається. Доки він не закритий, він ще може прийняти відкат.
- Відкат скасовує названу транзакцію всередині раунду: невдалий спін, помилку на боці студії, таймаут. Він може прийти вже після того, як зарахування застосовано, — саме тому сертифікація розігрує точно такий порядок.
- Сесія завершується, коли гравець виходить або коли її закриває студія. Обрив посеред раунду вирішується за власними правилами студії: одні відновлюють раунд після повернення, інші завершують його на сервері й зараховують. Ваш реєстр має приймати обидва варіанти.
Що покриває API
- Каталог ігор: ігри з метаданими (студія, тип, RTP, волатильність, фічі, підтримувані валюти та юрисдикції), автоматично відфільтровані під те, що дозволяє ваша ліцензія.
- Запуск: підписані URL запуску гри для реальної гри й демо, з контекстом гравця, валюти, мови та ліцензії.
- Колбеки гаманця: баланс, ставка, виграш, відкат; ідемпотентні, з ідентифікаторами раунду й транзакції для звірки.
- Бонуси: фриспіни та бонусні гроші, оркестровані по студіях; набори правил під кожен ринок, щоб фінський бренд можна було замкнути лише на утримання з обмеженням 5×, а офшорний — ні.
- Джекпоти й турніри: мережеві та локальні джекпоти, таблиці лідерів, турніри студій.
- Звітність: історія раундів для підтримки гравців і спорів, GGR за грою та студією, експорт для регулятора у форматах, яких вимагають ліцензії, з якими ми працюємо.
Контент
Агрегатори публікують розміри своїх каталогів: Hub88 заявляє понад 26,000 ігор; про EveryMatrix і SOFTSWISS повідомляють 40,000–45,000 ігор від 300 до 355 студій. Цифра, яка має значення для оператора, менша: це ігри, які дозволяють і ваша ліцензія, і списки юрисдикцій ваших цільових студій, у валютах, якими користуються ваші гравці. Цей перелік під вашу конкретну ліцензію ми даємо на етапі визначення обсягу, а не заголовкове число.
Скільки вартий заголовковий розмір каталогу
Поділіть опубліковану кількість ігор на опубліковану кількість студій — і три каталоги вище опиняться в одному місці. Останній стовпець — це і є те ділення, і воно є курсом обміну між цифрою на слайді та суперечкою, яку ви насправді ведете.
| Опублікований каталог | Ігри | Студії | Ігор на студію |
|---|---|---|---|
| Hub88 | 26,000+ | 150+ провайдерів | близько 170 |
| EveryMatrix (за повідомленнями) | 45,000 | 355 | близько 127 |
| SOFTSWISS (за повідомленнями) | 40,000 | 300 | близько 133 |
У кожному з них студія варта приблизно від 125 до 175 ігор. Тобто ви порівнюєте не ігри, а студії, і студія, яка не обслуговуватиме вашу ліцензію, іде разом з усією своєю полицею. У таблиці нижче — що прибирає студію з вашого переліку і скільки це коштує за такими нормами.
| Що прибирає студію | Скільки це вам коштує |
|---|---|
| Власний список юрисдикцій студії не включає вашу ліцензію. Студії першого рівня ведуть такі списки й застосовують їх бренд за брендом. | Група студій може бути кількома студіями в агрегації, тож одна відмова — це 500 ігор або більше. |
| Анжуан вимагає, щоб кожен постачальник мав власний сертифікат визнання B2B; чинно з 1 липня 2025 року, €9,500 на рік. | Прибирає будь-яку студію, яка його не купила, хоч би що казав її список юрисдикцій і хоч би що вона вам обіцяла. |
| Валюти, якими користуються ваші гравці, ця студія не підтримує. | Прибирає її для одного бренду, а часто — для одного ринку, а не для всіх. |
| Live dealer — категорія з найсуворішими списками юрисдикцій. | Прибирає той контент, відсутність якого гравці помічають першою. |
| Ринкові правила щодо бонусів. Фінляндія забороняє бонуси на залучення й обмежує відіграш на утриманні 5×, а ліцензована діяльність — з 1 липня 2027 року. | Не прибирає жодної гри — прибирає кампанії, які мали на них іти. |
Саме тому число, яке ми вам даємо, з’являється на етапі визначення обсягу. Це запит по списках юрисдикцій усіх студій за агрегацією, і щоб його виконати, потрібні ваша ліцензія та ваш перелік ринків. Заголовковому числу не потрібно ні того, ні того — тому публікують саме його.
Сертифікація до продакшн-ключів
Ваші колбеки гаманця перевіряють на прописаному наборі краєвих випадків до того, як ми видамо продакшн-доступ: подвійне списання на нестабільному з’єднанні, відкат, який приходить після того, як виграш уже зараховано, розбіжність валют між ігровою сесією і гаманцем, і раунд, що обривається посеред гри. REST із підписаними запитами, пісочниця з реальними тестовими середовищами студій, два-шість тижнів від доступу до пісочниці до продакшн-ключів для платформної команди, яка вже будувала гаманець.
На що йдуть ці два-шість тижнів
Цей діапазон — ваша робота, а не черга, у якій ви чекаєте. Таблиця — та сама робота в інженеро-днях, а розкид — це різниця між командою, яка вже будувала seamless wallet, і командою, яка будує перший.
| Крок | Інженеро-дні |
|---|---|
| Автентифікація, підписування запитів, рукостискання з пісочницею | 1–2 |
| Чотири колбеки проти реєстру, здатного відобразити відкат | 3–10 |
| Ідемпотентність: ключі запитів, збережені відповіді, поведінка на повторі | 2–5 |
| Робота з валютами, округлення та дрібні одиниці | 1–3 |
| URL запуску, контекст сесії та шлях на обрив з’єднання | 1–4 |
| Прописаний прогін сертифікації та правки, які він дає | 2–8 |
| Підключені фільтрація каталогу, звітність та експорт для регулятора | 2–5 |
Дванадцять–тридцять сім інженеро-днів — це і є ті два-шість тижнів із цієї сторінки для одного інженера, у якого є й інші обов’язки. Те, що виштовхує команду за верхню межу, майже завжди реєстр, а не API. Роблять це три речі. Баланс, який обчислюють на читанні, а не зберігають, — тоді відкату нічого скасовувати. Таблиця транзакцій без природного ключа, який можна зробити ідемпотентним. І гроші, що зберігаються як число з рухомою комою. Перші дві — це переписування. Третя спливає на сертифікації як розбіжність валют і різниця округлення в одну дрібну одиницю.
Часті питання
Що станеться з відкритим раундом, якщо наш гаманець перестане відповідати?
Студія не може завершити раунд, і що вона робить далі — це правило студії: одні тримають раунд і повторюють, інші анулюють його і надсилають відкат. У будь-якому разі ключем є ідентифікатор раунду, і раунд розв’язується, коли ваш гаманець відповість або коли прийде відкат. Нічого не розраховується двічі, бо кожен виклик ідемпотентний за ідентифікатором транзакції. Відкриті раунди — це перший звіт, який треба перевірити після інциденту, і саме через них набір сертифікації розігрує гаманець, який спиняється посеред раунду.
Чи можемо ми лишити студію, яка пропонує лише transfer wallet?
Так, як виняток за seamless-інтеграцією, щоб ваша каса лишалася з одним балансом. Разом із нею приходить операційний хвіст: суббаланси, у яких застрягають гроші, звірка на пакеті, а не на раунді, та історія спорів, яка лежить у провайдера, а не у вас. Для студії, яку ваші гравці просять на ім’я, це чесний обмін. Для студії, яка лише збільшує лічильник каталогу, — поганий.
Чи можемо ми додати власні ігри?
Так. Ваша студія один раз інтегрується до нашого provider API і з’являється в каталозі для ваших брендів, а за бажання — і для інших.
Чи входить live dealer?
Так, від тих live-студій, чиї списки юрисдикцій включають вашу ліцензію; live-контент — категорія з найсуворішими списками ліцензій.
Чи працює API для крипто-казино?
Так; гаманець не залежить від валюти, а криптобаланси обробляються як валюти з розрахунком у вашій криптокасі.