폐지 예정

새로운 Commerce API 메소드 사용 방법

작동 방식

Commerce API 를 연결할 수 있는 경우:

  • 서버 통합(토큰으로 통합)을 이미 엑솔라와 구현했지만 새 Commerce API 메소드로 전환하려는 경우
  • 새 시작을 위해 스토어의 서버 파트를 구현하려는 경우

주요 기능:

  • 엑솔라 로그인을 통한 권한 부여
  • 페이 스테이션 액세스 토큰을 통한 권한 부여
  • 가상 아이템 관리
  • 사용자 인벤토리 관리
  • 카트 및 주문 관리

사용자

  • 스토어 인터페이스를 구현하고 서버 구현을 위해 서드파티 솔루션을 사용하려고 하는 파트너.
  • 이미 엑솔라와의 서버 통합을 구현하고 스토어를 새 Commerce API 메소드로 연결하려고 하는 경우.

획득 방법

앱에 Commerce API 연결 방법:

  1. 설정게시자 계정에서 가상 아이템.
  2. 인증 설정.
  3. 구현 스토어 관리 메소드.

통합을 위해서는 프로젝트 ID 또는 판매자 ID가 필요합니다. 이는프로젝트 설정 > 웹훅에 표시되어 있습니다.

인증 설정

사용할 수 있는 사용자 인증 옵션:

엑솔라 로그인을 통한 인증

  1. 게시자 계정에서 프로젝트를 설정합니다.
  2. JSON 웹 토큰 혹은 OAuth 2.0 프로토콜을 통하여 인증 메소드 호출을 구현합니다.

사용자 데이터가 엑솔라 데이터 스토리지에 보관되는 경우, 다음 메소드 호출을 구현합니다:

사용자 데이터가 PlayFab 데이터 스토리지에 있는 경우, PlayFab 사용 방법을 이용하세요.

사용자 데이터를 여러분 자신이 보관하는 경우, 사용자 정의 스토리지 사용 방법을 이용하세요.

페이 스테이션 액세스 토큰을 통한 인증

인증 절차:

  1. 귀하의 애플리케이션(클라이언트)이 인증 요청을 귀하의 서버에 보냅니다.
  2. 귀하의 서버가 권한 부여 토큰을 요청하고 project_id/merchant_idapi_key 매개 변수를 포함한 헤더를 엑솔라 서버에 보냅니다.
  3. 엑솔라 서버가 매개 변수 access_token의 권한 부여 토큰을 귀하의 서버에 보냅니다.
  4. 매개 변수 access_token을 귀하의 서버가 클라이언트에게 보냅니다.

반환된 access_tokenCommerce API 인증 및 스토어 인터페이스 구축에 인증 토큰으로 사용됩니다.

스토어 관리 메소드

구현해야 하는 기본 스토어 관리 메소드:

아이템 목록 가져오기 관리

  • Get virtual items list — 귀하의 스토어에 추가된 가상 아이템 전체 목록을 표시합니다
  • Get item groups list — 스토어에 추가된 가상 아이템 그룹 전체 목록을 표시합니다
  • 번들 가져오기 — 카탈로그 만들기 목적:

장바구니 및 주문 관리

  • 장바구니 가져오기 — 가상 아이템 구매 목적 — Get cart by ID Get current user’s cart. 매개 변수 card_id는 아이템 추가 또는 제거에 사용합니다.
  • Get order — 구매가 이미 처리되었는지 확인하기 위해 가져옵니다. 가능한 주문 상태:
    • New — 주문이 생성되었지만 결제되지는 않음
    • Paid — 주문이 결제됨
    • Canceled — 주문이 취소됨
    • Done — 주문이 결제되었고 아이템이 인벤토리에 추가됨

Note
주문에 새로운 상태가 부여되기 전에 일회성 확인 절차를 수행할 수 있기에 상태 확인은 특정 빈도로 수행됩니다.

생성한 주문은 New 주문 상태를 받게 됩니다.

결제 UI를 새 창에서 열 때 사용하는 링크: https://secure.xsolla.com/paystation3/?access_token=ACCESS_TOKEN. 여기서 조건은 ACCESS_TOKEN 이 주문이 생성될 때 받은 토큰입니다.

결제 처리 테스트 방법:

  1. 사용할 URL: https://sandbox-secure.xsolla.com/paystation3/?access_token=ACCESS_TOKEN.
  2. 샌드박스 매개 변수를 으로 요청에서 설정합니다.
  3. 테스트용 은행 카드 목록을 설정합니다.

사용자 인벤토리 관리

이 기사가 도움이 되었나요?
감사합니다!
개선해야 할 점이 있을까요? 메시지
유감입니다
이 기사가 도움이 안 된 이유를 설명해 주세요. 메시지
의견을 보내 주셔서 감사드립니다!
메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.
이 페이지 평가
이 페이지 평가
개선해야 할 점이 있을까요?

답하기 원하지 않습니다

의견을 보내 주셔서 감사드립니다!
마지막 업데이트: 2020년 9월 15일

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

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