엑솔라 서버 통합

이 통합 유형으로 엑솔라 측에서 수행되는 작업:
  • 카탈로그 저장 및 관리
  • 가격 관리
  • 지역별 가격 데이터 저장
  • 지역별 제한 관리
  • 인벤토리 관리
  • 프로모션 캠페인 관리
  • 사용자 인증
  • 사용자 액세스 관리
  • 거래 처리
Discord 서버
엑솔라 제품을 사용하는 엑솔라 팀 및 개발자와 연결합니다.
이러한 작업용으로 자체 서버를 구성하지 않아도 됩니다.

통합 절차

Payments 라이브러리 통합 방법:
  1. Android Studio를 다운로드설치합니다.
  2. 프로젝트를 생성합니다.
  3. 게시자 계정에서 프로젝트를 설정합니다.
  4. 인게임 재화 모듈을 설정합니다(선택 사항).
  5. 가상 아이템 모듈을 설정합니다(선택 사항).
  6. 페이 스테이션을 설정합니다.
  7. 토큰을 가져옵니다.
  8. 라이브러리를 설치합니다.
  9. 리턴 URL을 구성합니다.
  10. 이벤트 처리 및 SDK 메소드를 설정합니다.
통합 완료 후 지불 프로세스를 테스트 합니다.
Note
본 가이드에는 모듈을 빠르게 시작하기 위해 필요한 최소 설정에 대한 설명이 제공되어 있습니다. 질문이 있을 경우, 계정 관리자에게 문의하십시오.

게시자 계정의 프로젝트 설정

  1. 게시자 계정을 등록합니다.
  2. 게시자 계정 프로젝트를 구성합니다. 계정 등록을 한 후 첫 번째 프로젝트는 자동으로 생성됩니다.
    1. 프로젝트 섹션에서 프로젝트를 선택한 다음 프로젝트 설정으로 이동합니다.
    2. 일반 설정 탭에서 다음을 추가합니다:
      • 이미지(선택 사항)
      • 프로젝트 언어(기본적으로 영어로 설정되어 있습니다)
      • 지정한 모든 언어에 대한 프로젝트 이름
      • 게임 웹 사이트(선택 사항)
      • 프로젝트 설명(선택 사항)
    3. 저장을 클릭합니다.

통합 처리 중에, 다음 매개 변수가 필요합니다:

  • 프로젝트 ID프로젝트 설정 > 프로젝트 ID에서 찾을 수 있습니다.

  • 로그인 ID로그인 설정 > 로그인 ID에서 찾을 수 있습니다. UUID 형식으로 되어 있습니다.

인게임 재화 모듈 설정

  1. 게시자 계정에서 프로젝트를 엽니다.
  2. 스토어 창에서 연결을 누릅니다. 게시자 계정의 모든 섹션에서 인게임 스토어 설정으로 사이드 메뉴에서 스토어를 클릭하여 이동할 수 있습니다.

  1. 인게임 재화 창에서 연결을 클릭합니다.

  1. 인게임 재화 생성 방법:
    1. 인게임 재화 만들기를 클릭합니다.

    1. 지정해야 하는 정보:
      • SKU
      • 화폐 이름
      • 인게임 재화 1개당 가격
      • 기본 화폐
      • 현금성 인게임 재화의 기능(선택 사항)
      • 이미지(선택 사항)
    2. 화폐 만들기를 클릭하세요.

  1. 인게임 재화 만들기:
    1. 패키지로로 이동합니다.
    2. 패키지 만들기를 클릭합니다.

    1. 지정해야 하는 정보:
      • SKU
      • 패키지 이름
      • 짧은 설명
      • 인게임 재화
      • 패키지 안의 화폐 단위 수량
      • 가격
      • 기본 화폐
      • 이미지(선택 사항)

    1. 스토어에 표시 토글을 켜짐으로 설정하세요.
    2. 패키지 만들기를 클릭하세요.

Note
라이브러리는 가상 화폐의 가상 아이템 구매를 지원합니다. SDK는 가상 화폐의 가상 아이템 구매를 지원합니다. 또한 사용자는 가상 화폐를 인게임 논리에 따라 사용할 수 있습니다(위치에 대한 액세스 얻기, 진행 수준 알기 등). 사용자는 Xstore.consumeItem SDK 메소드 호출 시에 인게임 재화를 사용합니다.

가상 아이템 모듈 설정

