Подключение казино к играм S7Connecting a casino to S7 gamesConectar un casino a los juegos S7Ein Casino an die S7-Spiele anbindenKasinon liittäminen S7-peleihin

1Как устроена сессияHow a session worksCómo funciona una sesiónWie eine Sitzung funktioniertMiten istunto toimii

Границу ответственности проще всего увидеть по шагам.The division of labour is easiest to see step by step.El reparto de tareas se ve mejor paso a paso.Die Aufgabenteilung sieht man am besten Schritt für Schritt.Työnjako näkyy helpoimmin vaihe vaiheelta.

1.  Игрок нажимает «Играть» у вас на сайте.
2.  Вы выпускаете сессионный токен и открываете нашу ссылку в <iframe>.
3.  Мы зовём POST /auth на вашем кошельке с этим токеном.
       Вы отвечаете, кто это и сколько у него денег —
       именно отсюда мы узнаём валюту.
4.  Идёт игра. Каждая ставка — POST /bet, каждая выплата — POST /win.
       Ставку, которую нужно вернуть, отменяет POST /rollback.
5.  Игрок уходит. /win и /rollback обязаны работать и после этого.

1.  The player presses Play on your site.
2.  You mint a session token and open our link in an <iframe>.
3.  We call POST /auth on your wallet with that token.
       You answer with the player and their balance —
       this is where we learn the currency.
4.  The game runs. Every stake is POST /bet, every payout POST /win.
       A stake that has to be given back is POST /rollback.
5.  The player leaves. /win and /rollback still have to work.

1.  El jugador pulsa Jugar en su sitio.
2.  Usted emite un token de sesión y abre nuestro enlace en un <iframe>.
3.  Llamamos a POST /auth en su monedero con ese token.
       Usted responde con el jugador y su saldo —
       aquí es donde conocemos la moneda.
4.  El juego corre. Cada apuesta es POST /bet, cada pago POST /win.
       Una apuesta que hay que devolver es POST /rollback.
5.  El jugador se va. /win y /rollback todavía tienen que funcionar.

1.  Der Spieler drückt auf Ihrer Seite auf Spielen.
2.  Sie stellen ein Sitzungstoken aus und öffnen unseren Link in einem <iframe>.
3.  Wir rufen POST /auth auf Ihrem Wallet mit diesem Token auf.
       Sie antworten mit dem Spieler und seinem Saldo —
       hier erfahren wir die Währung.
4.  Das Spiel läuft. Jeder Einsatz ist POST /bet, jede Auszahlung POST /win.
       Ein Einsatz, der zurück muss, ist POST /rollback.
5.  Der Spieler geht. /win und /rollback müssen weiter funktionieren.

1.  Pelaaja painaa sivustollanne Pelaa.
2.  Te luotte istuntotunnisteen ja avaatte linkkimme <iframe>-kehykseen.
3.  Kutsumme lompakkonne POST /auth -päätepistettä tuolla tunnisteella.
       Te vastaatte pelaajalla ja hänen saldollaan —
       tässä kohtaa saamme tietää valuutan.
4.  Peli käy. Jokainen panos on POST /bet, jokainen maksu POST /win.
       Panos, joka on palautettava, on POST /rollback.
5.  Pelaaja poistuu. /win ja /rollback on yhä toimittava.

Шаги 3–5 держите вы. Всё остальное — мы.You host steps 3–5. We host everything else.Usted aloja los pasos 3–5. Nosotros alojamos todo lo demás.Sie hosten die Schritte 3–5. Alles andere hosten wir.Te isännöitte vaiheet 3–5. Kaiken muun isännöimme me.

2Ссылка на игруThe launch linkEl enlace de lanzamientoDer Start-LinkKäynnistyslinkki

Её вы собираете у себя и открываете в iframe.You build it on your side and open it in an iframe.Usted lo construye en su lado y lo abre en un iframe.Sie bauen ihn auf Ihrer Seite und öffnen ihn in einem iframe.Te rakennatte sen omalla puolellanne ja avaatte sen iframessa.

https://play.afr.stellar-kiosk.com/game/{customer}/{module}/{game}/?<params>

2.1ПараметрыParametersParámetrosParameterParametrit

https://play.afr.stellar-kiosk.com/game/{customer}/crash/default/
  ?token=abc123&language=en&openType=real
  &devicetypeid=1&exitURL=https://casino.example/lobby

2.2Три вещи, которые стоит знатьThree things worth knowingTres cosas que conviene saberDrei Dinge, die man wissen sollteKolme asiaa jotka kannattaa tietää

Регистр и разделители не важны. auth_token, authToken и AUTH-TOKEN — для нас один и тот же параметр. Если ваша платформа уже отдаёт другое написание — присылайте как есть: скорее всего мы его уже принимаем, а если нет, добавить его — это правка конфигурации у нас, а не у вас. Case and separators do not matter. auth_token, authToken and AUTH-TOKEN are the same parameter to us. If your platform already emits a different spelling, send it: we probably accept it already, and if not, accepting it is a configuration change on our side, not a change on yours. Mayúsculas y separadores no importan. auth_token, authToken y AUTH-TOKEN son el mismo parámetro para nosotros. Si su plataforma ya emite otra grafía, envíela: probablemente ya la aceptamos, y si no, aceptarla es un cambio de configuración de nuestro lado, no un cambio del suyo. Groß- und Kleinschreibung und Trennzeichen spielen keine Rolle. auth_token, authToken und AUTH-TOKEN sind für uns derselbe Parameter. Wenn Ihre Plattform bereits eine andere Schreibweise ausgibt, schicken Sie sie: wahrscheinlich akzeptieren wir sie schon, und wenn nicht, ist das Akzeptieren eine Konfigurationsänderung auf unserer Seite, keine Änderung auf Ihrer. Kirjainkoolla ja erottimilla ei ole väliä. auth_token, authToken ja AUTH-TOKEN ovat meille sama parametri. Jos alustanne lähettää jo jotain muuta kirjoitusasua, lähettäkää se: luultavasti hyväksymme sen jo, ja jos emme, sen hyväksyminen on konfiguraatiomuutos meidän puolellamme, ei muutos teidän.

Незнакомые параметры мы не выбрасываем. Они возвращаются в диагностике, так что если вы что-то прислали, а мы будто не заметили — видно ровно то, что пришло. Anything we do not recognise is kept, not dropped. It comes back in the diagnostics, so if you send us something and we appear to ignore it, you can see exactly what arrived. Todo lo que no reconocemos se conserva, no se descarta. Vuelve en los diagnósticos, así que si nos envía algo y parece que lo ignoramos, puede ver exactamente qué llegó. Alles, was wir nicht kennen, wird behalten, nicht verworfen. Es taucht in der Diagnose wieder auf — wenn Sie uns also etwas schicken und wir es zu ignorieren scheinen, können Sie genau sehen, was angekommen ist. Kaikki mitä emme tunnista säilytetään, ei pudoteta. Se palaa diagnostiikassa, joten jos lähetätte meille jotain ja näyttää siltä että ohitamme sen, näette tarkalleen mitä saapui.

