카지노 게임 API(애그리게이터)란?
카지노 게임 애그리게이터는 여러 게임사의 연동을 하나로 묶어, 운영사가 API 한 번만 붙이면 슬롯·라이브 카지노·크래시 게임·스포츠북을 모두 쓸 수 있게 해 주는 서비스입니다. 회원 관리와 입출금은 운영사 플랫폼이, 게임 실행과 정산 연동은 애그리게이터가 맡습니다.
SoftAggregator의 공개 카탈로그는 40,000+ 게임, 200+ 게임사이며, 한국 시장을 대상으로 하는 운영사와 함께합니다. 전체 구조는 카지노 게임 애그리게이터 API 소개에서 볼 수 있고, 여기서는 한국 시장에서 자주 묻는 부분만 다룹니다.
원화(KRW): 네이티브 통화로 바로 운영
짧게 말하면 KRW는 네이티브 통화입니다. 네이티브 통화는 KRW를 비롯해 USD, EUR, JPY, CNY, THB, VND, IDR, PHP, MYR, SGD 등이며, 슬롯·라이브 카지노·스포츠북 세 상품군 모두 원화로 플레이어를 만들 수 있습니다. 게임 안의 잔액과 베팅 한도가 원화로 보이므로 운영사가 따로 환산할 필요가 없습니다.
게임사마다 통화별로 한도와 잔액 표시를 따로 설정하기 때문에, 목록 정리는 저희 시스템이 맡습니다. 포털(Integration → Player currency)과 getCurrencies는 계정에 열린 통화를, getGameList는 통화별 게임 목록을 돌려줍니다. KRW 목록에 있는 게임은 유저가 원화로 바로 여는 게임입니다.
네이티브 목록에 없는 통화가 필요하면 계정을 USD(또는 EUR)로 운영하고 입출금 때 운영사 쪽에서 환산하면 됩니다. 원하는 통화가 있으면 편하게 문의해 주세요. 게임 카탈로그와 통화는 계속 확장되며, 최신 목록은 언제나 API(getCurrencies / getGameList)에 있습니다.
한눈에 보는 연동 조건
당사 시스템과 공개 API 문서 기준, 2026년 9월 24일.
| 항목 | SoftAggregator (2026-09-24) | 운영사가 준비할 것 |
|---|---|---|
| 통화 | KRW 네이티브 · 그 밖의 통화는 USD 또는 EUR로 운영 | 지갑 원장 통화와 API로 보내는 currency 일치 |
| 지갑 방식 | 심리스 월렛: balance / debit / credit 콜백 | 피크 시간에도 빠르게 응답하는 엔드포인트 |
| 콜백 | GET 전용, md5(timestamp + salt_key) 서명 | 30초 시간창 확인, call_id 중복 제거 |
| 금액 단위 | 정수, 1/100 단위 (2.50 → 250) | 원 단위 금액도 ×100으로 들어온다는 점 반영 |
| 플레이어 국가 | getGame의 country로 자동 처리 | 실머니 실행마다 country 전송 |
| 언어 | getGame의 lang 파라미터 | 로비 카테고리·게임명 한글화 |
| 내역 조회 | getPlayerHistory (플레이어별 ≤500건, UTC) | 콜백 원장 자체 보관 |
한국 유저가 기대하는 것: 바카라, 슬롯, 해외축구, 모바일
라이브 카지노에서는 바카라가 압도적입니다. 스피드 바카라처럼 회전이 빠른 테이블, 보기 쉬운 출목표, 소액부터 고액까지 나뉜 테이블 한도가 핵심입니다. 저희 라이브 카지노 API는 바카라, 드래곤타이거, 룰렛, 블랙잭, 게임쇼 테이블을 같은 지갑으로 연결합니다. 테이블마다 여러 한도 구간이 있고, 한도는 플레이어 통화로 표시됩니다.
슬롯은 기능 구매(바이 피처)와 높은 배수가 있는 게임이 인기가 많습니다. getGameList가 주는 game_type(slots, live, crash, table, sportsbook 등)은 저희가 정규화한 값이라, 게임사마다 제각각인 원래 분류를 따로 정리할 필요 없이 바로 로비 메뉴를 만들 수 있습니다.
스포츠는 해외축구(EPL, 챔피언스리그)와 e스포츠(LoL 등)가 중심입니다. 스포츠북 API는 축구, 농구, 테니스, 크리켓, e스포츠의 프리매치와 인플레이 마켓을 제공합니다. 야구 등 특정 리그 마켓이 필요하면 온보딩 때 말씀해 주세요. 현재 마켓 구성을 바로 안내해 드립니다.
마지막으로 모바일입니다. 대부분의 플레이가 휴대폰에서 일어나므로 모바일 실행 시 device=mobile을 꼭 넘기세요. 기기 정보가 없으면 실행을 거절하는 게임 플랫폼이 있습니다.
SoftAggregator를 고르는 운영사가 얻는 것
한 줄로 요약하면 “붙이는 건 한 번, 늘어나는 건 계속”입니다. 연동은 API 하나와 콜백 세 개로 끝나고, 그 뒤에 추가되는 게임사와 신작은 운영사 쪽 개발 없이 getGameList에 자동으로 올라옵니다.
- 원화 네이티브. 게임 안 잔액과 한도가 원화로 표시돼 유저가 환율을 계산할 일이 없습니다.
- 한 지갑에 모든 상품. 슬롯에서 딴 돈으로 바로 라이브 바카라나 해외축구에 베팅할 수 있어 유저 이탈이 줄어듭니다.
- 정규화된 게임 데이터. game_type, 게임사 이름, 로고가 같은 형식으로 오므로 로비를 만드는 시간이 짧습니다.
- 멀티 사이트. 브랜드를 여러 개 운영해도 계정 하나에서 사이트별 키와 콜백, 기본 통화를 관리합니다.
- 데모 모드. getGameDemo로 실머니 없이 게임을 먼저 보여 줄 수 있어 가입 전환에 유리합니다.
로비를 구성할 때는 첫 화면에 라이브 바카라와 인기 슬롯을, 스포츠 탭에는 그날의 해외축구 경기를 올려 두는 구성이 한국 유저에게 가장 익숙합니다. game_type 값만으로 이런 탭을 바로 나눌 수 있습니다.
애그리게이터가 운영사에게 줘야 하는 여섯 가지
- API 하나. 게임 목록, 플레이어 생성, 게임 실행, 내역 조회까지 모두
https://api.softaggregator.com/api/v1에 POST + JSON으로 보냅니다. - 심리스 월렛. 플레이어 돈은 운영사에 있고, 저희는 잔액 조회·베팅·당첨마다 콜백을 보냅니다. 플레이어 자금을 미리 맡길 필요가 없습니다.
- 현지 통화. KRW 네이티브, 그 밖의 통화는 USD/EUR.
- 로비 언어. 로비는 운영사 것이고, 저희는 정규화된 카테고리·게임사 이름·로고(자체 CDN)를 넘겨 드립니다.
- 빠른 기술 지원. 연동 기간 내내 텔레그램(@mentionso)과 이메일([email protected])로 기술팀과 직접 소통합니다.
- 문서로 정해진 콜백 규칙. GET 방식, 서명, 에러 코드, 중복 제거 필드가 전부 문서에 있습니다.
사이트를 여러 개 운영한다면, 계정 하나 아래에서 사이트마다 api_login·api_password·salt_key·콜백 URL·기본 통화를 따로 둘 수 있습니다. 크레딧, 게임 목록, 리포트는 계정 단위로 공유됩니다.
콜백 구현에서 자주 틀리는 세 가지
원화 1만 원 베팅은 이렇게 들어옵니다. 금액은 항상 1/100 단위 정수라서 10,000원은 1000000입니다.
GET {운영사 콜백 주소}?username=player123¤cy=KRW&action=debit
&amount=1000000&type=bet&round_id=...&game_id=...
&call_id=...×tamp=...&rb=0&key=...
← {"error":0,"balance":...}- type으로 거절하지 말 것. 분기는 action으로만 하세요. type은 참고용이고 게임사가 늘면서 새로운 값이 생깁니다. 모르는 type은 일반 베팅이나 당첨으로 처리하면 됩니다.
- debit 없는 credit을 받아 줄 것. 프리스핀, 보너스 라운드, 잭팟 당첨은 베팅 없이 당첨만 옵니다. 선행 debit을 요구하면 유저가 그 당첨금을 못 받습니다.
- call_id로 중복 제거. 같은 call_id가 다시 오면 처음 결과를 그대로 돌려주세요. rb=1은 롤백이며 일반 debit/credit처럼 처리합니다.
그리고 잔액을 돌려줄 때의 단위(1/100 단위인지 원 단위인지)는 계정별로 연동 과정에서 확정합니다. 테스트 계정에서 한 번 맞춰 두면 끝입니다.
연동 절차
- 메인 페이지 가입 폼(영문)에서 Player currency에 KRW를 넣고, 필요하면 USD를 추가합니다.
- 승인 후 운영사 백오피스에서 api_login, api_password, salt_key를 받고 콜백 URL을 등록합니다.
- getCurrencies로 계정에 열린 통화를 확인하고, getGameList로 KRW 게임 목록을 받아 로비를 구성합니다.
- balance / debit / credit 콜백을 구현하고 getGameDemo(데모 모드, country 불필요)로 실행 흐름을 확인합니다.
- 소액 실머니 테스트: createPlayer에 currency=KRW, getGame에 lang=ko·device·country=KR을 넘기고 게임 잔액과 지갑 잔액이 일치하는지 봅니다.
- 텔레그램 채널 @casinogamessoftware를 구독해 신규 게임사, API 변경, 점검 공지를 받습니다.
필드별 설명과 에러 코드는 API 문서에 있습니다.
운영사가 자주 묻는 질문
원화(KRW)로 바로 운영할 수 있나요?
네. KRW는 네이티브 통화입니다. 슬롯, 라이브 카지노, 스포츠북 모두 원화로 플레이어를 만들 수 있고, 게임 안의 잔액과 베팅 한도가 원화로 표시됩니다.
원화와 달러를 한 계정에서 같이 쓸 수 있나요?
네. 계정 하나에 여러 통화를 열어 둘 수 있습니다. 통화는 플레이어 단위로 정해지므로 원화 회원과 달러(USD) 회원을 따로 만들면 됩니다.
한 플레이어의 통화를 나중에 바꿀 수 있나요?
안 됩니다. 플레이어를 처음 만들 때 정한 통화는 바뀌지 않습니다. 다른 통화가 필요하면 user_username을 새로 만들어야 합니다.
콜백은 GET인가요 POST인가요?
GET만 지원합니다. 파라미터는 쿼리스트링으로 오고, 응답은 항상 HTTP 200이어야 합니다. 결과는 JSON의 error 값으로 알려 주세요. 0 성공, 1 잔액 부족, 2 처리 오류·서명 불일치입니다.
콜백 서명은 어떻게 검증하나요?
key = md5(timestamp + salt_key) 입니다. timestamp가 서버 시간과 30초 이내인지 먼저 보고 key를 비교하세요. 실패하면 {"error":2,"balance":0}을 돌려주면 됩니다.
country 값은 꼭 보내야 하나요?
실머니 실행에는 보내는 것을 권합니다. 게임사마다 서비스 국가를 정해 두는데, country=KR을 보내면 저희가 자동으로 맞춰 주므로 운영사가 목록을 따로 관리할 필요가 없습니다.
게임 화면이 한국어로 나오나요?
getGame에 lang=ko를 넘기면 한국어로 뜹니다. 인기 슬롯과 라이브 테이블 상당수가 한국어 화면을 제공합니다.
게임 안 프리스핀 당첨금은 어떻게 들어오나요?
스캐터나 기능 구매로 터지는 프리스핀은 게임 안에서 그대로 진행되고, 당첨금은 credit 콜백으로 들어옵니다. 추가 연동은 필요 없습니다.
정산·대사는 어떻게 하나요?
콜백을 call_id 기준으로 저장한 운영사 원장, 플레이어별 getPlayerHistory(최대 500건, UTC 기준), 운영사 포털의 월별 리포트를 맞춰 보면 됩니다.
연동은 얼마나 빨리 시작할 수 있나요?
승인 즉시 백오피스에서 테스트 키를 받습니다. 콜백 세 개를 만들고 getGameList·getGame을 호출하면 바로 테스트가 가능합니다. API 하나로 슬롯, 라이브, 스포츠북이 한 번에 붙습니다.
출처와 최종 확인일
이 페이지의 내용은 SoftAggregator 시스템과 공개 API 문서를 기준으로 합니다.
- SoftAggregator API 문서: softaggregator.com/docs.html (통화, 콜백, 에러 코드, country 파라미터, getPlayerHistory)
- 네이티브 통화 목록: SoftAggregator 시스템, 2026-09-24
최종 확인: 2026년 9월 24일. 오래된 내용을 발견하시면 [email protected]으로 알려 주세요.