게임 목록, 세션, 거래는 서로 다른 인터페이스다
카지노 API 연동을 검토할 때는 공급사가 제공하는 게임을 가져오는 목록 요청, 회원의 게임 방문을 여는 세션 요청, 금액을 바꾸는 거래 요청을 구분합니다. 게임 목록을 주기적으로 가져올 수 있다고 해서 결과 지급도 같은 방식으로 확정된다고 볼 수 없습니다. 어떤 사건을 공급사가 먼저 알려주는지, 어떤 사건을 플랫폼이 다시 조회할 수 있는지 표로 받으세요.
목록에는 공급사 게임 코드, 콘텐츠 종류와 표시 상태가 필요합니다. 세션에는 외부 회원 키와 세션의 유효 범위를 둡니다. 거래에는 공급사 거래 번호와 내부 원장 번호, 회차 키와 금액 단위를 남깁니다. 동일 회원이 카지노 두 곳의 공급사를 사용할 수 있으므로 공급사별 식별자 범위까지 적어야 운영자가 같은 숫자를 다른 거래로 구분할 수 있습니다.
| 명세 단위 | 합의할 값 | 운영팀에서 확인할 예시 |
|---|---|---|
| 콘텐츠 목록 | 공급사·게임 코드, 상태, 언어별 이름 | 목록에서 내려간 게임의 과거 회차 조회 |
| 게임 세션 | 회원 외부 키, 세션 번호, 시작·종료 시각 | 로그인한 뒤 창을 닫았다가 다시 들어가기 |
| 참여 거래 | 금액과 단위, 회차 키, 원거래 식별자 | 10,000P 한 건이 실제 잔액에서 빠지기 |
| 결과 지급 | 지급 거래 키, 관련 회차, 결과 상태 | 수신 후 지갑의 증가분과 지급 시각 확인 |
| 취소·정정 | 원래 거래의 참조, 사유, 차액 | 최초 지급과 정정 이력을 함께 보기 |
최초 수신과 재수신의 예시 명세
예시 공급사 G-A가 결과 거래 PAY-741을 회차 R-241에 보냈다고 가정합니다. 플랫폼은 수신 시각과 원문을 식별할 수 있는 참조를 남기고 실제로 반영한 원장 번호를 연결합니다. 공급사가 응답을 제시간에 받지 못해 같은 결과를 다시 보내면 수신 횟수는 두 번이지만 원장 지급은 한 번이라는 것을 운영 화면에서 확인해야 합니다.
거래 키의 유효 범위는 공급사마다 다를 수 있습니다. 어떤 명세는 공급사 전체에서 거래 키가 고유하고, 다른 명세는 게임이나 회원 단위에서만 고유할 수 있습니다. 테스트 자료로 받은 키가 우연히 모두 다르다는 관찰에 의존하지 말고 문서에 명시된 범위를 계약 단계에 확인하세요. 운영 화면에서도 같은 값이 여러 곳에서 발견되면 공급사와 게임 정보를 표시해야 합니다.
모두 값이 같은 재통지와 금액이 달라진 통지
같은 지급 번호와 같은 금액이 다시 왔다면 최초 지급 결과를 조회하는 일반 재통지일 수 있습니다. 반면 동일 번호에 다른 지급 금액이 들어온 경우는 새 돈을 어느 쪽 기준으로 반영할지 원문 대조가 필요한 사건입니다. 공급사의 정정 규약이 어떤 별도 키와 원거래 참조를 요구하는지 확인하고, 운영 담당자가 차이를 검토할 상태를 표본에 포함합니다.
| 도착 이벤트 | 수신 로그에서 보일 값 | 지갑 원장의 기대값 |
|---|---|---|
| G-A / PAY-741 / 18,000P 최초 수신 | 회차 R-241, 첫 수신 시각 | 지급 +18,000P 한 건 |
| G-A / PAY-741 / 18,000P 재수신 | 동일 값, 두 번째 도착 시각 | 첫 지급 번호를 가리키고 추가 증감 0P |
| G-B / PAY-741 / 4,000P 독립 지급 | 공급사 G-B의 별도 회차 | 실제 G-B 회원 거래로 별도 지급 |
| G-A의 정정 요청 | 정정 키, 원래 지급 번호, 승인 상태 | 승인 전 0P, 승인 후 합의한 차액 |
결과가 참여보다 먼저 보일 때
통신 지연이나 서로 다른 수신 경로 때문에 순서가 뒤집힐 수 있습니다. 운영 화면에 결과가 있는데 원래 참여가 아직 보이지 않는다면 수신 시각만으로 새 회차를 임의 생성하지 않도록 접수 규칙을 확인합니다. 원래 회차가 조회될 때까지 별도 대기 상태에 두는지, 공급사 조회 후 연결하는지, 담당자가 어떤 근거로 완료할지를 명세에 넣으세요.
이를 검수할 때는 공급사 발생 시각과 플랫폼 도착 시각을 각각 기록합니다. 파일을 도착순으로 정렬하면 결과가 위에 보일 수 있지만 회차 원장은 원거래 참조를 따른다는 점을 확인합니다. 운영자가 조회 화면에서 두 시간 기준을 바꿔 볼 수 없다면 다운로드에 두 열을 넣어 나중에 원인을 설명할 수 있게 합니다.
부분 성공을 대조하는 방법
게임사가 결과를 보냈고 플랫폼 수신 로그가 남았지만 지갑 반영은 아직 끝나지 않은 경우를 가정해 보세요. 수신 성공과 금액 반영 성공을 하나의 체크 표시로만 보여 주면 상담원은 회원 잔액을 보고 원인을 찾기 어렵습니다. 거래 처리 단계, 실제 원장 번호, 마지막 상태 변경 시각을 따로 표시해 달라고 요청하세요.
반대 방향의 사례도 필요합니다. 플랫폼에서 지갑을 정상 반영했지만 공급사가 응답을 받지 못했다면 공급사는 원래 요청을 재시도할 수 있습니다. 테스트 환경에서 같은 거래의 결과를 두 번 조회해 최초 원장 번호가 돌아오는지, 새 지급이 생기지 않는지를 확인합니다. 담당자가 결과를 수동으로 다시 요청할 수 있는 기능은 기존 거래의 처리 상태를 먼저 조회하도록 업무 절차를 정합니다.
포인트 단위와 부호가 다를 때
공급사가 전달하는 값이 총 지급액인지 순손익인지 먼저 확인합니다. 참여 10,000P, 결과 통지 18,000P라는 샘플에서 18,000P를 총 지급액으로 정의하면 실제 순증감은 8,000P입니다. 반대로 순이익 8,000P만 보내는 계약이라면 원장에 무엇을 언제 반영하고 원래 금액을 어떻게 처리했는지 별도 규칙이 필요합니다. 공급사별 금액 이름이 같아도 샘플의 시작·종료 잔액으로 정의를 검산하세요.
소수 단위를 허용하면 수신 단위와 보관 단위, 화면 반올림 기준을 나눕니다. 원장에는 작은 단위 값을 보존하면서 회원 화면은 정수만 표시하는 정책일 때 각 회차의 표시값 합과 원장 합계가 차이 날 수 있습니다. 이 사례는 환산 정책을 합의하는 예시이며 실제 포인트 정밀도는 공급 계약 명세에 맞춥니다. 다운로드에는 계산 단위와 표시 단위를 알 수 있는 열이나 설명을 함께 제공합니다.
연동 완료를 판단할 검수 묶음
- 정상 회차 한 건을 끝냅니다. 로비 게임 코드, 외부 회원 키, 참여 및 지급 거래 번호, 내부 원장 행을 같은 표에 적습니다.
- 같은 거래를 재통지한 샘플과 공급사가 다른 독립 거래를 비교합니다. 수신 로그 수와 실제 지급 수를 각각 검산합니다.
- 원래 거래를 취소하거나 정정한 샘플을 확인합니다. 원거래와 차액, 승인 시각을 보고 하루 정산표를 직접 다시 계산합니다.
- 한 번 수신한 거래의 상태를 조회하는 절차를 확인합니다. 파트너에게 전달할 문의 키와 내부에서만 사용하는 회원 정보를 구분합니다.
- 공급사 점검 중 신규 세션은 제한하면서 기존 결과는 수신하는 조건을 시험합니다. 점검 종료 후 쌓인 결과와 대기 목록에서 확인한 수가 맞는지 비교합니다.
검수 자료를 인계받을 때는 성공 응답 예시 한 장과 실패 응답 예시 한 장에 그치지 말고 서로 연결되는 하나의 회차 묶음을 받으세요. 운영 팀원이 문서에 있는 식별자만으로 콘솔에서 회원 문의 한 건을 찾고, 같은 거래를 파일에서 검산할 수 있어야 연동의 완료 기준을 실제 업무와 맞출 수 있습니다.
명세를 인계할 때 남길 버전
카지노 API 명세가 바뀌면 어떤 회차부터 어느 버전을 사용했는지가 중요합니다. 예를 들어 결과 통지에 정정 사유가 선택 항목으로 추가됐을 때 과거 거래에는 해당 값이 없을 수 있습니다. 운영 화면에서 빈 사유를 오류로 표시할지, 당시 버전에서는 제공되지 않았다는 뜻으로 읽을지 검수 자료에 적습니다.
교체 날짜 전후에 같은 종류의 테스트 회차를 하나씩 저장하세요. 공급사의 명세 버전, 플랫폼 배포 버전, 내부 원장 열 이름, 파일의 상태 값을 연결하면 다음 담당자가 당시 결과를 재현할 수 있습니다. 운영 보고서를 다시 생성할 때 과거 자료에 없는 필드와 실제로 값이 0인 필드를 구별할 수 있는지도 함께 확인합니다.
문의 담당자를 위한 인계표에는 공급사에 전달할 최소 참조를 적습니다. 게임 키, 회차 키, 외부 거래 키, 수신 시각이면 사건이 식별되는 경우 내부 회원 메모 전체를 보낼 필요가 없습니다. 회신이 오면 해당 문의 번호를 최초 거래에 연결해 다음 교대자가 조사와 승인 기록을 한 화면에서 이어서 보게 하세요.