Откройте ссылку в браузере до того, как напишете код кошелька. Мы отдадим страницу, которая перечисляет каждый присланный параметр, во что мы его сопоставили, и что ваш кошелёк ответил про токен. Это самый быстрый способ найти ссылку, собранную не на того кастомера. Open the launch link in a browser before writing any wallet code. We serve a page listing every parameter you sent, what we matched it to, and what your wallet said about the token. It is the fastest way to find a link built against the wrong customer. Abra el enlace de lanzamiento en un navegador antes de escribir cualquier código de monedero. Servimos una página que lista cada parámetro que envió, con qué lo emparejamos y qué dijo su monedero sobre el token. Es la forma más rápida de encontrar un enlace construido contra el cliente equivocado. Öffnen Sie den Start-Link in einem Browser, bevor Sie eine einzige Zeile Wallet-Code schreiben. Wir liefern eine Seite aus, die jeden gesendeten Parameter auflistet, wozu wir ihn zugeordnet haben und was Ihr Wallet zum Token gesagt hat. Das ist der schnellste Weg, einen Link zu finden, der gegen den falschen Kunden gebaut wurde. Avaa käynnistyslinkki selaimessa ennen kuin kirjoitat riviäkään lompakkokoodia. Tarjoamme sivun, joka listaa jokaisen lähettämänne parametrin, mihin sen yhdistimme ja mitä lompakkonne sanoi tunnisteesta. Se on nopein tapa löytää väärälle asiakastunnukselle rakennettu linkki.

2.3Кнопки выхода и кассыThe exit and cashier controlsLos controles de salida y de cajaDie Ausgangs- und Kassen-ElementePoistumis- ja kassapainikkeet

Ничего из того, что вы строите сейчас, менять не придётся: правила уже зафиксированы.Nothing you build now has to change when they appear, because the rules are already fixed:Nada de lo que construya ahora tendrá que cambiar cuando aparezcan, porque las reglas ya están fijadas:Nichts, was Sie jetzt bauen, muss sich ändern, wenn sie kommen, denn die Regeln stehen bereits fest:Mikään mitä rakennatte nyt ei joudu muuttumaan kun ne tulevat, sillä säännöt ovat jo lyöty lukkoon:

1. Нет адреса — нет кнопки. Не серая, не неработающая — контрола не существует. Не слать exitURL и нарисовать свой выход вокруг iframe — поддерживаемая конфигурация, а не обходной путь, и она останется верной и потом.No url, no button. Not a greyed-out one, not one that does nothing — the control does not exist. Leaving exitURL off and drawing your own exit around the iframe is a supported configuration, not a workaround, and it stays correct afterwards.Sin url, sin botón. Ni uno en gris, ni uno que no haga nada — el control no existe. Omitir exitURL y dibujar su propia salida alrededor del iframe es una configuración admitida, no un apaño, y sigue siendo correcta después.Keine URL, keine Schaltfläche. Keine ausgegraute, keine, die nichts tut — das Element existiert nicht. exitURL wegzulassen und den eigenen Ausgang um das iframe herum zu zeichnen, ist eine unterstützte Konfiguration, kein Notbehelf, und bleibt auch danach richtig.Ei osoitetta, ei painiketta. Ei harmaana, ei sellaista joka ei tee mitään — painiketta ei ole olemassa. exitURL:n jättäminen pois ja oman poistumispainikkeen piirtäminen iframen ympärille on tuettu ratkaisu, ei kiertotie, ja se pysyy oikeana myöhemminkin.
2. Адрес может прийти из ссылки или из настроек. Если игроки всегда возвращаются в одно лобби, назовите адрес один раз — мы его сохраним. Игра разницы не видит.A url may come from the link or from your settings. If players always return to the same lobby, tell us the address once and we hold it. The game cannot tell the two apart.Una url puede venir del enlace o de sus ajustes. Si los jugadores vuelven siempre al mismo lobby, díganos la dirección una vez y la guardamos. El juego no distingue una de otra.Eine URL kann aus dem Link oder aus Ihren Einstellungen kommen. Wenn Spieler immer in dieselbe Lobby zurückkehren, nennen Sie uns die Adresse einmal, und wir halten sie vor. Das Spiel kann beide nicht unterscheiden.Osoite voi tulla linkistä tai asetuksistanne. Jos pelaajat palaavat aina samaan aulaan, kertokaa osoite meille kerran ja me säilytämme sen. Peli ei erota näitä kahta toisistaan.
3. Переход заменяет всю страницу, а не фрейм. Лобби, отрисованное внутри прямоугольника игры, в её рамке и с её полосами прокрутки, — не то, что мы стали бы выпускать.The control replaces the whole page, never the frame. A lobby rendered inside the game's rectangle, still wrapped in the game's frame and scrollbars, is not something we would ship.El control reemplaza la página entera, nunca el marco. Un lobby renderizado dentro del rectángulo del juego, todavía envuelto en el marco y las barras de desplazamiento del juego, no es algo que fuéramos a entregar.Das Element ersetzt die ganze Seite, niemals den Frame. Eine Lobby, die im Rechteck des Spiels gerendert wird, noch immer im Rahmen und den Scrollbalken des Spiels — so etwas würden wir nicht ausliefern.Painike korvaa koko sivun, ei koskaan kehystä. Aula, joka piirretään pelin suorakulmion sisään, yhä pelin kehyksen ja vierityspalkkien ympäröimänä, ei ole jotain mitä me toimittaisimme.

Проходят только обычные http(s)-адреса. Это единственные два параметра ссылки запуска, по которым что-либо переходит, поэтому значение вида javascript: или data: отбрасывается, а не передаётся дальше. Если вы прислали такое и игра ведёт себя так, будто вы не прислали ничего, — причина в этом. У правила 3 есть одно требование к вашей стороне — см. 3. Only ordinary http(s) values survive. These two are the only parameters on a launch link that anything navigates to, so a javascript: or data: value is discarded rather than passed on. If you send one and the game behaves as though you sent nothing, that is why. Rule 3 has one requirement on your side — see 3. Solo sobreviven valores http(s) corrientes. Estos dos son los únicos parámetros de un enlace de lanzamiento a los que algo navega, así que un valor javascript: o data: se descarta en lugar de pasarse. Si envía uno y el juego se comporta como si no hubiera enviado nada, esa es la razón. La regla 3 tiene un requisito de su lado — véase 3. Nur gewöhnliche http(s)-Werte überleben. Diese beiden sind die einzigen Parameter eines Start-Links, zu denen überhaupt etwas navigiert; ein javascript:- oder data:-Wert wird daher verworfen statt weitergereicht. Wenn Sie einen schicken und das Spiel sich verhält, als hätten Sie nichts geschickt, ist das der Grund. Regel 3 stellt eine Anforderung an Ihre Seite — siehe 3. Vain tavalliset http(s)-arvot selviävät. Nämä kaksi ovat käynnistyslinkin ainoat parametrit, joihin mikään navigoi, joten javascript:- tai data:-arvo hylätään sen sijaan että se välitettäisiin. Jos lähetätte sellaisen ja peli käyttäytyy kuin ette olisi lähettäneet mitään, syy on tämä. Säännöllä 3 on yksi vaatimus teidän puolellanne — katso 3.

