Conectá el truco a tu plataforma sin sacar al jugador ni tocar tu billetera core. Lanzamiento por SSO, reserva y liquidación de saldo, webhooks firmados y un entorno sandbox para probar de punta a punta.
Sumar un juego externo suele significar otra cuenta para el jugador, otra billetera para conciliar y riesgo sobre el movimiento de dinero. Truco Digital se integra al revés: el jugador entra con su sesión del casino (SSO) y juega con el saldo que ya tiene. El dinero se reserva antes de repartir y se liquida una sola vez, con webhooks firmados y operaciones idempotentes.
Cómo funciona la integración
Cómo funciona la integración
Autenticación del operador
Cada operador recibe credenciales y un entorno aislado. Las llamadas se autentican y las notificaciones de dinero viajan firmadas.
Inicio de sesión por SSO
El jugador entra desde tu casino con su sesión activa, mediante SSO o token de lanzamiento. No crea una cuenta adicional.
Reserva y liquidación de saldo
Consulta de saldo, reserva del monto antes de la mano y liquidación automática con comisión configurable. Sin doble débito ni doble pago.
Webhooks e idempotencia
Webhooks firmados para cada movimiento y claves de idempotencia: reintentar una operación nunca la duplica.
Ejemplo ilustrativo · lanzamiento + webhook de liquidación
# 1) El casino lanza la sesión del jugador (SSO)POST /v1/sessions
{ "operator": "casino_demo", "player_ref": "u_92831",
"currency": "PYG", "table": "1v1" }
# 2) Truco Digital notifica la liquidación (webhook firmado, idempotente)POST https://casino.example/webhooks/truco
X-Signature: t=...,v1=...
{ "event": "round.settled", "idempotency_key": "rnd_5f3a...",
"pot": 20000, "commission": 1000, "winner_ref": "u_92831" }
Especificaciones
Especificaciones técnicas
Característica
Detalle
Autenticación
Credenciales por operador · llamadas autenticadas · webhooks firmados
Lanzamiento
SSO / token de lanzamiento · el jugador no crea cuenta nueva
Billetera
Consulta de saldo · reserva del monto apostado · débito y crédito
Liquidación
Automática al cierre de la mano · comisión configurable · única e idempotente
Webhooks
Notificación firmada de cada movimiento de dinero y resultado de partida
Sandbox con fichas sin valor + casino de ejemplo que se corre con un comando
Capturas reales del producto
Billetera por API
El saldo vive en el casino y se sincroniza.
Liquidación idempotente
Pozo, comisión de la plataforma y premio, una sola vez.
Preguntas frecuentes
Preguntas frecuentes
¿API, iframe o integración nativa?
Soportamos API REST, SDK web, iframe embebido y SSO / token de lanzamiento. La mayoría de los operadores lanza por SSO + iframe/SDK y mueve el dinero por API con webhooks firmados.
¿El jugador necesita otra cuenta?
No. Entra con su sesión del casino por SSO y juega con su saldo habitual; nunca sale de tu plataforma.
¿Qué significa que la liquidación es idempotente?
Que cada partida se paga una sola vez aunque una notificación se reintente. Las operaciones llevan una clave de idempotencia y el ledger evita el doble débito o doble pago.
¿Puedo probar antes de integrar en producción?
Sí. Entregamos un entorno sandbox con fichas sin valor monetario y un casino de ejemplo funcional para validar el flujo completo de dinero.
¿Cuánto tarda una integración?
El ejemplo contra el sandbox suele levantarse en menos de un día; una integración completa con billetera, webhooks y marca ronda las semanas, según el equipo del operador.
Siguiente paso
Llevá el truco a tu plataforma.
Coordiná una demostración técnica y comercial, o pedí la documentación de integración para tu equipo.
Aviso regulatorio: las demostraciones operan con créditos ficticios. La habilitación de dinero real queda sujeta a la regulación y autorización aplicable en cada jurisdicción. Truco Digital provee la tecnología; la licencia y el cumplimiento corresponden a cada operador.
