¿Cómo funcionan los rollbacks de la API de casino?
Por qué existen los rollbacks
Estudios y agregadores deben revertir una apuesta o un premio cuando una ronda se anula, una mesa falla a mitad de mano o se detecta un evento duplicado. Sin una ruta clara de rollback, los saldos de jugadores y los ledgers del agente divergen — la forma más rápida de quemar confianza con finanzas y soporte.
Cómo diseñar para rollbacks
Trate cada mutación de wallet como idempotente. Sus endpoints Seamless (o el ledger de sesión Transfer) deben aceptar un rollback claveado por el id de transacción / ronda original y devolver éxito si la inversa ya se aplicó. Nunca acredite ni debite dos veces porque un callback se reintentó.
Documente el happy path y la ruta de rollback en el mismo lugar donde su equipo guarda muestras de Swagger y la guía de integración PDF.
Comportamiento Transfer vs Seamless
- Transfer: los saldos con alcance de sesión facilitan reconciliar algunos voids como ajustes de wallet al borde del juego, pero aún debe aplicar correctamente los reverses originados en el estudio.
- Seamless: los rollbacks llegan como callbacks de wallet; su servicio debe responder rápido y de forma consistente desde la región MegaNodes que usa (kr / de / ca).
Detalles de ambos modelos: wallet models.
Visibilidad ops
Use el historial de juego de BackOffice — bet, win, Bonus Call, timestamps — para investigar disputas tras una tormenta de rollbacks. La actividad agent-scoped de RTP y Bonus Call debe ser separable del juego orgánico. Mapa de funciones: Features.
Checklist de pruebas
- Reproduzca el mismo rollback dos veces; afirme un único efecto neto.
- Anule tras secuencias de win parcial.
- Confirme que las zonas horarias de reporting coinciden con su calendario financiero.
- Verifique que los límites demo diario/sesión nunca se disfracen de reglas de rollback de producción.
Necesita un walkthrough contra su middleware: Contact. Contexto comercial: Pricing.