3Встраивание iframeEmbedding the iframeIncrustar el iframeDas iframe einbettenIframen upottaminen

Игра — обычная страница на нашем домене. От вас нужны размер и разрешение на звук.The game is an ordinary page on our domain. What it needs from you is a size and permission to make sound.El juego es una página corriente en nuestro dominio. Lo que necesita de usted es un tamaño y permiso para hacer sonido.Das Spiel ist eine gewöhnliche Seite auf unserer Domain. Was es von Ihnen braucht, ist eine Größe und die Erlaubnis, Ton auszugeben.Peli on tavallinen sivu meidän verkkotunnuksellamme. Se tarvitsee teiltä koon ja luvan tuottaa ääntä.

<iframe
    src="https://play.afr.stellar-kiosk.com/game/{customer}/crash/default/?token=abc123&openType=real"
    allow="autoplay; fullscreen"
    title="Crash"
    style="border:0; width:100%; height:100%; display:block">
</iframe>

• Размер задаёте вы. Игра тянется на весь фрейм; своей высоты у неё нет. Дайте контейнеру реальную высоту — height:100% внутри блока нулевой высоты даёт пустой прямоугольник.
• allow="autoplay" — без него в игре не будет звука до первого касания. fullscreen нужен, если даёте кнопку на весь экран.
• Не ставьте sandbox, если не уверены в наборе флагов: игре нужны скрипты, свой origin и хранилище. Урезанный sandbox ломает её молча. Если вы всё же ставите sandbox и хотите, чтобы работали внутриигровые выход и касса из 2.3, нужен ещё allow-top-navigation-by-user-activation — без него браузер не даст игре заменить страницу, и откажет молча.
• Новая сессия — новый элемент. Не переиспользуйте один iframe, меняя src: создавайте элемент заново, чтобы перезапуск был настоящей перезагрузкой, а не страницей, сохранившей прежнее состояние.

• The size is yours to set. The game fills the frame and has no height of its own. Give the container a real height — height:100% inside a zero-height block is an empty rectangle.
• allow="autoplay" — without it there is no sound until the first tap. fullscreen is needed if you offer a full-screen button.
• Do not set sandbox unless you are sure of the flags: the game needs scripts, its own origin and storage. A trimmed sandbox breaks it silently. If you do sandbox the frame and you want the in-game exit or cashier of 2.3 to work, it also needs allow-top-navigation-by-user-activation — without it the browser refuses to let the game replace the page, and refuses silently.
• A new session is a new element. Do not reuse one iframe by changing src; create the element again, so reopening is a real reload rather than a page that kept its state.

• El tamaño lo fija usted. El juego llena el marco y no tiene altura propia. Dé al contenedor una altura real — height:100% dentro de un bloque de altura cero es un rectángulo vacío.
• allow="autoplay" — sin él no hay sonido hasta el primer toque. fullscreen hace falta si ofrece un botón de pantalla completa.
• No ponga sandbox a menos que tenga claras las banderas: el juego necesita scripts, su propio origen y almacenamiento. Un sandbox recortado lo rompe en silencio. Si sí aísla el marco y quiere que funcionen la salida o la caja del 2.3, también hace falta allow-top-navigation-by-user-activation — sin ello el navegador se niega a dejar que el juego reemplace la página, y se niega en silencio.
• Una sesión nueva es un elemento nuevo. No reutilice un iframe cambiando src; cree el elemento otra vez, para que reabrir sea una recarga de verdad y no una página que conservó su estado.

• Die Größe setzen Sie. Das Spiel füllt den Frame und hat keine eigene Höhe. Geben Sie dem Container eine echte Höhe — height:100% in einem Block ohne Höhe ist ein leeres Rechteck.
• allow="autoplay" — ohne das gibt es bis zur ersten Berührung keinen Ton. fullscreen brauchen Sie, wenn Sie eine Vollbild-Schaltfläche anbieten.
• Setzen Sie kein sandbox, es sei denn, Sie sind sich der Flags sicher: das Spiel braucht Skripte, einen eigenen Origin und Speicher. Eine beschnittene Sandbox macht es lautlos kaputt. Wenn Sie den Frame doch sandboxen und Ausgang oder Kasse aus 2.3 funktionieren sollen, braucht es zusätzlich allow-top-navigation-by-user-activation — ohne das weigert sich der Browser, das Spiel die Seite ersetzen zu lassen, und zwar lautlos.
• Eine neue Sitzung ist ein neues Element. Verwenden Sie ein iframe nicht wieder, indem Sie src ändern; erzeugen Sie das Element neu, damit erneutes Öffnen ein echtes Neuladen ist und keine Seite, die ihren Zustand behalten hat.

• Koon määrittelette te. Peli täyttää kehyksen eikä sillä ole omaa korkeutta. Antakaa säiliölle todellinen korkeus — height:100% nollakorkuisen lohkon sisällä on tyhjä suorakulmio.
• allow="autoplay" — ilman sitä ääntä ei kuulu ennen ensimmäistä kosketusta. fullscreen tarvitaan, jos tarjoatte kokoruututilan painikkeen.
• Älkää asettako sandbox-määrettä ellette ole varmoja lipuista: peli tarvitsee skriptit, oman originin ja tallennustilan. Karsittu sandbox rikkoo sen äänettömästi. Jos kuitenkin eristätte kehyksen ja haluatte kohdan 2.3 poistumisen tai kassan toimivan, tarvitaan myös allow-top-navigation-by-user-activation — ilman sitä selain kieltäytyy päästämästä peliä korvaamaan sivua, ja kieltäytyy äänettömästi.
• Uusi istunto on uusi elementti. Älkää käyttäkö samaa iframea uudelleen vaihtamalla src; luokaa elementti uudestaan, jotta uudelleenavaus on oikea uudelleenlataus eikä sivu joka säilytti tilansa.

4Эндпоинт кошелькаThe wallet endpointEl endpoint del monederoDer Wallet-EndpunktLompakon päätepiste

Пять методов. Вы даёте один базовый URL, пути мы дописываем сами.Five endpoints. You give us one base URL; we append the paths.Cinco endpoints. Usted nos da una URL base; nosotros añadimos las rutas.Fünf Endpunkte. Sie geben uns eine Basis-URL; wir hängen die Pfade an.Viisi päätepistettä. Te annatte meille yhden perus-URL:n; me lisäämme polut.

POST {base}/auth          проверить токен → кто игрок + баланс
POST {base}/getBalance    прочитать баланс, ничего не двигает
POST {base}/bet           списать ставку
POST {base}/win           начислить выплату
POST {base}/rollback      вернуть ставку

