본문으로 건너뛰기

Epic Games 상품(오퍼) 구매

개요​

  • Epic Games의 상품(오퍼) 구매에 대한 빌링 서버측의 상세 가이드 문서입니다.
  • 지속성 중 기본게임과 소모성 오퍼를 지원합니다.
    • 소모(리딤)처리되지 않고 방치되어도 구글처럼 3일이나 N일 이후에 자동 취소되지 않음
      • SDK 재처리 대상 boid 조회 응답에서는 30일내의 예약건을 대상으로 조회 후 응답 -> 구매 복구 가능
    • 지속성 중 시즌패스 등의 지속성 오퍼는 지원하지 않습니다.
정보
  • 구매 완료한 지속성 기본 게임의 사용 허용에 대한 검증은 'Epic Gmes 구매 완료한 지속성 상품의 오너쉽 정보 조회’ 를 이용하면 됩니다.

Epic Games 개발자 포털 설정 및 빌링시스템에 연동​

디플로이 생성​

정보
  • Epic Gmes는 Dev, Stage, Live 3개의 샌드박스를 기본적으로 제공하며, 각 샌드박스 하위에 개발자가 디플로이를 생성할 수 있습니다.

제품 설정 > 샌드박스 메뉴에서 디플로이 생성 가능

클라이언트 생성​

  • 빌링 플랫폼이 Epic Games와 통신하기 위해서는 OAuth 클라이언트가 필요합니다.
  • 제품 설정 > 클라이언트 메뉴에서 사용할 클라이언트를 생성할 수 있습니다.
    • 클라이언트 생성 전 클라이언트 정책을 먼저 생성해야 합니다.
    • 클라이언트 정책 유형은 TrustedServer를 선택

![](/img/legacy/image%20(1) (1).png)

  • 클라이언트 정책 추가 후 클라이언트를 생성합니다.

디플로이 및 클라이언트 정보 확인​

  • 생성된 디플로이와 클라이언트 정보는 제품 설정 > SDK 다운로드 및 크리덴셜 메뉴에서 확인 가능

빌링 시스템에 설정 정보를 등록하여 연동​

  • 디플로이 ID, 클라이언트 ID, 클라이언트 비밀 키, 샌드박스 ID 등을 담당자에게 전달 후 빌링 플랫폼에 등록합니다.

시퀀스 다이어그램​

정보
  • 실제 유저에게 판매할 상품의 전시(판매 기간, 유저 조건 특화 판매 등) 관리는 게임쪽에서 담당합니다.
  • Epic Games는 오퍼라는 개념으로 상품을 관리하지만, 빌링 시스템에서는 해당 오퍼를 추상화하여 다른 결제수단/스토어와 동일한 상품으로 취급하여 연동의 편의성을 제공합니다.
    • 참고) Epic Games 포털에 등록된 오퍼는 빌링 시스템에도 등록되어야합니다.
  • 기본게임을 무료로 판매한다면, 기본 게임의 구매 예약 → 검증 → 완료는 필수가 아닙니다.

시퀀스 관련 추가 설명​

  • 3-6의 결제 검증 요청에 대해서 지속성은 Epic Games 가이드에 따라 Entitlement 검증은 진행되지 않습니다.(참고)
    • 지속성(기본게임, DLC와 같은) 상품은 오너쉽 검증만 진행됩니다.(참고 링크)
    • 소모성 상품의 경우에는 Entitlement 검증이 추가로 진행됩니다.(참고 링크)
정보

3-10 빌링 완료 요청을 누락한 경우와 같은 분산 데이터 정합성 문제 발생에 대한 처리방법 팁

  • VERIFY_SUCCESS 상태로 방치되어 있을 수 있습니다.
  • 해당 boid 리스트를 빌링 구매 리스트 조회 API를 이용해서 상태값 등을 확인 후 이후 시퀀스를 진행하여 정합성이 깨진 데이터를 완료 처리하거나 게임 로직 처리가 가능합니다.