게임사가 늘어도 파트너 쪽 코드는 그대로입니다. 그 약속을 지키기 위해 GG Labs가 어떻게 구성돼 있는지, 검증 가능한 것만 적었습니다.
심리스 방식 기준입니다. 파트너 플랫폼은 GG Labs 하나만 상대하고, 게임사별 차이는 가운데 레이어가 흡수합니다.
트랜스퍼 방식은 베팅 단계의 콜백이 없습니다. 유저가 게임에 들어갈 때 잔액을 게임사 지갑으로 옮기고, 나올 때 되돌려 받습니다. 어느 쪽이든 파트너가 구현하는 규격은 GG Labs 것 하나입니다.
어느 쪽을 고를지는 파트너의 지갑 구조가 정합니다. 운영 중에 바꿔도 게임사를 다시 붙이지 않습니다.
| Seamless | Transfer | |
|---|---|---|
| 유저 잔액이 있는 곳 | 파트너 플랫폼 지갑. GG Labs는 중계만 합니다. | 플레이 중에는 게임사 지갑. 입장·퇴장 시 이체. |
| 파트너가 구현하는 것 | 잔액 조회, 차감, 적립 콜백 3종 | 입금, 출금 API 2종 |
| 잔액 반영 | 베팅마다 실시간 | 이체 시점 |
| 맞는 경우 | 여러 게임사를 동시에 운영하고 유저 잔액을 한 곳에서 관리하고 싶을 때 | 기존 지갑 구조를 바꾸기 어렵거나 빠르게 열어야 할 때 |
| 방식 전환 | 운영 중 전환 가능. 파트너 쪽 콜백만 추가·제거하면 되고, 게임사 연동은 그대로입니다. | |
파트너 개발팀이 첫 미팅 전에 알고 싶어 하는 것들입니다.
| 프로토콜 | REST(JSON) 요청·응답, WebSocket으로 게임·트랜잭션 이벤트 수신 |
|---|---|
| 인증 | 파트너별 API 키와 요청 서명(HMAC). 운영 환경은 IP 허용 목록 필수 |
| 환경 | Sandbox와 Production 분리. 규격은 동일하고 키만 다릅니다 |
| 문서 | OpenAPI 명세, 콜백 예제, 테스트 시나리오. 계약 전 열람 가능 |
| 이벤트 | 베팅 체결, 정산, 게임 상태 변경을 웹훅으로 전달 |
| 통화 | KRW, USD, JPY, PHP, THB, VND. 게임사 지원 범위에 따라 다름 |
| 정산 데이터 | 일 단위 리포트 파일과 API 조회. 게임사별 포맷을 단일 스키마로 변환 |
| 모니터링 | 게임사별 응답 시간·오류율 상시 관측. 임계치 초과 시 파트너에게 선제 알림 |
인증 배지 대신 실제로 하는 일을 적었습니다.
게임사별 응답 시간과 오류율을 상시 관측합니다. 임계치를 넘으면 파트너가 알아채기 전에 먼저 알립니다.
원인, 영향 범위, 복구 예상 시점을 접수 즉시 공유하고, 종료 후 보고서를 남깁니다.
베팅과 정산 단위로 감사 로그를 보관합니다. 분쟁이 생기면 파트너와 게임사가 같은 기록을 봅니다.
모든 구간은 TLS, 저장 데이터는 암호화합니다. 키는 서비스와 분리해 관리합니다.
콘솔·API·운영 시스템의 권한을 역할별로 분리하고, 모든 접근을 기록합니다.
정기 백업과 복구 리허설을 합니다. 목표 복구 시간은 계약서에 숫자로 넣습니다.