POST {base}/auth          verify a token → who the player is + balance
POST {base}/getBalance    read the balance, moves nothing
POST {base}/bet           debit a stake
POST {base}/win           credit a payout
POST {base}/rollback      give a stake back

POST {base}/auth          verificar un token → quién es el jugador + saldo
POST {base}/getBalance    leer el saldo, no mueve nada
POST {base}/bet           cargar una apuesta
POST {base}/win           abonar un pago
POST {base}/rollback      devolver una apuesta

POST {base}/auth          Token prüfen → wer der Spieler ist + Saldo
POST {base}/getBalance    Saldo lesen, bewegt nichts
POST {base}/bet           einen Einsatz abbuchen
POST {base}/win           eine Auszahlung gutschreiben
POST {base}/rollback      einen Einsatz zurückgeben

POST {base}/auth          varmenna tunniste → kuka pelaaja on + saldo
POST {base}/getBalance    lue saldo, ei siirrä mitään
POST {base}/bet           veloita panos
POST {base}/win           hyvitä maksu
POST {base}/rollback      palauta panos

• Content-Type: application/json в обе стороны.
• Всегда отвечайте HTTP 200, в том числе на отказ. Вердикт — это поле code в теле. Кошелёк, который говорит «недостаточно средств» четырёхсотым, неотличим от прокси, который говорит «плохой запрос», а нам эти два случая нужно различать: от них зависит, повторять операцию или нет.
• Отвечайте быстро. Игра сдаётся по собственному вызову через 5 секунд и сообщает игроку, что ставка не прошла; мы ждём 6, прежде чем счесть запрос потерянным и повторить. То есть 5 с — ваш SLA, а 6 с — только наше терпение: кошелёк, который регулярно отвечает между ними, показывает игрокам ошибки на ставках, которые потом придётся возвращать (см. 12). Цель — меньше секунды.

• Content-Type: application/json, both ways.
• Always answer HTTP 200, including for a refusal. The verdict is the code in the body. A wallet that says "insufficient funds" with a 400 is indistinguishable from a proxy saying "bad request", and we have to tell those apart to decide whether to retry.
• Answer quickly. The game gives up on its own call after 5 seconds and tells the player the bet failed; we wait 6 before treating the request as lost and retrying it. So 5 s is your service level and 6 s is only our patience — a wallet that regularly answers in between shows players errors on bets that then have to be given back (see 12). Under one second is the target.

• Content-Type: application/json, en ambos sentidos.
• Responda siempre HTTP 200, también ante un rechazo. El veredicto es el code del cuerpo. Un monedero que dice «fondos insuficientes» con un 400 es indistinguible de un proxy diciendo «petición incorrecta», y tenemos que distinguirlos para decidir si reintentar.
• Responda rápido. El juego abandona su propia llamada a los 5 segundos y le dice al jugador que la apuesta falló; nosotros esperamos 6 antes de dar la petición por perdida y reintentarla. Así que 5 s es su nivel de servicio y 6 s es solo nuestra paciencia — un monedero que responde regularmente en medio muestra a los jugadores errores en apuestas que luego hay que devolver (véase 12). Por debajo de un segundo es el objetivo.

• Content-Type: application/json, in beide Richtungen.
• Antworten Sie immer mit HTTP 200, auch bei einer Ablehnung. Das Urteil ist der code im Body. Ein Wallet, das „nicht genug Guthaben“ mit einem 400 sagt, ist von einem Proxy, der „bad request“ sagt, nicht zu unterscheiden — und wir müssen das auseinanderhalten, um über eine Wiederholung zu entscheiden.
• Antworten Sie schnell. Das Spiel gibt seinen eigenen Aufruf nach 5 Sekunden auf und sagt dem Spieler, der Einsatz sei fehlgeschlagen; wir warten 6, bevor wir die Anfrage als verloren behandeln und wiederholen. 5 s sind also Ihr Service-Level und 6 s nur unsere Geduld — ein Wallet, das regelmäßig dazwischen antwortet, zeigt Spielern Fehler bei Einsätzen, die danach zurückgegeben werden müssen (siehe 12). Unter einer Sekunde ist das Ziel.

• Content-Type: application/json, molempiin suuntiin.
• Vastatkaa aina HTTP 200, myös hylkäykseen. Tuomio on rungon code. Lompakko joka sanoo ”katteeton” 400-koodilla on erottamaton välityspalvelimesta joka sanoo ”virheellinen pyyntö”, ja meidän on erotettava nämä päättääksemme uudelleenlähetyksestä.
• Vastatkaa nopeasti. Peli luovuttaa oman kutsunsa 5 sekunnissa ja kertoo pelaajalle että panos epäonnistui; me odotamme 6 ennen kuin pidämme pyyntöä kadonneena ja lähetämme uudelleen. Eli 5 s on teidän palvelutasonne ja 6 s on vain meidän kärsivällisyytemme — lompakko joka vastaa säännöllisesti näiden väliin näyttää pelaajille virheitä panoksista jotka sitten on palautettava (katso 12). Alle sekunti on tavoite.

5ПодписьSignatureFirmaSignaturAllekirjoitus

Каждый запрос несёт дайджест собственного тела, в заголовке с именем ровно Auth.Every request carries a digest of its own body, in a header named exactly Auth.Cada petición lleva un resumen de su propio cuerpo, en una cabecera llamada exactamente Auth.Jede Anfrage trägt einen Digest ihres eigenen Bodys, in einem Header, der genau Auth heißt.Jokainen pyyntö kantaa tiivistettä omasta rungostaan, otsakkeessa jonka nimi on täsmälleen Auth.

Auth: sha256(<сырые байты тела> + <общий ключ>)     hex, нижний регистр

Auth: sha256(<raw request body bytes> + <shared key>)     hex, lower case

Auth: sha256(<bytes crudos del cuerpo de la petición> + <clave compartida>)     hex, minúsculas

Auth: sha256(<rohe Bytes des Anfrage-Bodys> + <gemeinsamer Schlüssel>)     hex, klein

Auth: sha256(<pyynnön rungon raakatavut> + <jaettu avain>)     heksa, pienin kirjaimin

Ни префикса, ни разделителя: ключ дописывается прямо к байтам тела, а значением идёт hex дайджеста в нижнем регистре. Проверить свою реализацию — одна строка: No prefix and no separator: the key is appended directly to the body bytes, and the value is the lower-case hex of the digest. Checking your implementation is one line: Sin prefijo y sin separador: la clave se añade directamente a los bytes del cuerpo, y el valor es el hex en minúsculas del resumen. Comprobar su implementación es una línea: Kein Präfix und kein Trennzeichen: der Schlüssel wird direkt an die Body-Bytes angehängt, und der Wert ist der Digest als Kleinbuchstaben-Hex. Ihre Implementierung zu prüfen ist eine Zeile: Ei etuliitettä eikä erotinta: avain liitetään suoraan rungon tavujen perään, ja arvo on tiivisteen heksa pienin kirjaimin. Toteutuksenne tarkistaminen on yksi rivi:

printf '%s' "$body$shared_key" | shasum -a 256

