통화 단위로 격리
엔드포인트가 통화별로 나뉘어 있어, 한 통화의 문제를 그 통화 안에서 막습니다.
Home/Technology
콜백 세 번이면
한 판이 끝납니다.
실행, 차감, 적립. 게임사가 몇 곳이든 운영사가 받는 요청은 이 세 가지뿐입니다. 하이엔드 아시아가 그 사이에서 무엇을 하는지, 확인할 수 있는 것만 적었습니다.
Round trip
한 판이 오가는 길
심리스 월렛 기준입니다. 운영사 지갑은 하이엔드 아시아만 상대하고, 게임사마다 다른 규격은 가운데에서 맞춥니다.
Operator운영사 지갑
Asia HubHIGHEND
Provider게임사
Operator wallet · USD1,000.00
LAUNCHBETSETTLE
테두리가 빛나는 칸이 지금 요청을 받는 쪽입니다. 운영사 지갑 잔액은 콜백이 올 때마다 바로 바뀝니다.
wallet-callback.log · USD
- — LAUNCH
- →
POST /game/launch운영사가 게임 실행을 요청 - →
POST /session게임사 규격으로 바꿔 세션 생성 - ←
200 game_url게임사가 실행 주소를 돌려줌 - ←
200 game_url운영사 매장에 게임이 열림 - — BET
- ←
bet 5.00게임사에서 베팅 발생 - ←
POST /wallet/usd/debit운영사 지갑에 차감 콜백 - →
200 balance차감 후 잔액 응답 - →
200 ok게임사에 처리 결과 전달 - — SETTLE
- ←
win 12.50게임사가 결과를 확정 - ←
POST /wallet/usd/credit운영사 지갑에 적립 콜백 - →
200 balance적립 후 잔액 응답 - →
200 ok한 판 종료
Wallet modes
기본은 심리스
잔액을 옮겨 담지 않는 심리스 월렛을 기본으로 붙입니다. 지갑 구조를 바꾸기 어려운 운영사는 트랜스퍼 방식을 먼저 상의해 주세요.
| 항목 | Seamless기본 | Transfer협의 |
|---|---|---|
| 유저 잔액 위치 | 운영사 지갑. 하이엔드 아시아는 콜백만 전달합니다. | 플레이 중에는 게임사 지갑. 입장·퇴장 때 옮깁니다. |
| 운영사가 만드는 것 | 잔액 조회·차감·적립 콜백 | 입금·출금 요청 |
| 잔액 반영 시점 | 베팅마다 즉시 | 이체할 때 |
| 통화 추가 | 통화별 엔드포인트 하나를 더 받습니다. | 게임사별 지갑 설정이 함께 늘어납니다. |
| 잘 맞는 경우 | 여러 게임사를 한 지갑으로 운영할 때 | 기존 지갑 구조를 당장 바꾸기 어려울 때 |
Specification
기술 사양
개발팀이 첫 미팅 전에 묻는 것들을 먼저 적었습니다.
- Wallet
- 심리스 콜백 — 잔액 조회, 차감, 적립
- Endpoint
- 통화마다 별도 엔드포인트. 스테이지와 운영 주소를 따로 받습니다.
- Currency
- MNT · JPY · CNY · PHP · VND · MYR · THB · TWD · HKD · USD · USDT. 게임사 지원 범위에 따라 다릅니다.
- Access
- API 호출은 등록된 IP에서만 받습니다.
- Environment
- 스테이지와 운영 분리. 규격은 같고 주소와 키만 다릅니다.
- Test
- 스테이지 사이트와 테스트 계정으로 실제 게임을 돌려 검수합니다.
- Back office
- 관리 화면 계정을 전체 · 리포트 · 고객지원 권한으로 나눠 드립니다.
- Report
- 게임사별 정산 데이터를 통화·게임사 기준으로 모아 드립니다.
Reliability
안정성과 보안
인증 마크 대신 실제로 하는 일을 적었습니다.
허용된 IP만
운영사와 게임사 양쪽 모두 등록된 주소에서 온 요청만 처리합니다.
역할별 계정
관리 화면은 전체·리포트·고객지원 권한으로 나눠, 필요한 만큼만 엽니다.
스테이지에서 먼저
게임사 추가와 규격 변경은 스테이지 검수를 통과한 뒤에만 운영에 반영합니다.
콜백마다 기록
차감과 적립 콜백을 건별로 남겨, 분쟁이 생기면 같은 기록을 함께 봅니다.
장애는 바로 공유
원인과 영향 범위, 복구 시점을 확인되는 대로 알립니다.