본문으로 건너뛰기
한국어 번역 진행 중한국어 문서를 완성하는 동안 일부 가이드와 API 설명은 아직 영어로 표시될 수 있습니다.

플랫폼 개요

Ruby란?​

Ruby는 운영자가 단일 통합 API를 통해 여러 게임 제공업체를 연동할 수 있는 B2B 게임 어그리게이션 플랫폼입니다. 각 게임 제공업체를 개별적으로 연동하는 대신, 팀에서 Ruby에 한 번 연결하면 모든 게임 카테고리의 지원 제공업체에 접근할 수 있습니다.

Ruby는 제공업체 연결, 게임 세션 관리, 월렛(Wallet) 운영 및 리스크 관리를 처리하므로, 팀에서는 브랜드 운영에 집중할 수 있습니다.

지원 게임 유형​

카테고리설명
라이브 카지노주요 제공업체의 라이브 딜러 게임 (바카라, 룰렛, 블랙잭 등)
슬롯다수 제공업체의 RNG 슬롯 타이틀
스포츠 베팅프리매치 및 인플레이 스포츠 마켓

월렛 모드​

생성하는 각 브랜드는 두 가지 월렛 모드 중 하나로 운영해야 합니다. 이 선택에 따라 귀사 시스템과 Ruby 간의 플레이어 자금 흐름이 달라집니다.

심리스 월렛(Seamless Wallet)​

심리스 모드에서는 Ruby가 실시간으로 귀사의 콜백 엔드포인트를 호출하여 잔액을 조회하고 베팅을 정산합니다. 귀사 시스템이 플레이어 잔액의 단일 진실 공급원(Single Source of Truth)으로 유지됩니다.

  • Ruby가 callback_url로 balance, debit, credit, rollback 콜백을 전송합니다
  • Ruby 측에 사전 충전된 잔액이 보유되지 않습니다
  • 서비스 오픈 전에 네 가지 콜백 엔드포인트를 구현하고 호스팅해야 합니다
  • 콜백 서비스 가동 시간에 대한 낮은 지연 시간 의존성

자세한 콜백 사양은 심리스 월렛 개요를 참조하십시오.

트랜스퍼 월렛(Transfer Wallet)​

트랜스퍼 모드에서는 Ruby가 각 브랜드의 사전 충전 잔액을 관리합니다. 플레이어의 자금은 게임 플레이 전에 Ruby 월렛으로 이동하고 이후에 다시 이전됩니다.

  • 팀에서 POST /api/brand/{id}/recharge를 통해 브랜드의 선불 잔액을 충전합니다
  • 귀사 측에 콜백 엔드포인트가 필요하지 않습니다
  • 더 간단한 연동을 선호하는 운영자에게 적합합니다

사용 가능한 제공업체​

아래 표는 Ruby 플랫폼에서 사용 가능한 게임 제공업체 목록입니다. 브랜드 제공업체 화이트리스트 및 베팅 한도를 구성할 때 provider_id를 사용하십시오.

provider_idprovider_code이름카테고리
1EXAMPLE_LIVEExample Live Casino라이브 카지노
2EXAMPLE_SLOTSExample Slots슬롯
3EXAMPLE_SPORTSExample Sports스포츠 베팅
제공업체 검색

현재 활성 제공업체 목록(provider_id 및 provider_code 값 포함)은 Ruby 담당 매니저에게 문의하십시오. 전용 제공업체 카탈로그 API 엔드포인트는 향후 릴리스에 계획되어 있습니다.

주요 개념​

용어정의
팀(Team)Ruby에서의 최상위 계정입니다. 모든 API 호출을 인증하기 위한 team_api_key와 team_api_secret을 받습니다.
브랜드(Brand)팀 하위의 서브 계정으로, 일반적으로 하나의 운영자 또는 제품을 나타냅니다. 각 브랜드는 고유한 API 자격 증명, 월렛 모드 및 제공업체 화이트리스트를 갖습니다.
제공업체 화이트리스트특정 브랜드에 활성화된 게임 제공업체 목록입니다. 해당 브랜드의 플레이어는 화이트리스트에 등록된 제공업체만 이용할 수 있습니다.
선불 잔액(Prepaid Balance)트랜스퍼 모드 브랜드의 경우, Ruby가 브랜드를 대신하여 보유하는 자금입니다.