Общий ключ обменивается при интеграции и по проводу не ходит.The shared key is exchanged at integration and never travels on the wire.La clave compartida se intercambia en la integración y nunca viaja por el cable.Der gemeinsame Schlüssel wird bei der Integration ausgetauscht und geht nie über die Leitung.Jaettu avain vaihdetaan integraation yhteydessä eikä se koskaan kulje verkon yli.

6Запросы и ответыRequests and responsesPeticiones y respuestasAnfragen und AntwortenPyynnöt ja vastaukset

В каждом запросе есть partnerId и token. Остальное зависит от операции. Every request carries partnerId and token. The rest depends on the operation. Cada petición lleva partnerId y token. El resto depende de la operación. Jede Anfrage trägt partnerId und token. Der Rest hängt von der Operation ab. Jokainen pyyntö kantaa kentät partnerId ja token. Loppu riippuu operaatiosta.

6.1Что присылаем мыWhat we sendQué enviamosWas wir sendenMitä me lähetämme

// POST /auth  и  POST /getBalance
{
  "partnerId":  "198",
  "operatorId": "brand-7",  // только если бренд был в ссылке
  "token":      "abc123",
  "currency":   "USD"       // только getBalance; в auth его нет
}

// POST /bet
{
  "partnerId":     "198",
  "token":         "abc123",
  "transactionId": "bet:alice:1187:0",   // наш; уникален навсегда
  "amount":        2.5,
  "currency":      "USD",
  "gameId":        "555",                // ВАШ каталожный id
  "roundId":       "crash:USD:1187"
}

// POST /win — то же плюс ставка, которую выплачивает
{
  "partnerId":        "198",
  "token":            "abc123",          // МОЖЕТ БЫТЬ ПРОСРОЧЕН — см. 8
  "transactionId":    "take:alice:1187:0",
  "betTransactionId": "bet:alice:1187:0",
  "amount":           7,
  "currency":         "USD",
  "gameId":           "555",
  "roundId":          "crash:USD:1187"
}

// POST /rollback — вернуть ставку
{
  "partnerId":        "198",
  "token":            "abc123",          // МОЖЕТ БЫТЬ ПРОСРОЧЕН — см. 8
  "transactionId":    "cancel:alice:1187:0",
  "betTransactionId": "bet:alice:1187:0",
  "amount":           2.5,
  "currency":         "USD",
  "roundId":          "crash:USD:1187",
  "reason":           "cancel"           // cancel | void | rollback
}

// POST /auth  and  POST /getBalance
{
  "partnerId":  "198",
  "operatorId": "brand-7",  // only when the link named a brand
  "token":      "abc123",
  "currency":   "USD"       // getBalance only; absent on auth
}

// POST /bet
{
  "partnerId":     "198",
  "token":         "abc123",
  "transactionId": "bet:alice:1187:0",   // ours; unique forever
  "amount":        2.5,
  "currency":      "USD",
  "gameId":        "555",                // YOUR catalogue id
  "roundId":       "crash:USD:1187"
}

// POST /win — the same, plus the bet it pays out
{
  "partnerId":        "198",
  "token":            "abc123",          // MAY BE EXPIRED — see 8
  "transactionId":    "take:alice:1187:0",
  "betTransactionId": "bet:alice:1187:0",
  "amount":           7,
  "currency":         "USD",
  "gameId":           "555",
  "roundId":          "crash:USD:1187"
}

// POST /rollback — give a stake back
{
  "partnerId":        "198",
  "token":            "abc123",          // MAY BE EXPIRED — see 8
  "transactionId":    "cancel:alice:1187:0",
  "betTransactionId": "bet:alice:1187:0",
  "amount":           2.5,
  "currency":         "USD",
  "roundId":          "crash:USD:1187",
  "reason":           "cancel"           // cancel | void | rollback
}

// POST /auth  y  POST /getBalance
{
  "partnerId":  "198",
  "operatorId": "brand-7",  // solo cuando el enlace nombró una marca
  "token":      "abc123",
  "currency":   "USD"       // solo getBalance; ausente en auth
}

// POST /bet
{
  "partnerId":     "198",
  "token":         "abc123",
  "transactionId": "bet:alice:1187:0",   // nuestro; único para siempre
  "amount":        2.5,
  "currency":      "USD",
  "gameId":        "555",                // SU id de catálogo
  "roundId":       "crash:USD:1187"
}

// POST /win — lo mismo, más la apuesta que paga
{
  "partnerId":        "198",
  "token":            "abc123",          // PUEDE ESTAR CADUCADO — véase 8
  "transactionId":    "take:alice:1187:0",
  "betTransactionId": "bet:alice:1187:0",
  "amount":           7,
  "currency":         "USD",
  "gameId":           "555",
  "roundId":          "crash:USD:1187"
}

// POST /rollback — devolver una apuesta
{
  "partnerId":        "198",
  "token":            "abc123",          // PUEDE ESTAR CADUCADO — véase 8
  "transactionId":    "cancel:alice:1187:0",
  "betTransactionId": "bet:alice:1187:0",
  "amount":           2.5,
  "currency":         "USD",
  "roundId":          "crash:USD:1187",
  "reason":           "cancel"           // cancel | void | rollback
}

// POST /auth  und  POST /getBalance
{
  "partnerId":  "198",
  "operatorId": "brand-7",  // nur wenn der Link eine Marke genannt hat
  "token":      "abc123",
  "currency":   "USD"       // nur getBalance; bei auth nicht vorhanden
}

// POST /bet
{
  "partnerId":     "198",
  "token":         "abc123",
  "transactionId": "bet:alice:1187:0",   // unsere; für immer eindeutig
  "amount":        2.5,
  "currency":      "USD",
  "gameId":        "555",                // IHRE Katalogkennung
  "roundId":       "crash:USD:1187"
}

// POST /win — dasselbe, plus der Einsatz, der ausgezahlt wird
{
  "partnerId":        "198",
  "token":            "abc123",          // KANN ABGELAUFEN SEIN — siehe 8
  "transactionId":    "take:alice:1187:0",
  "betTransactionId": "bet:alice:1187:0",
  "amount":           7,
  "currency":         "USD",
  "gameId":           "555",
  "roundId":          "crash:USD:1187"
}

// POST /rollback — einen Einsatz zurückgeben
{
  "partnerId":        "198",
  "token":            "abc123",          // KANN ABGELAUFEN SEIN — siehe 8
  "transactionId":    "cancel:alice:1187:0",
  "betTransactionId": "bet:alice:1187:0",
  "amount":           2.5,
  "currency":         "USD",
  "roundId":          "crash:USD:1187",
  "reason":           "cancel"           // cancel | void | rollback
}

// POST /auth  ja  POST /getBalance
{
  "partnerId":  "198",
  "operatorId": "brand-7",  // vain kun linkki nimesi brändin
  "token":      "abc123",
  "currency":   "USD"       // vain getBalance; puuttuu authista
}

