Para operadores y plataformas

Integre una vez.
Lánzelo todo.

Un endpoint de catálogo, una URL de lanzamiento, un contrato de monedero seamless. Usted se queda con el monedero; nosotros, con los juegos. Cada título que publiquemos después de que se integre aparece sin más en su feed, sin trabajo nuevo por su parte.

Solicite la especificación completa Ver los juegos

Los desarrolladores confían en el código que pueden leer, no en un diagrama del código. Esta es toda la superficie de una integración con Stackwell.

play.stackwell-solutions.com
1 · Descargar el catálogo
GET https://play.stackwell-solutions.com/catalog/{operator}
Authorization: Bearer <your inbound credential secret>
2 · Lanzar una tarjeta
https://play.stackwell-solutions.com/play/{operator}
  ?token=<vendor_token>
  &game=<vendor_game_id>
  &currency=EUR
  &mode=real
3 · El dinero se mueve de servidor a servidor
POST /seamless/{your_slug}/{debit,credit,void,balance}
X-Signature: HMAC-SHA256(body, outbound credential secret)
El monedero es suyo
A cada debit le sigue exactamente un credit —una ganancia o "0.00"— o un void. Nunca los dos, nunca ninguno.
Idempotente por diseño
vendor_round_id es estable por ronda; vendor_transaction_id es único por movimiento. Reintente un 5xx con los mismos identificadores y nada se cobra dos veces.
La habilitación es nuestra
Usted se integra una sola vez. Qué juegos puede lanzar se controla en nuestro lado, así que un título nuevo no le exige ningún trabajo.

1 · Alta

Le registramos como operador y le habilitamos juegos concretos. Recibirá su slug {operator}, sus credenciales de integración —una clave entrante y una clave saliente, cada una con un kid y un secreto HMAC— y la lista de juegos habilitados, cada uno con un vendor_game_id. Usted facilita la URL base de su gateway seamless y añade nuestra IP de salida a su lista de permitidos.

2 · Monte su lobby — el feed del catálogo

Descargue los juegos que tiene habilitados y renderice las tarjetas. El feed lleva todo lo que necesita un lobby: el nombre del juego, su RTP, la cuadrícula, una URL de miniatura y una plantilla de URL de lanzamiento ya preparada.

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

El bearer es el secreto de una credencial entrante activa. Durante una rotación de claves hay dos claves entrantes suyas activas a la vez y se acepta cualquiera de los dos secretos, así que el cambio nunca tiene que ser simultáneo en ambos lados.

3 · Lance un juego

Cuando un jugador abre una tarjeta, genere un vendor_token opaco en su lado y abra la URL de lanzamiento, en iframe o por redirección. Validamos el operador y la habilitación, y servimos el runtime del juego.

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

mode es real o demo: la vía de demo ejecuta el juego completo de extremo a extremo sin ninguna llamada al monedero, que es exactamente lo que son las demos jugables de esta web.

4 · El dinero se mueve de servidor a servidor

Llamamos a su gateway —debit, credit, void, balance— con cada petición firmada con HMAC-SHA256 sobre el cuerpo exacto y el secreto de su credencial saliente. Las funciones se resuelven dentro de una única tirada y se agrupan en un solo credit, de modo que su contabilidad de rondas sigue siendo sencilla.

Seguridad

  • Todas las llamadas por HTTPS. Los secretos de sus credenciales permanecen en el servidor: nunca se exponen a un navegador.
  • Nosotros añadimos su gateway a la lista de permitidos; usted añade nuestra IP de salida a la suya.
  • Los resultados se calculan en nuestro servidor. El cliente renderiza; no decide.

El modo demo de todos los juegos está activo en esta web ahora mismo: el mismo runtime que integra un operador.