라이브 카지노 API 연동
elite의 라이브 테이블을 플레이어에게 제공하는 방법은 두 가지입니다. 이미 회원·월렛 시스템을 운영하는 운영사는 라이브 딜러 API로 연동하고, 그런 시스템이 없는 운영사는 자체 도메인에 브랜드 로그인 사이트를 엽니다. 두 방식 모두 같은 테이블, Console, 과금 체계를 사용합니다. 바카라, 드래곤 타이거, 텍사스 홀덤, 니우니우가 모두 같은 API를 쓰므로 새 게임이 추가되어도 연동을 새로 할 필요가 없습니다.
두 가지 오픈 방식
| API 연동 | 브랜드 로그인 사이트 | |
|---|---|---|
| 적합한 운영사 | 자체 회원·월렛 시스템이 있는 운영사 | 자체 회원 시스템이 없는 운영사 |
| 플레이어 계정 | 플레이어가 처음 게임을 실행하거나 처음 입금될 때 자동 생성 | Console에서 생성, 플레이어는 아이디와 비밀번호로 로그인 |
| 잔액 | 트랜스퍼 월렛 API로 입금·출금 | Console에서 조정 |
| 진입 경로 | 귀사 사이트나 앱에서 리디렉션 또는 iframe | 귀사 도메인(정식 플랜), 템플릿 4종 중 선택 |
| 개발 | 서버 측 연동 필요 | 필요 없음 |
라이브 딜러 API 한눈에 보기
| 영역 | 제공 내용 |
|---|---|
| 서명 | 모든 요청에 HMAC-SHA256 서명(X-Api-Key, X-Timestamp, X-Nonce, X-Signature). 타임스탬프는 ±300초 이내, nonce는 재사용 불가, IP 화이트리스트는 선택 사항 |
| 게임 실행 | POST /player/launch가 60초간 유효한 일회용 URL을 반환하며, 로비나 지정한 테이블로 입장합니다. PC 또는 모바일 레이아웃, 9개 언어, 리디렉션 또는 iframe 지원 |
| 트랜스퍼 월렛 | 입금, 출금, 이체 조회, 잔액 조회. txnId로 모든 이체의 멱등성 보장 |
| 베팅 내역 동기화 | 커서 기반 GET /bets. 정정과 무효 처리는 같은 베팅 슬립의 새 리비전으로 전달되며, 플레이어별 일일 요약도 제공 |
| Webhook | 정산·정정·무효 처리된 라운드, 강제 로그아웃된 플레이어, 계정 변경 시 서명된 POST 전송, 약 24시간 재시도(정식 플랜과 샌드박스) |
| 테이블과 계정 | 테이블 목록 조회와 활성화·비활성화, 라운드 결과 조회, 선불 크레딧과 일일 사용량 확인 |
표의 링크는 영문 API 문서로 연결됩니다.
서버 간 호출 전용
API는 귀사 백엔드에서 호출합니다. 시크릿은 브라우저나 앱에 절대 넣지 마세요.
트랜스퍼 월렛 API 작동 방식
플레이어마다 elite에 게임 월렛이 하나씩 있습니다. 귀사 시스템은 POST /wallet/deposit으로 입금하고 POST /wallet/withdraw로 출금합니다. 게임 안에서는 베팅이 접수될 때 베팅액이 차감되고, 지급·정정·무효 처리 금액은 자동으로 반영되므로 잔액은 항상 사용 가능한 잔액입니다.
- 이체는 단일 단계로 처리됩니다. 성공 응답을 받았다면 이체가 완료된 것입니다.
txnId는 귀사의 이체 ID이자 멱등성 키입니다. 타임아웃이 발생하면 같은txnId와 같은 내용으로 다시 보내거나 이체를 조회하세요. 새txnId로 재시도하면 안 됩니다.- 금액은 소수점 넷째 자리까지의 10진수 문자열이며, 플레이어의 통화는 플레이어를 생성할 때 고정됩니다.
라이브 카지노 연동 단계
- 가입: 테스트 통화가 들어 있는 연결된 샌드박스 테넌트와 함께 샌드박스 API 키와 라이브 API 키를 받습니다(빠른 시작(영문)).
- 첫 서명 호출:
GET /tables를 호출합니다. 서명이 맞지 않으면 서명 디버거(영문)에서 입력값을 비교하세요(인증과 서명(영문)). - 게임 실행: 귀사 백엔드에서 테스트 플레이어를 입장시킵니다(게임 실행(영문)).
- 입출금: 타임아웃 후 재시도를 포함해 입금과 출금을 처리합니다(트랜스퍼 월렛(영문)).
- 베팅 내역 동기화:
(slipId, rev)를 키로 귀사 데이터베이스에 저장합니다(베팅 내역 동기화(영문)). - Webhook 추가: 정산 소식을 더 빨리 받을 수 있습니다. 기준 데이터는 여전히
GET /bets입니다(Webhook(영문)). - 오픈: Console의 오픈 체크리스트가 샌드박스 키로 서명 호출, 게임 실행, 입금, 출금, 베팅 내역 동기화를 실행합니다. 이후 같은 호스트에서 라이브 키로 바꾸고 IP 화이트리스트를 설정한 뒤, 크레딧을 충전해 정식 플랜으로 업그레이드합니다.
샌드박스, OpenAPI, Postman, 서명 디버거
- 샌드박스: 과금되지 않으며 테스트 플레이어 최대 500명, 초당 20회 요청을 지원합니다. 샌드박스 Webhook도 전송됩니다.
- OpenAPI 3.1 명세(YAML, JSON): API 레퍼런스(영문)의 원본입니다.
- Postman 컬렉션: 영어와 번체 중국어 버전이 있으며 서명 스크립트가 내장되어 있습니다.
- 서명 디버거: 브라우저에서 API와 Webhook 서명을 단계별로 계산하며, 시크릿은 전송되지 않습니다.
- 서명 예제: Node.js, PHP, C#, Java, Python, Go.
모두 도구와 다운로드(영문)에서 받을 수 있습니다.
요청 한도
| 플랜 | 초당 요청 수 | 순간 최대 |
|---|---|---|
| 정식 플랜 | 100 | 200 |
| 샌드박스 | 20 | 40 |
| 무료 데모 플랜 | 5 | 10 |
한도는 테넌트별로 적용됩니다. 한도를 넘으면 429 RATE_LIMITED가 반환되므로, 잠시 기다렸다가 새 nonce로 재시도하세요. 베팅 내역은 한 건씩 조회하지 말고 최대 1,000건 단위의 페이지로 읽으세요. 자세한 내용은 요청 한도와 할당량(영문)을 참고하세요.
화이트라벨 옵션: 자체 도메인의 브랜드 로그인 사이트
개발 인력이 없어도 귀사 브랜드로 오픈할 수 있습니다.
- Console에서 플레이어 계정을 만들고, 잔액도 Console에서 조정합니다.
- 귀사 도메인(예:
play.yourbrand.com)을 CNAME 레코드로 elite에 연결합니다. - 브랜딩 및 로그인 → 사용자 지정 사이트에서 템플릿 4종 중 하나를 선택합니다. 로비, 테이블 화면, 로딩 화면의 elite 로고가 귀사 로고로 바뀌며, 플레이어는 사이트를 홈 화면에 추가할 수 있습니다.
- 사용자 지정 사이트는 정식 플랜에서 제공됩니다. 자체 도메인이 없을 때는 플레이어가 elite의 공용 로그인 페이지에서 로그인할 수도 있습니다.
자체 테이블도 운영하나요?
테이블도 귀사의 것이라면 라운드 결과를 위한 별도 인터페이스가 있습니다. 귀사의 결과 시스템이 서명된 라운드 이벤트를 푸시하는 GFI(영문)이며, 딜러 태블릿과 EWIN AI VISION도 함께 쓸 수 있습니다. 라이브 바카라 솔루션, 라이브 드래곤 타이거, 홀덤, 니우니우, 라이브 카지노 스튜디오 구축 방법을 참고하세요.
자주 묻는 질문
elite는 어떤 월렛 방식을 쓰나요?
트랜스퍼 월렛입니다. 귀사 시스템이 API로 각 플레이어의 게임 월렛에 입금·출금하고, 게임 안의 베팅과 지급은 그 월렛에서 처리됩니다.
결제 전에 테스트할 수 있나요?
네. 샌드박스는 과금되지 않으며, 무료 데모 플랜으로 충전과 업그레이드 전에 전체 흐름을 체험할 수 있습니다.
게임을 귀사 사이트에 임베드할 수 있나요?
네. 실행 URL을 iframe의 src로 쓰거나(allow="autoplay; fullscreen" 유지) 해당 URL로 리디렉션하세요. 게임은 쿠키에 의존하지 않으므로 서드파티 iframe에서도 작동하며, 휴대폰에서는 보통 전체 페이지 리디렉션이 더 잘 맞습니다.
새 게임이 추가되면 다시 연동해야 하나요?
아니요. 모든 게임이 같은 게임 실행, 월렛, 베팅 내역, Webhook API를 사용합니다. 베팅 내역에 니우니우 보류 금액이나 홀덤 레이크 같은 게임별 필드가 몇 개 추가될 뿐입니다.
수익 배분이 있나요?
없습니다. 일 단위로 계산되는 월 테이블 요금과 GB당 스트리밍 요금만 선불 크레딧에서 차감됩니다. 요금제 섹션을 참고하세요.
지금 연동을 시작하세요. 무료로 가입하면 몇 분 안에 Console과 API 키를 받을 수 있습니다. 플랫폼 개요와 elite 공식 사이트도 확인해 보세요.