// POST /bet
{
  "partnerId":     "198",
  "token":         "abc123",
  "transactionId": "bet:alice:1187:0",   // meidän; ikuisesti yksilöllinen
  "amount":        2.5,
  "currency":      "USD",
  "gameId":        "555",                // TEIDÄN luettelotunnuksenne
  "roundId":       "crash:USD:1187"
}

// POST /win — sama, plus panos jonka se maksaa
{
  "partnerId":        "198",
  "token":            "abc123",          // VOI OLLA VANHENTUNUT — katso 8
  "transactionId":    "take:alice:1187:0",
  "betTransactionId": "bet:alice:1187:0",
  "amount":           7,
  "currency":         "USD",
  "gameId":           "555",
  "roundId":          "crash:USD:1187"
}

// POST /rollback — panoksen palautus
{
  "partnerId":        "198",
  "token":            "abc123",          // VOI OLLA VANHENTUNUT — katso 8
  "transactionId":    "cancel:alice:1187:0",
  "betTransactionId": "bet:alice:1187:0",
  "amount":           2.5,
  "currency":         "USD",
  "roundId":          "crash:USD:1187",
  "reason":           "cancel"           // cancel | void | rollback
}

roundId собран из игры, валюты и номера раунда: каждая игра нумерует свои раунды сама, поэтому голый номер уникален только внутри одной игры — составной id не даёт пятому раунду двух разных игр слиться в ваших отчётах. roundId is composed of the game, the currency and the round number. Each game numbers its own rounds, so the bare number is unique only within one game — a composed id keeps round 5 of two different games apart in your reports. roundId se compone del juego, la moneda y el número de ronda. Cada juego numera sus propias rondas, así que el número a secas solo es único dentro de un juego — un id compuesto mantiene separadas la ronda 5 de dos juegos distintos en sus informes. roundId setzt sich aus Spiel, Währung und Rundennummer zusammen. Jedes Spiel nummeriert seine eigenen Runden, die nackte Zahl ist also nur innerhalb eines Spiels eindeutig — eine zusammengesetzte Kennung hält Runde 5 zweier verschiedener Spiele in Ihren Berichten auseinander. roundId koostuu pelistä, valuutasta ja kierrosnumerosta. Jokainen peli numeroi omat kierroksensa, joten paljas numero on yksilöllinen vain yhden pelin sisällä — yhdistetty tunnus pitää kahden eri pelin kierroksen 5 erillään raporteissanne.

Поля roundFinished больше нет. Раньше оно было в этих телах и всегда приходило false, потому что ни одна игра не могла заполнить его честно: у раунда нет закрывающего сообщения, проигранная ставка не шлёт ничего (см. 8), а /win закрывает ровно ту ставку, которую называет. There is no roundFinished. It used to be in these bodies and was always false, because nothing in the games could set it truthfully: a round has no closing message, a losing bet sends nothing at all (see 8), and a /win settles exactly the bet it names. No hay roundFinished. Antes estaba en estos cuerpos y siempre era false, porque nada en los juegos podía ponerlo con verdad: una ronda no tiene mensaje de cierre, una apuesta perdedora no envía nada en absoluto (véase 8), y un /win liquida exactamente la apuesta que nombra. Es gibt kein roundFinished. Es stand früher in diesen Bodies und war immer false, weil nichts in den Spielen es wahrheitsgemäß setzen konnte: eine Runde hat keine Abschlussmeldung, ein verlorener Einsatz sendet überhaupt nichts (siehe 8), und ein /win rechnet genau den Einsatz ab, den es nennt. roundFinished-kenttää ei ole. Se oli ennen näissä rungoissa ja oli aina false, koska mikään peleissä ei voinut asettaa sitä todenmukaisesti: kierroksella ei ole päätösviestiä, häviävä panos ei lähetä mitään (katso 8), ja /win selvittää täsmälleen sen panoksen jonka se nimeää.

6.2Что отвечаете выWhat you answerQué responde ustedWas Sie antwortenMitä te vastaatte

{
  "code":          0,
  "balance":       997.50,     // ПОСЛЕ операции
  "currency":      "USD",
  "transactionId": "bet:alice:1187:0",   // эхо нашего
  "message":       "",         // свободный текст, для человека в логах

  // только /auth:
  "playerId":      "p-1001",
  "username":      "alice"
}

{
  "code":          0,
  "balance":       997.50,     // AFTER the operation
  "currency":      "USD",
  "transactionId": "bet:alice:1187:0",   // echo ours
  "message":       "",         // free text, for humans reading logs

  // /auth only:
  "playerId":      "p-1001",
  "username":      "alice"
}

{
  "code":          0,
  "balance":       997.50,     // DESPUÉS de la operación
  "currency":      "USD",
  "transactionId": "bet:alice:1187:0",   // eco del nuestro
  "message":       "",         // texto libre, para humanos leyendo logs

  // solo /auth:
  "playerId":      "p-1001",
  "username":      "alice"
}

{
  "code":          0,
  "balance":       997.50,     // NACH der Operation
  "currency":      "USD",
  "transactionId": "bet:alice:1187:0",   // unsere zurückgespiegelt
  "message":       "",         // Freitext, für Menschen, die Logs lesen

  // nur /auth:
  "playerId":      "p-1001",
  "username":      "alice"
}

{
  "code":          0,
  "balance":       997.50,     // operaation JÄLKEEN
  "currency":      "USD",
  "transactionId": "bet:alice:1187:0",   // meidän tunnuksemme kaikuna
  "message":       "",         // vapaa teksti, lokeja lukeville ihmisille

  // vain /auth:
  "playerId":      "p-1001",
  "username":      "alice"
}

balance — баланс после операции, в той валюте, о которой спрашивали. На отказе присылайте баланс как есть, если он у вас под рукой: вам это ничего не стоит, а нам экономит вызов. balance is the balance after the operation, in the currency you were asked about. On a refusal send the unchanged balance if you have it: it costs you nothing and saves us a call. balance es el saldo después de la operación, en la moneda por la que se le preguntó. Ante un rechazo envíe el saldo sin cambios si lo tiene: no le cuesta nada y nos ahorra una llamada. balance ist der Saldo nach der Operation, in der Währung, nach der gefragt wurde. Bei einer Ablehnung senden Sie den unveränderten Saldo, wenn Sie ihn haben: es kostet Sie nichts und erspart uns einen Aufruf. balance on saldo operaation jälkeen, siinä valuutassa jota kysyttiin. Hylkäyksessä lähettäkää muuttumaton saldo jos se on tiedossa: se ei maksa teille mitään ja säästää meiltä yhden kutsun.

7КодыCodesCódigosCodesKoodit

