Como funcionam os rollbacks da API de cassino?
Por que rollbacks existem
Estúdios e agregadores devem reverter uma aposta ou ganho quando uma rodada é anulada, uma mesa falha no meio da mão ou um evento duplicado é detectado. Sem um caminho claro de rollback, saldos de jogadores e ledgers de agentes divergem — o jeito mais rápido de queimar confiança com financeiro e suporte.
Como projetar para rollbacks
Trate cada mutação de carteira como idempotente. Seus endpoints Seamless (ou o ledger de sessão Transfer) devem aceitar um rollback chaveado pelo id original da transação / rodada e retornar sucesso se a reversão já foi aplicada. Nunca credite ou debite em dobro porque um callback tentou de novo.
Documente o happy path e o caminho de rollback no mesmo lugar em que sua equipe mantém amostras Swagger e o guia de integração PDF.
Comportamento Transfer vs Seamless
- Transfer: saldos com escopo de sessão tornam alguns voids mais fáceis de reconciliar como ajustes de carteira na borda do jogo, mas você ainda deve aplicar reverses originados do estúdio corretamente.
- Seamless: rollbacks chegam como callbacks de carteira; seu serviço deve responder rápido e de forma consistente a partir da região MegaNodes que você usa (kr / de / ca).
Detalhes dos dois modelos: modelos de carteira.
Visibilidade operacional
Use o histórico de jogos do BackOffice — aposta, ganho, Bonus Call, timestamps — para investigar disputas após uma tempestade de rollbacks. Atividade de RTP e Bonus Call no escopo do agente deve ser separável do jogo orgânico. Mapa de recursos: Features.
Checklist de testes
- Reproduza o mesmo rollback duas vezes; afirme um único efeito líquido.
- Anule após sequências de ganho parcial.
- Confirme que fusos de relatório batem com o calendário financeiro.
- Verifique que limites de demo diário/sessão nunca se passam por regras de rollback de produção.
Precisa de um walkthrough contra seu middleware: Contact. Contexto comercial: Pricing.