게임에 스토어를 통합

게시자 계정에서 상품(가상 아이템, 인게임 재화, 번들, 키)을 생성하고 구성한 후 게임에 인게임 스토어를 추가하기:

  1. 아이템 카탈로그 표시를 구현합니다.
  2. 아이템 판매 로직을 구현합니다.

아이템 카탈로그 표시

인게임 스토어 및 구매 버튼 API 호출을 통해 아이템 카탈로그 표시 구현:

작업API
스토어에 추가된 가상 아이템의 전체 목록 표시Get virtual items list
클라이언트 측에서 판매 가능한 가상 아이템 그룹 목록 표시Get item groups list
클라이언트 측 스토어에서 판매 가능한 인게임 재화 목록 가져오기Get virtual currency list
클라이언트 측 스토어에 추가된 인게임 재화 패키지의 전체 목록 표시Get virtual currency package list
스토어에 추가된 인게임 재화 번들의 전체 목록 표시Get list of bundles

아이템 판매

다음과 같은 방법으로 아이템을 판매할 수 있음:

  1. 하나의 아이템 빠른 구매. 이 경우, 수량에 관계 없이 하나의 SKU를 판매할 수 있습니다. 예: 100개의 동일한 물약.
  2. 장바구니 구매. 이 경우, 플레이어는 장바구니를 미리 채운 다음 아이템을 추가하거나 제거하거나 수량을 변경할 수 있습니다.

빠른 구매

  1. Create order with specified item API를 호출합니다. 결제 UI를 열기 위한 토큰이 응답으로 전달됩니다.
  2. 수신한 결제 토큰을 사용하여 결제 UI를 엽니다.

Note
할인 정보(개인 설정 또는 구매 관련)는 결재 UI에서만 사용자에게 제공됩니다. 프로모션 코드 사용은 제공되지 않습니다.

장바구니 구매

로직 구현:

  1. 장바구니 설정 및 토큰 받기:
  2. 결제 UI를 엽니다.

클라이언트에서 장바구니 및 구매 설정

아이템을 추가하고 제거하는 논리를 직접 구현합니다. 또한, 장바구니 설정을 위해 API를 호출하기 전에 구매에 적용할 프로모션에 대한 정보가 없다는 점을 고려해야 합니다. 이는 추가된 보너스 아이템의 총 비용 및 세부 정보를 알 수 없음을 의미합니다.

  1. 플레이어가 장바구니를 채운 후 아이템 API로 Fill cart with items를 호출합니다. 선택한 아이템에 대한 현재 정보(할인 전후 가격, 보너스 아이템)가 응답으로 전달됩니다.
  2. Create order with all items from current cart API를 호출합니다. 주문 ID와 결제 토큰이 응답으로 전달됩니다. 생성된 주문이 새 주문 상태를 수신합니다.
  3. 결제 UI를 엽니다.

서버에서 장바구니 및 구매 설정

이 변형은 장바구니에 대한 각 변경에 API 호출이 수반되어야 하기 때문에 장바구니 설정에 시간이 더 오래 걸릴 수 있습니다.

다음 단계 완료 필요.

  1. 장바구니 변경:

Note
장바구니의 현재 상태를 가져오려면 Get current user’s cart API를 호출하세요.

  1. Create order with all items from the current cart API를 호출합니다. 주문 ID 및 결제 토큰이 응답으로 전달됩니다. 생성된 주문은 주문 상태를 수신합니다.
  2. 결제 UI를 엽니다.

결제 인터페이스 열기

아이템 지불을 위해 결제 UI를 엽니다. 결제 UI를 열기 위한 토큰이 Create order with all items from current cart API에 대한 응답으로 전달됩니다.

다음 방법 중 하나로 결제 UI 열기를 구현합니다.

  • 새 창에서: 새 브라우저 창에서 결제 UI를 열려면 링크 https://secure.xsolla.com/paystation3/?access_token=ACCESS_TOKEN를 사용합니다. 여기서 ACCESS_TOKEN는 주문이 생성되었을 때 수신한 토큰입니다.
  • 위젯을 통해: 엑솔라 결제 스테이션 위젯 스크립트를 사용합니다(README 파일에 지침이 포함되어 있음).

결제 처리 테스트

샌드박스 모드에서 결제 흐름을 테스트할 수 있습니다. 테스트 은행 카드와 모든 계좌를 사용할 수 있습니다.

Note
실제 첫 지불 이후, 엄격한 샌드박스 지불 정책이 적용됩니다. 샌드박스 모드에서의 지불은 게시자 계정 > 회사 설정 > 사용자에서 지정된 사용자에 한해서만 가능합니다.

샌드박스 모드를 활성화/비활성화하려면 빠른 구매장바구니 구매 요청에서 sandbox 매개변수의 값을 변경해야 합니다. 샌드박스 모드는 기본값으로 꺼져 있습니다.

진행률
의견을 보내 주셔서 감사드립니다!
마지막 업데이트: 2021년 11월 19일

오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누릅니다.

문제 보고
콘텐츠를 항상 검토합니다. 여러분의 피드백은 콘텐츠를 개선에 도움이 됩니다.
후속 조치를 위해 이메일을 제공해 주세요
의견을 보내 주셔서 감사드립니다!