Одна таблица на все методы. Что мы сделаем с кодом, зависит от того, в какую сторону шли деньги: отказ по списанию не двигает ничего и окончателен, а начисление — это деньги игрока, и попросить их ещё раз за нас уже некому. One table for every endpoint. What we do with a code depends on which way the money was going: refusing a debit moves nothing and is final, while a credit is money that belongs to the player, and nothing upstream of us will ask for it a second time. Una sola tabla para todos los endpoints. Lo que hacemos con un código depende de hacia dónde iba el dinero: rechazar un cargo no mueve nada y es definitivo, mientras que un abono es dinero que pertenece al jugador, y nada aguas arriba de nosotros lo pedirá una segunda vez. Eine Tabelle für alle Endpunkte. Was wir mit einem Code tun, hängt davon ab, in welche Richtung das Geld ging: eine abgelehnte Abbuchung bewegt nichts und ist endgültig, während eine Gutschrift Geld ist, das dem Spieler gehört — und niemand vor uns wird es ein zweites Mal anfordern. Yksi taulukko kaikille päätepisteille. Se mitä teemme koodilla riippuu siitä kumpaan suuntaan raha oli menossa: veloituksen hylkääminen ei siirrä mitään ja on lopullinen, kun taas hyvitys on pelaajalle kuuluvaa rahaa, eikä mikään meitä ylempänä pyydä sitä toista kertaa.

Незнакомый код и тело вообще без кода читаются ровно как 1. A code we do not know, and a body with no code at all, is read exactly like 1. Un código que no conocemos, y un cuerpo sin código alguno, se leen exactamente como 1. Ein Code, den wir nicht kennen, und ein Body ganz ohne Code werden genau wie 1 gelesen. Koodi jota emme tunne, ja runko jossa ei ole koodia lainkaan, luetaan täsmälleen kuin 1.

8ПравилаThe rulesLas reglasDie RegelnSäännöt

9ДеньгиMoneyDineroGeldRaha

Суммы — JSON-числа в мажорных единицах: 2.5 для 250 минорных единиц двухзначной валюты. JSON-число не хранит хвостовых нулей, поэтому 2.50 приходит как 2.5, а 10.00 — как 10. Разбирайте их как десятичные — не как float и не как строку заданного вида. Amounts are JSON numbers in major units: 2.5 for 250 minor units of a two-decimal currency. A JSON number keeps no trailing zeros, so 2.50 arrives as 2.5 and 10.00 as 10. Parse them as decimals — not as floats, and not as text of a fixed shape. Los importes son números JSON en unidades mayores: 2.5 para 250 unidades menores de una moneda de dos decimales. Un número JSON no conserva ceros finales, así que 2.50 llega como 2.5 y 10.00 como 10. Parséelos como decimales — no como floats, y no como texto de forma fija. Beträge sind JSON-Zahlen in Haupteinheiten: 2.5 für 250 Untereinheiten einer Währung mit zwei Nachkommastellen. Eine JSON-Zahl behält keine nachlaufenden Nullen, 2.50 kommt also als 2.5 an und 10.00 als 10. Parsen Sie sie als Dezimalzahlen — nicht als Floats und nicht als Text fester Form. Summat ovat JSON-lukuja pääyksiköissä: 2.5 tarkoittaa 250 alayksikköä kaksidesimaalisessa valuutassa. JSON-luku ei säilytä perässä olevia nollia, joten 2.50 saapuu muodossa 2.5 ja 10.00 muodossa 10. Jäsentäkää ne desimaalilukuina — ei liukulukuina eikä kiinteämuotoisena tekstinä.

У себя мы держим деньги целым числом минорных единиц и конвертируем один раз — здесь, на краю провода. Конвертация, которая потеряла бы долю минорной единицы, падает, а не округляет: мы не станем молча срезать часть выплаты и предпочтём, чтобы интеграция громко сломалась на тестах. We hold money as an integer count of minor units and convert once, here at the wire edge. A conversion that would lose a fraction of a minor unit fails rather than rounding — we will not silently shave value off a payout, and we would rather an integration break loudly during testing. Nosotros guardamos el dinero como un entero de unidades menores y convertimos una sola vez, aquí en el borde del cable. Una conversión que perdería una fracción de unidad menor falla en lugar de redondear — no vamos a recortar valor de un pago en silencio, y preferimos que una integración se rompa ruidosamente durante las pruebas. Wir halten Geld als ganzzahlige Anzahl von Untereinheiten und konvertieren genau einmal, hier am Rand der Leitung. Eine Konvertierung, die einen Bruchteil einer Untereinheit verlieren würde, schlägt fehl statt zu runden — wir werden von einer Auszahlung nicht stillschweigend Wert abschneiden, und uns ist eine Integration lieber, die im Test laut kaputtgeht. Me pidämme rahan kokonaislukuna alayksiköitä ja muunnamme vain kerran, tässä linjan reunalla. Muunnos joka menettäisi murto-osan alayksiköstä epäonnistuu sen sijaan että pyöristäisi — emme leikkaa arvoa maksusta äänettömästi, ja mieluummin integraatio hajoaa äänekkäästi testeissä.

12Таймауты и повторыTiming and retriesTiempos y reintentosZeiten und WiederholungenAikarajat ja uudelleenlähetykset

13Лимиты и лестница ставокLimits and the stake ladderLímites y la escala de apuestasLimits und die EinsatzleiterRajat ja panosportaikko

Лимиты обеспечиваем мы, по числам, которые выбираете вы. По каждой валюте и каждой игре у нас лежат: Limits are ours to enforce, from values you choose. Per currency and per game we hold: Los límites los aplicamos nosotros, a partir de valores que elige usted. Por moneda y por juego guardamos: Die Limits durchzusetzen ist unsere Sache, mit Werten, die Sie wählen. Pro Währung und pro Spiel halten wir: Rajojen valvonta on meidän tehtävämme, teidän valitsemistanne arvoista. Valuutta- ja pelikohtaisesti säilytämme:

• лестница ставок — суммы, которые может выбрать игрок. Она же задаёт минимальную и максимальную ставку: всё, что вне её, отклоняется ещё до вашего кошелька;
• максимальный выигрыш на ставку — максимум, который может вернуть одна ставка. Именно на ставку, а не на раунд, и применяется он ограничением РАУНДА, а не урезанием выплаты — см. примечание ниже.

• a stake ladder — the amounts a player can pick. It is also the minimum and the maximum stake: anything outside it is refused before it reaches your wallet;
• a maximum win per bet — the most a single bet can return. Per bet, not per round, and applied by capping the ROUND rather than by trimming a payout — see the note below.

• una escala de apuestas — los importes que un jugador puede elegir. Es también la apuesta mínima y la máxima: cualquier cosa fuera de ella se rechaza antes de llegar a su monedero;
• una ganancia máxima por apuesta — lo máximo que puede devolver una sola apuesta. Por apuesta, no por ronda, y aplicada limitando la RONDA en lugar de recortar un pago — véase la nota de abajo.

• eine Einsatzleiter — die Beträge, die ein Spieler wählen kann. Sie ist zugleich Mindest- und Höchsteinsatz: alles außerhalb wird abgelehnt, bevor es Ihr Wallet erreicht;
• einen Höchstgewinn pro Einsatz — das Meiste, was ein einzelner Einsatz zurückgeben kann. Pro Einsatz, nicht pro Runde, und umgesetzt, indem die RUNDE begrenzt wird statt eine Auszahlung zu beschneiden — siehe die Anmerkung unten.

