카지노 API 롤백은 어떻게 동작하나요?
롤백이 존재하는 이유
라운드가 무효화되거나, 핸드 중 테이블이 실패하거나, 중복 이벤트가 감지되면 스튜디오와 애그리게이터는 베팅·당첨을 되돌려야 합니다. 명확한 롤백 경로가 없으면 플레이어 잔액과 에이전트 원장이 어긋나며, 재무·고객지원 신뢰를 가장 빨리 깎습니다.
롤백을 위한 설계
모든 지갑 변경을 멱등하게 다루세요. Seamless 엔드포인트(또는 Transfer 세션 원장)는 원거래/라운드 id로 롤백을 받아, 이미 반영됐다면 성공을 반환해야 합니다. 콜백 재시도 때문에 이중 입금·이중 출금이 일어나면 안 됩니다.
해피 패스와 롤백 패스를 팀이 유지하는 Swagger 샘플·PDF 연동 가이드와 같은 곳에 문서화하세요.
Transfer vs Seamless 동작
- Transfer: 세션 범위 잔액은 일부 무효화를 플레이 경계의 지갑 조정으로 맞추기 쉽지만, 스튜디오 발 리버스는 여전히 정확히 반영해야 합니다.
- Seamless: 롤백이 지갑 콜백으로 도착합니다. 사용하는 MegaNodes 리전(kr / de / ca)에서 빠르고 일관되게 응답해야 합니다.
두 모델 상세: 지갑 모델.
운영 가시성
롤백 폭주 후 분쟁을 조사할 때 BackOffice 게임 히스토리(베팅, 당첨, Bonus Call, 타임스탬프)를 사용하세요. 에이전트 단위 RTP·Bonus Call 활동은 일반 플레이와 구분 가능해야 합니다. 기능 맵: Features.
테스트 체크리스트
- 동일 롤백을 두 번 재생하고 순효과가 한 번인지 확인합니다.
- 부분 당첨 시퀀스 이후 무효화를 검증합니다.
- 리포팅 타임존이 재무 캘린더와 일치하는지 확인합니다.
- 데모 일일/세션 한도가 프로덕션 롤백 규칙처럼 보이지 않게 합니다.