Note
SDK 메소드는 다음 아이템 유형을 지원합니다:
  • 소모성 아이템 — 인벤토리의 아이템으로 누적 가능하고 반복 구매가 가능하며 한 번 사용하면 수량이 감소합니다. 이 아이템 재고는 보충할 수 있습니다. 예: 적 공격을 위한 수류탄과 탄알, 응급 키트 등.
  • 비소모품 — 인벤토리의 아이템으로 1회에 한하여 누적 및 구매가 가능하며 인벤토리에서 사라지지 않습니다. 예: 위치 접근, 상태 등.
  • 비갱신 정기결제 — 일정 기간 동안 사용 가능한 비소모성 아이템으로 만료되면 인벤토리에서 사라지지 않습니다. 예: 프리미엄권, 시즌권. 자세한 내용은 인게임 스토어 설명서를 참조하세요.

  1. 게시자 계정에서 프로젝트를 엽니다.
  2. 스토어 창에서 연결을 누릅니다. 게시자 계정의 모든 섹션에서 인게임 스토어 설정으로 사이드 메뉴에서 스토어을 클릭하여 이동할 수 있습니다.

  1. 가상 아이템 창에서 연결을 클릭합니다.

  1. 그룹 생성을 클릭합니다.

  1. 그룹 코드그룹 이름을 지정합니다.
  2. 스토어에 그룹 표시 토글을 켜짐으로 설정합니다.
  3. 그룹 생성을 클릭합니다.

  1. 아이템 생성:
    1. 그들 각각에 대하여 다음 정보를 명시합니다:
      • 아이템이 속하는 하나 이상의 그룹
      • SKU
      • 이름 및 간단한 설명
      • 실제 통화 및 인게임 재화 가격
      • 이미지 (옵션)

    1. 아이템 속성 필드에서 (환경 설정 섹션의), 아이템 유형에 따라 다음 속성 중 하나를 선택합니다:
      • 소모품
      • 비소모품
      • 비갱신 정기결제
    2. 아이템 생성을 클릭합니다.

  1. 그룹 상태가 활성화됨인지 확인합니다.

게시자 계정 페이 스테이션 설정

  1. 프로젝트로 이동한 후 페이 스테이션 블록에서 열기를 클릭합니다. 이전에 스토어 모듈을 설치하지 않은 경우 페이 스테이션 블록에서 연결을 클릭합니다.

  1. 페이 스테이션 설정을 엽니다.
  2. 리디렉션 정책 블록에서 복귀 URL리디렉션 조건을 지정한 후 저장을 클릭합니다.

토큰 가져오기

SDK가 제대로 작동하려면 토큰이 필요합니다. 액세스 토큰은 결제 프로세스를 시작하는 데 사용되는 문자열입니다.

Create Order with All Items from Particular Cart 메소드를 사용하여 엑솔라 Store 라이브러리에서 토큰을 가져올 수 있습니다. 또는 PlayFab으로부터 입수한 토큰과 같은 다른 액세스 토큰을 사용할 수도 있습니다.

라이브러리 설치

라이브러리는 Maven Central에서 이용 가능합니다.

라이브러리 설치 방법:

  1. Android Studio를 시작합니다.
  2. 여러분 애플리케이션의 build.gradle 파일을 엽니다.
  3. 종속성 섹션에 다음 행을 추가합니다, 여기서 <version_number>는 필요한 Payments library 버전입니다:

최신 버전:

Copy
Full screen
Small screen
implementation 'com.xsolla.android:payments:<version_number>'

복귀 URL 구성

다음 문자열을 프로젝트 문자열 리소스 파일에 추가하여 게시자 계정복귀 URL을 지정합니다.

Copy
Full screen
Small screen
<string name="xsolla_payments_redirect_scheme">app</string>
<string name="xsolla_payments_redirect_host">yourgame</string>

복귀 URL은 여러 부분으로 구성되어 있어야 합니다. app://yourgame와 같은 형식이어야 합니다.

결제 처리 테스트

성공적으로 라이브러리 구성을 마친 후, 지불 프로세스를 테스트합니다. 기본적으로, 모든 지불은 샌드박스 모드 내에 있으며 신용 카드 테스트를 사용하여 성공적인 지불 프로세스를 시뮬레이션해볼 수 있습니다.

실제 지불로 지불 처리 테스트하는 방법:

  1. 엑솔라와 계약했음을 확인합니다.
  2. Paystation Intent 구축하는 동안 .isSandbox(false)를 설정합니다.

Note
실제 첫 지불 이후, 엄격한 샌드박스 지불 정책이 적용됩니다. 샌드박스 모드에서의 지불은 게시자 계정 > 회사 설정 > 사용자에서 지정된 사용자에 한해서만 가능합니다.
이 기사가 도움이 되었나요?
감사합니다!
개선해야 할 점이 있을까요? 메시지
유감입니다
이 기사가 도움이 안 된 이유를 설명해 주세요. 메시지
의견을 보내 주셔서 감사드립니다!
메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.
이 페이지 평가
이 페이지 평가
개선해야 할 점이 있을까요?

답하기 원하지 않습니다

의견을 보내 주셔서 감사드립니다!

계속 읽기

마지막 업데이트: 2021년 9월 1일

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

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