• panosportaikko — summat joista pelaaja voi valita. Se on myös pienin ja suurin panos: kaikki sen ulkopuolinen hylätään ennen kuin se saapuu lompakkoonne;
• enimmäisvoitto panosta kohden — eniten mitä yksi panos voi palauttaa. Panosta, ei kierrosta kohden, ja toteutettu rajoittamalla KIERROSTA eikä leikkaamalla maksua — katso alla oleva huomautus.

Пришлите нужные числа по каждой валюте — мы их выставим; поменять потом это конфигурация у нас, а не релиз. Отказать в ставке вы, разумеется, можете и сами — кодом 5. Send us the numbers you want, per currency, and we set them; changing them later is configuration on our side, not a release. You may of course refuse a stake yourself with code 5. Envíenos los números que quiera, por moneda, y los fijamos; cambiarlos después es configuración de nuestro lado, no una entrega. Por supuesto, usted puede rechazar una apuesta por su cuenta con el código 5. Schicken Sie uns die gewünschten Zahlen, je Währung, und wir setzen sie; sie später zu ändern ist Konfiguration auf unserer Seite, kein Release. Sie können einen Einsatz natürlich auch selbst mit Code 5 ablehnen. Lähettäkää meille haluamanne luvut valuutoittain, niin asetamme ne; niiden muuttaminen myöhemmin on konfiguraatio meidän puolellamme, ei julkaisu. Voitte tietysti torjua panoksen itsekin koodilla 5.

10Чек-листChecklistLista de comprobaciónChecklisteTarkistuslista

Интеграция готова, когда выполняется всё перечисленное.Your integration is done when all of these hold.Su integración está terminada cuando se cumplen todos estos puntos.Ihre Integration ist fertig, wenn alle diese Punkte zutreffen.Integraationne on valmis kun kaikki nämä pitävät paikkansa.

1. /auth с валидным токеном возвращает игрока, валюту и баланс./auth with a valid token returns the player, the currency and a balance./auth con un token válido devuelve el jugador, la moneda y un saldo./auth mit einem gültigen Token liefert den Spieler, die Währung und einen Saldo./auth kelvollisella tunnisteella palauttaa pelaajan, valuutan ja saldon.
2. /bet уменьшает баланс ровно на сумму./bet decreases the balance by exactly the amount./bet reduce el saldo exactamente en el importe./bet verringert den Saldo genau um den Betrag./bet vähentää saldoa täsmälleen summan verran.
3. /win увеличивает его ровно на сумму./win increases it by exactly the amount./win lo aumenta exactamente en el importe./win erhöht ihn genau um den Betrag./win kasvattaa sitä täsmälleen summan verran.
4. Один и тот же transactionId дважды не двигает деньги дважды, и второй ответ — 110.The same transactionId twice does not move money twice, and the second answer is 110.El mismo transactionId dos veces no mueve dinero dos veces, y la segunda respuesta es 110.Dieselbe transactionId zweimal bewegt kein Geld zweimal, und die zweite Antwort ist 110.Sama transactionId kahdesti ei siirrä rahaa kahdesti, ja toinen vastaus on 110.
5. /rollback восстанавливает баланс, а его повтор отвечает 110./rollback restores the balance, and a repeat of it answers 110./rollback restaura el saldo, y una repetición responde 110./rollback stellt den Saldo wieder her, und eine Wiederholung antwortet 110./rollback palauttaa saldon, ja sen toisinto vastaa 110.
6. /win и /rollback работают на просроченном токене./win and /rollback work with an expired token./win y /rollback funcionan con un token caducado./win und /rollback funktionieren mit einem abgelaufenen Token./win ja /rollback toimivat vanhentuneella tunnisteella.
7. /rollback неизвестного betTransactionId отвечает 7./rollback of an unknown betTransactionId answers 7./rollback de un betTransactionId desconocido responde 7./rollback einer unbekannten betTransactionId antwortet 7.Tuntemattoman betTransactionId:n /rollback vastaa 7.
8. Ставка больше баланса отвечает 3, и баланс не меняется.A bet larger than the balance answers 3, and the balance is unchanged.Una apuesta mayor que el saldo responde 3, y el saldo no cambia.Ein Einsatz größer als der Saldo antwortet 3, und der Saldo bleibt unverändert.Saldoa suurempi panos vastaa 3, eikä saldo muutu.
9. /win с нулевой суммой принят.A zero-amount /win is accepted.Un /win de importe cero se acepta.Ein /win mit Betrag null wird angenommen.Nollan suuruinen /win hyväksytään.
10. 2.5 на проводе — это 250 минорных единиц в вашем реестре, в обе стороны.2.5 on the wire is 250 minor units in your ledger, both ways.2.5 en el cable son 250 unidades menores en su libro mayor, en ambos sentidos.2.5 auf der Leitung sind 250 Untereinheiten in Ihrem Hauptbuch, in beide Richtungen.2.5 linjalla on 250 alayksikköä kirjanpidossanne, molempiin suuntiin.
11. /bet с идентификатором, который вы уже откатили, не двигает денег и отвечает 110.A /bet whose id you have already rolled back moves nothing and answers 110.Un /bet cuyo id ya ha revertido no mueve nada y responde 110.Ein /bet, dessen Kennung Sie bereits zurückgebucht haben, bewegt nichts und antwortet 110./bet jonka tunnuksen olette jo palauttaneet ei siirrä mitään ja vastaa 110.
12. Запрос с неверным дайджестом в Auth отвергается.A request with a wrong Auth digest is refused.Una petición con un resumen Auth incorrecto se rechaza.Eine Anfrage mit falschem Auth-Digest wird abgelehnt.Pyyntö jossa on väärä Auth-tiiviste hylätään.

Четвёртый и шестой — те, что падают в проде. Проверить их дёшево, а обнаружить дорого. Numbers 4 and 6 are the ones that fail in production. They are cheap to test and expensive to discover. Los números 4 y 6 son los que fallan en producción. Son baratos de probar y caros de descubrir. Die Nummern 4 und 6 sind die, die in Produktion scheitern. Sie sind billig zu testen und teuer zu entdecken. Kohdat 4 ja 6 ovat ne jotka pettävät tuotannossa. Niiden testaaminen on halpaa ja löytäminen kallista.

11Что прислать намWhat to send usQué enviarnosWas Sie uns schickenMitä lähetätte meille

Если что-то из этого потом поменяется — всё это конфигурация на нашей стороне. Ни один пункт не требует деплоя. If any of it changes later, all of it is configuration on our side. None of it is a deploy. Si algo de esto cambia más adelante, todo ello es configuración de nuestro lado. Nada de ello es un despliegue. Wenn sich später etwas davon ändert, ist alles davon Konfiguration auf unserer Seite. Nichts davon ist ein Deployment. Jos jokin näistä muuttuu myöhemmin, kaikki se on konfiguraatiota meidän puolellamme. Mikään siitä ei ole julkaisu.