문서 / 게임 플로우

게임 API 플로우

플레이어 확인과 게임 실행부터 베팅, 당첨금, 게임 라운드, 처리 취소 및 재무 대사까지의 전체 흐름.

게임 API 통합
세션
플레이어 및 게임 실행
잔액
베팅 및 당첨금
라운드
게임 세션 흐름
취소
처리 복구
게임 라이프사이클

실행부터 라운드 종료까지

01
게임 세션 생성

플레이어, 게임, 통화, 언어, 국가, 모드 및 반환 URL.

02
게임 실행

임시 접근 키, 실행 URL 및 게임 이용 가능 여부 확인.

03
금융 처리

잔액 확인, 베팅, 당첨금, 결합 처리 및 플랫폼 응답.

04
라운드 종료 및 대사

최종 결과, 취소, 재무 원장 및 제공업체 보고서.

개요

게임 API는 플레이어, 라운드 및 자금 이동을 연결합니다

게임 실행과 자금 이동은 하나의 프로세스를 구성하는 서로 다른 부분입니다. 세션은 플레이어와 실행 조건을 식별하고, 라운드는 제공업체 작업을 연결하며, 플랫폼 API는 각 출금, 입금 및 취소를 확인합니다.

게임 세션 데이터

플레이어, 브랜드, 게임, 통화, 국가, 언어, 모드, 관할권 및 접근 만료 시간.

잔액 제어

플랫폼은 사용 가능한 자금을 확인하고 각 베팅, 지급 또는 취소를 한 번만 적용합니다.

게임 금융 원장

처리 및 라운드 식별자, 처리 유형, 금액, 처리 전후 잔액을 제어 및 대사를 위해 보관합니다.

게임 실행

일반적인 게임 실행 흐름

플랫폼은 먼저 플레이어와 게임 이용 가능 여부를 확인한 뒤 시간 제한 세션을 만들고 제공업체에서 실행 URL을 받습니다.

01

플레이어 및 게임 이용 가능 여부 확인

플랫폼은 계정 상태, 통화, 국가, 제한, 한도, 실머니 또는 데모 모드 및 게임 이용 가능 여부를 확인합니다.

02

내부 세션 생성

플레이어, 게임, 브랜드, 통화, 언어, IP 및 만료 정보가 포함된 세션 식별자를 생성합니다.

03

게임 실행 URL 받기

제공업체는 세션 키, 알림 및 반환 URL, 기기 유형, 관할권 및 인터페이스 매개변수를 받습니다.

04

브라우저에서 게임 열기

플레이어는 반환된 URL을 열고 이후 금융 처리는 서버 간에 직접 처리됩니다.

잔액 처리

핵심 잔액 처리

메서드 이름은 제공업체마다 다르지만 로직은 동일합니다. 잔액 확인, 베팅 차감, 당첨금 적립 및 이전에 확인된 처리의 취소.

잔액 확인

금융 원장을 변경하지 않고 활성 세션 통화의 플레이어 사용 가능 잔액을 반환합니다.

베팅 차감

플레이어, 세션, 통화 및 사용 가능 자금을 검증한 후 확인된 베팅 금액을 한 번만 차감합니다.

당첨금 적립

0 결과를 포함하여 고유한 처리 및 라운드 식별자로 당첨금을 적립합니다.

한 요청에서 베팅과 결과 처리

제공업체가 이 모델을 지원하는 경우 베팅과 게임 결과를 함께 적용합니다.

처리 취소

원본 기록을 삭제하지 않고 이전에 확인된 베팅 또는 지급을 위한 별도 정정 처리를 생성합니다.

보너스 및 프리스핀

실머니 자금과 보너스 자금을 구분하면서 보너스 캠페인 및 게임 라운드 데이터를 전달합니다.

통화 및 금액 정밀도

각 처리는 통화, 금액 단위, 소수 자릿수 및 반올림 규칙을 검증합니다.

플랫폼 응답

처리 상태, 내부 식별자, 현재 잔액 및 통합 오류 코드를 반환합니다.

라운드 라이프사이클

게임 라운드 라이프사이클

하나의 라운드에는 여러 베팅과 결과가 포함될 수 있습니다. 라운드 상태는 네트워크 요청 순서만이 아니라 게임 규칙에 따라 결정됩니다.

