Para operadores & plataformas

Integre uma vez.
Lance tudo.

Um endpoint de catálogo, um URL de lançamento, um contrato de carteira seamless. A carteira fica consigo; os jogos ficam connosco. Todos os títulos que publicarmos depois de integrar aparecem simplesmente no seu feed — sem trabalho novo do seu lado.

Pedir a especificação completa Ver os jogos

Os programadores confiam em código que podem ler, não num diagrama de código. Esta é toda a superfície de uma integração Stackwell.

play.stackwell-solutions.com
1 · Obter o catálogo
GET https://play.stackwell-solutions.com/catalog/{operator}
Authorization: Bearer <your inbound credential secret>
2 · Lançar um mosaico
https://play.stackwell-solutions.com/play/{operator}
  ?token=<vendor_token>
  &game=<vendor_game_id>
  &currency=EUR
  &mode=real
3 · O dinheiro move-se de servidor para servidor
POST /seamless/{your_slug}/{debit,credit,void,balance}
X-Signature: HMAC-SHA256(body, outbound credential secret)
A carteira é sua
Cada debit é seguido de exatamente um credit — um ganho, ou "0.00" — ou de um void. Nunca ambos, nunca nenhum.
Idempotente por construção
vendor_round_id é estável por ronda; vendor_transaction_id é único por movimento. Repita um 5xx com os mesmos ids e nada é cobrado duas vezes.
A ativação é nossa
Integra uma vez. Os jogos que pode lançar são controlados do nosso lado, por isso um título novo não lhe dá trabalho nenhum.

1 · Onboarding

Registamo-lo como operador e ativamos-lhe jogos específicos. Recebe o seu slug {operator}, as suas credenciais de integração — uma chave de entrada e uma chave de saída, cada uma com um kid mais um segredo HMAC — e a lista de jogos ativados, cada um com um vendor_game_id. Indica-nos o URL base do seu gateway seamless e coloca o nosso IP de saída na sua allowlist.

2 · Construa o seu lobby — o feed de catálogo

Obtenha os jogos que lhe estão ativados e apresente os mosaicos. O feed traz tudo o que um lobby precisa: o nome do jogo, o seu RTP, a grelha, um URL de miniatura e um modelo de URL de lançamento pronto a usar.

GET https://play.stackwell-solutions.com/catalog/{operator}
Authorization: Bearer <your inbound credential secret>

O bearer é o segredo de uma credencial de entrada ativa. Durante uma rotação de chaves, duas das suas chaves de entrada estão ativas em simultâneo e qualquer um dos segredos é aceite, pelo que a troca nunca tem de ser simultânea dos dois lados.

3 · Lançar um jogo

Quando um jogador abre um mosaico, gere um vendor_token opaco do seu lado e abra o URL de lançamento — em iframe ou por redirecionamento. Validamos o operador e a ativação, e servimos o runtime do jogo.

https://play.stackwell-solutions.com/play/{operator}
  ?token=<vendor_token>&game=<vendor_game_id>
  &currency=EUR&mode=real

mode é real ou demo — o caminho de demo corre o jogo completo de ponta a ponta sem chamadas à carteira, que é exatamente o que são as demos jogáveis deste site.

4 · O dinheiro move-se de servidor para servidor

Chamamos o seu gateway — debit, credit, void, balance — com cada pedido assinado em HMAC-SHA256 sobre o corpo exato com o segredo da sua credencial de saída. As funcionalidades resolvem-se dentro de uma única rodada e reduzem-se a um só credit, pelo que a contabilidade das suas rondas continua simples.

Segurança

  • Todas as chamadas por HTTPS. Os segredos das suas credenciais ficam do lado do servidor — nunca são expostos a um browser.
  • Colocamos o seu gateway na nossa allowlist; coloque o nosso IP de saída na sua.
  • Os resultados são calculados no nosso servidor. O cliente apresenta; não decide.

O modo demo de todos os jogos está no ar neste site agora mesmo — o mesmo runtime que um operador integra.