새로운 Commerce API 메소드 사용 방법
작동 방식
- 서버 통합(토큰으로 통합)을 이미 엑솔라와 구현했지만 새 Commerce API 메소드로 전환하려는 경우
- 새 시작을 위해 스토어의 서버 파트를 구현하려는 경우
주요 기능:
- 엑솔라 로그인을 통한 권한 부여
- 페이 스테이션 액세스 토큰을 통한 권한 부여
- 가상 아이템 관리
- 사용자 인벤토리 관리
- 카트 및 주문 관리
사용자
- 스토어 인터페이스를 구현하고 서버 구현을 위해 서드파티 솔루션을 사용하려고 하는 파트너.
- 이미 엑솔라와의 서버 통합을 구현하고 스토어를 새
Commerce API 메소드로 연결하려고 하는 경우.
획득 방법
앱에
통합을 위해서는 프로젝트 ID 또는 판매자 ID가 필요합니다. 이는프로젝트 설정 > 웹훅에 표시되어 있습니다.
인증 설정
사용할 수 있는 사용자 인증 옵션:
- 엑솔라 로그인 사용. 엑솔라와의 서버 통합을 구현하지 않은 경우 이 옵션을 선택합니다.
- 페이 스테이션 액세스 토큰. 엑솔라와의 서버 통합을 구현한 경우 이 옵션을 선택합니다.
엑솔라 로그인을 통한 인증
- 게시자 계정에서 프로젝트를 설정합니다.
- JSON 웹 토큰 혹은 OAuth 2.0 프로토콜을 통하여 인증 메소드 호출을 구현합니다.
사용자 데이터가 엑솔라 데이터 스토리지에 보관되는 경우, 다음 메소드 호출을 구현합니다:
사용자 데이터가 PlayFab 데이터 스토리지에 있는 경우, PlayFab 사용 방법을 이용하세요.
사용자 데이터를 여러분 자신이 보관하는 경우, 사용자 정의 스토리지 사용 방법을 이용하세요.
페이 스테이션 액세스 토큰을 통한 인증
인증 절차:
- 귀하의 애플리케이션(클라이언트)이 인증 요청을 귀하의 서버에 보냅니다.
- 귀하의 서버가 권한 부여 토큰을 요청하고 project_id/merchant_id 및 api_key 매개 변수를 포함한 헤더를 엑솔라 서버에 보냅니다.
- 엑솔라 서버가 매개 변수 access_token의 권한 부여 토큰을 귀하의 서버에 보냅니다.
- 매개 변수 access_token을 귀하의 서버가 클라이언트에게 보냅니다.
반환된 access_token는
스토어 관리 메소드
구현해야 하는 기본 스토어 관리 메소드:
아이템 목록 가져오기 관리
- Get virtual items list — 귀하의 스토어에 추가된 가상 아이템 전체 목록을 표시합니다
- Get item groups list — 스토어에 추가된 가상 아이템 그룹 전체 목록을 표시합니다
- 번들 가져오기 — 카탈로그 만들기 목적:
- Get list of bundles — 카탈로그 만들기 목적의 번들 전체 목록을 표시합니다
- Get specified bundle — 특정 SKU로 번들을 표시합니다
장바구니 및 주문 관리
- 장바구니 가져오기 — 가상 아이템 구매 목적 — Get cart by ID Get current user’s cart. 매개 변수 card_id는 아이템 추가 또는 제거에 사용합니다.
- Get order — 구매가 이미 처리되었는지 확인하기 위해 가져옵니다. 가능한 주문 상태:
- New — 주문이 생성되었지만 결제되지는 않음
- Paid — 주문이 결제됨
- Canceled — 주문이 취소됨
- Done — 주문이 결제되었고 아이템이 인벤토리에 추가됨
Note
주문에 새로운 상태가 부여되기 전에 일회성 확인 절차를 수행할 수 있기에 상태 확인은 특정 빈도로 수행됩니다.
- Creates item purchase using virtual currency — 인게임 재화로 가상 아이템을 구매합니다
- 모든 아이템으로 주문 생성 — API 메소드 중 하나 구현:
- Create order with all items from particular cart — ID로 장바구니를 가져온 경우
- Create order with all items from current cart —현재 장바구니를 가져온 경우
- Create order with specified item — 빠른 아이템 구매를 가져온 경우(장바구니를 생성하지 않고)
생성한 주문은 New 주문 상태를 받게 됩니다.
결제 UI를 새 창에서 열 때 사용하는 링크: https://secure.xsolla.com/paystation3/?access_token=ACCESS_TOKEN. 여기서 조건은 ACCESS_TOKEN 이 주문이 생성될 때 받은 토큰입니다.
결제 처리 테스트 방법:
- 사용할 URL:
https://sandbox-secure.xsolla.com/paystation3/?access_token=ACCESS_TOKEN. - 샌드박스 매개 변수를 참으로 요청에서 설정합니다.
- 테스트용 은행 카드 목록을 설정합니다.
사용자 인벤토리 관리
- Get user’s inventory — 구매 후 인벤토리에 추가된 아이템 목록을 가져옵니다
- Get current user virtual balance — 사용자의 인게임 재화 잔액 정보를 가져옵니다
- Get current user subscription — 현재 사용자 구독 정보를 가져옵니다
이 기사가 도움이 되었나요?
의견을 보내 주셔서 감사드립니다!
메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.이 페이지 평가
이 페이지 평가
답하기 원하지 않습니다
의견을 보내 주셔서 감사드립니다!
오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누릅니다.