라운드 생성

플랫폼이 라운드 식별자를 처음 받으면 내부 기록을 생성합니다.

라운드 진행 중

라운드에는 추가 베팅, 게임 동작 및 중간 당첨금이 포함될 수 있습니다.

베팅 승인

플랫폼에서 차감을 확인하고 제공업체의 고유 처리 식별자와 연결합니다.

결과 수신

당첨금 또는 0 결과를 받았지만 게임 규칙에 따라 라운드는 계속 열려 있을 수 있습니다.

라운드 종료

제공업체가 라운드 종료를 확인했으며 예상된 모든 금융 처리가 완료되었습니다.

처리 취소됨

전체 원본 이력을 유지하면서 하나 이상의 처리가 정정되었습니다.

하나의 라운드에 여러 처리가 포함될 수 있습니다

라운드 식별자만을 멱등성 키로 사용해서는 안 됩니다. 각 베팅, 지급 및 취소에는 각각 고유 식별자가 있어야 합니다.

신뢰성 및 대사

중복 방지 및 재무 대사

게임 API는 반복 요청, 응답 지연, 순서가 뒤바뀐 처리 및 장애 후 제공업체 복구를 안전하게 처리해야 합니다.

안전한 반복 처리

제공업체 처리 식별자는 각 금융 작업 유형마다 고유합니다.
반복 요청은 자금을 다시 이동하지 않고 원래 결과와 현재 잔액을 반환합니다.
금액, 통화 또는 플레이어가 다른 재시도는 데이터 충돌로 거부합니다.
취소는 특정 원본 처리를 참조하며 자체 고유 식별자도 받습니다.

라운드 원장 및 대사

세션, 라운드, 제공업체 처리 및 플랫폼 처리 식별자를 저장합니다.
처리 유형, 금액, 통화, 처리 전후 잔액 및 처리 시간을 기록합니다.
확정된 기록을 변경하지 말고 별도 정정 처리를 생성합니다.
제공업체 보고서, 게임 라운드, 잔액 이동, GGR 및 확인된 차이를 대사합니다.
테스트

테스트 환경에서 확인할 항목

점검 항목에는 게임 실행, 플레이어 제한, 잔액 부족, 반복 처리, 응답 지연, 취소 및 종료된 라운드의 대사가 포함되어야 합니다.

실행 및 게임 세션

실머니 및 데모 모드, 잘못된 통화, 금지된 국가, 만료된 접근 및 이용 불가능한 게임.

잔액 및 베팅 거절

잔액 부족, 차단된 플레이어, 통화 불일치 및 한도 초과.

지연 및 결과 불명

실제로 차감이 완료된 후 제공업체가 응답을 받지 못해 동일한 식별자로 처리를 다시 전송합니다.

반복 베팅 및 당첨금

처리 완료 전후에 동일한 식별자가 다시 도착하며 충돌하는 매개변수가 포함될 수도 있습니다.

처리 취소

베팅 취소, 당첨금 취소, 반복 취소 및 존재하지 않는 원본 처리 참조.

라운드 대사

베팅, 당첨금 및 취소 금액, 최종 상태, 잔액 이동 및 제공업체 보고서가 일치해야 합니다.

출시 전 체크리스트

게임 세션, 잔액 처리, 중복 방지, 취소 및 보고가 검증된 후 출시합니다.

테스트 환경과 운영 환경은 서로 다른 접근 자격 증명, API 엔드포인트 및 실행 설정을 사용합니다.
게임 세션 키는 유효 기간이 제한되며 플레이어, 게임, 통화 및 브랜드와 연결됩니다.
모든 잔액 처리는 고유한 제공업체 식별자로 보호됩니다.
반복된 베팅, 당첨금 및 취소는 잔액을 두 번째로 변경하지 않습니다.
확정된 기록은 삭제하지 않고 별도 정정 처리를 통해 수정합니다.
이벤트 로그, 알림, 제공업체 보고서 및 라운드 대사 프로세스가 구성되어 있습니다.

게임 API 플로우를 구성해야 하나요?

제공업체 문서, 잔액 처리 목록, 게임 라운드 모델, 통화 및 보고 요구사항을 보내 주세요. APIACE가 게임 실행, 베팅, 당첨금, 취소 및 재무 대사를 구조화하도록 지원합니다.