본문으로 건너뛰기

XSOLLA를 이용한 인게임 결제 연동

위험
  • 해당 가이드는 인게임에서 시작되는 결제에 대한 가이드로 웹샵 버전에 대한 가이드가 아닙니다.

개요​

  • XSOLLA 시스템을 이용해서 게임내 상품을 판매 가능합니다.
  • 빌링 시스템은 XSOLLA에서 제공하는 기능 중 구매와 관련된 기능을 랩핑해서 제공해드리고 있습니다.
  • XSOLLA를 이용한 결제는 크게 아래와 같이 구분할 수 있습니다.(상세 내용은 시퀀스 다이어그램 참고)
    1. 유저에게 판매할 상품리스트를 조회
      • 게임 서버에서 유저에게 실제 판매할 상품 리스트를 조회 후 보여줍니다.(전시처리)
      • 이때, 가격 정보와 로컬라이징 된 상품명 등은 SDK에서 제공되는 엑솔라 로컬라이징 정보로 실제 결제 금액을 보여줄 수 있습니다.
    2. 구매용 결제 토큰을 생성 후 유저에게 결제 URL을 제공해서 결제를 유도합니다.
    3. XSOLLA 웹훅을 통해 전달되는 정보를 이용하여 빌링서버에서 상품지급 요청을 게임서버로 요청합니다.
      • 개발사에서 제공하는 상품지급 API(개발사 제공 API 정의서 참고)를 이용하거나, 협의 후 인벤토리 시스템을 이용
정보

사전 준비 사항​

  • 사업 또는 기술PM 등을 통해서 XSOLLA에 프로젝트 등록과 같은 준비 작업을 요청합니다.
  • 판매할 ‘가상 아이템’ 상품을 XSOLLA 웹 콘솔에 등록합니다.
    • 참고: XSOLLA 에서는 여러 형태의 상품 방식을 제공하지만 일반적으로 가장 많이 사용하는 '가상 아이템' 방식만 빌링 시스템에서는 제공합니다.
  • 게임서버에 상품 지급 방법 확정 후 빌링 시스템에 전달

시퀀스 다이어그램​

정보
  • 횟수제한 상품이나 레벨제한 상품처럼 게임특화 BM은 판매 상품 전시 때 유저에게 개인화 처리해서 보여줄 수 있으며, 예약 단계, 완료단계, 상품지급 API 요청 받은 단계 등에서 유효성 검사를 추가하셔서 구현할 수 있습니다.

시퀀스 관련 추가 설명​

  • 2-2. 빌링 예약 및 XSOLLA결제 URL요청은 빌링 서버 API를 통해서 진행(링크)