Unity용 SDK / 일반 정보
 문서로 돌아가기

Unity용 SDK

  • 통합 가이드

  • 데모 프로젝트

  • 인증

  • 카탈로그

  • 구독

  • 프로모션

  • 아이템 구매

  • 플레이어 인벤토리

  • 사용자 계정 및 특성

  • 애플리케이션 빌드 가이드

  • 문제 해결


  • 일반 정보

    결제 UI는 페이 스테이션 제품을 기준으로 합니다. 사용 가능한 결제 방법 및 기타 설정의 선택은 페이 스테이션 섹션의 게시자 계정에서 이용할 수 있습니다.

    결제 UI를 여는 방법은 애플리케이션이 빌드된 플랫폼에 따라 다릅니다.

    • 데스크톱 애플리케이션의 경우 SDK를 사용하면 빌트인 브라우저에서 결제 UI를 열 수 있습니다.
    • 모바일 애플리케이션의 경우 결제 UI가 외부 브라우저에서 열립니다.
    • WebGL의 경우 결제 UI 위젯이 동일한 브라우저 페이지의 아이프레임에서 열립니다.

    SDK는 클릭 한 번으로 또는 장바구니를 통해 카탈로그에서 아이템 구매를 지원합니다.

    구매 프로세스를 테스트하려면 결제 UI의 샌드박스 모드와 테스트 카드 를 사용할 수 있습니다. 샌드박스 모드는 결제 메서드의 동작만 시뮬레이션할 뿐 실제 돈은 포함하고 있지 않습니다. 샌드박스를 사용하기 위해 엑솔라와 계약을 체결하거나 수수료를 지불할 필요가 없습니다.

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

    방법

    저희가 제공하는 방법 안내서에서 고급 설정에 대해 자세히 알아보세요.

    결제 후 애플리케이션에 사용자 리디렉션 설정 방법

    사용자가 결제를 마친 다음 사용자를 다른 페이지로 보내기 위해서 다음 두 가지 유형의 리디렉션을 구성할 수 있습니다.

    • 자동 - 지연 설정 가능한 리디렉션.
    • 수동 - 사용자가 결제 UI를 닫거나 리디렉션 버튼을 클릭한 다음 리디렉션.

    다음 방법으로 리디렉션을 구성할 수 있습니다.

    • 게시자 계정에서 — 단일 애플리케이션용 프로젝트를 설정하고 다른 플랫폼용 빌드를 만들 계획이 없는 경우 이 옵션을 사용하십시오.

    • SDK 설정에서 — 다음을 계획한 경우 이 옵션을 사용하십시오.
      • 복수의 애플리케이션용 프로젝트를 사용
      • 상이한 플랫폼용 빌드 생성
      • 웹사이트를 통해 인게임 아이템 판매

    주의
    게시자 계정과 SDK 설정에서 리디렉션이 구성된 경우, SDK 설정에서 지정된 매개 변수가 사용됩니다.

    게시자 계정에서 리디렉션 구성

    1. 게시자 계정에서 프로젝트를 엽니다.
    2. Pay Station을 사이드 메뉴에서 클릭합니다.
    3. 설정 > 리디렉션 방침 섹션으로 이동합니다.

    1. 반환 URL 필드에 결제 후 사용자가 리디렉션될 URL 또는 경로를 입력합니다.

    알림

    사용자를 모바일 애플리케이션으로 리디렉션하려면 URL은 다음 구성표 중 하나와 일치해야 합니다.

    Unity 프로젝트 설정에서 <ANDROID_PACKAGE_NAME>/<BUNDLE_ID> 값을 찾을 수 있습니다(Edit > Project Settings > Player > Android (iOS) > Other Settings > Bundle Identifier).

    1. 자동 리디렉션 매개 변수 설정 방법:
      1. 드롭다운 목록에서 다음과 같은 자동 리디렉션 조건을 선택합니다.
        • 없음 — 리디렉션하지 않습니다.
        • 결제 성공 — 결제가 성공하면 리디렉션합니다.
        • 결제 성공 또는 취소 — 결제가 성공 또는 취소된 경우 리디렉션합니다.
        • 모든 결제 — 모든 결제 상태에서 리디렉션합니다.
      2. 지연 필드에 리디렉션 시간 제한을 초 단위로 입력합니다.

    1. 수동 리디렉션 매개 변수 설정 방법:
      1. 드롭다운 목록에서 다음과 같은 수동 리디렉션 조건을 선택합니다.
        • 없음 — 리디렉션하지 않습니다.
        • 결제 성공 — 결제가 성공하면 리디렉션 버튼이 표시됩니다.
        • 결제 성공 또는 취소 — 결제가 성공 또는 취소되면 리디렉션 버튼이 표시됩니다.
        • 모든 결제 — 모든 결제 상태에 리디렉션 버튼이 표시됩니다.
      2. 리디렉션 버튼 캡션 필드에서 반환 URL로 사용자를 리디렉션할 버튼 카피를 입력합니다.

    주의

    리디렉션 버튼 카피는 기본적으로 게임으로 복귀입니다. 이것은 모든 페이 스테이션 언어로 현지화되어 있습니다.

    프로젝트가 여러 언어를 지원할 경우, 개별 필드에 각 언어에 대해 리디렉션 버튼 카피를 지정할 수 있습니다.

    사용자 역시 결제 UI를 닫으면 지정된 반환 URL로 리디렉션 됩니다.

    1. 저장을 클릭합니다.

    Configure redirects in SDK 설정에서 리디렉션 구성

    1. Unity 프로젝트를 여십시오.
    2. 메인 메뉴에서 Window > Xsolla > Edit Settings를 클릭하십시오.
    3. Inspector 패널을 열고 Pay Station > Redirect Policy 섹션으로 가십시오.
    4. 귀하의 애플리케이션 빌드 플랫폼에 해당되는 섹션(Desktop, WebGL, Android 또는 iOS)으로 가서 다음과 같이 리디렉션 매개 변수를 지정하십시오.

      1. Use setting from Publisher Account상자 체크표시를 해제하십시오.
      2. Return URL 필드에 결제 후 사용자가 리디렉션될 URL이나 경로를 입력하십시오.

    알림

    사용자를 모바일 애플리케이션으로 리디렉션하려면 URL은 다음 구성표 중 하나와 일치해야 합니다.

    Unity 프로젝트 설정에서 <ANDROID_PACKAGE_NAME>/<BUNDLE_ID> 값을 찾을 수 있습니다(Edit > Project Settings > Player > Android (iOS) > Other Settings > Bundle Identifier).

      1. 자동 리디렉션 매개 변수 설정 방법:
        1. 드롭다운 목록에서 다음과 같이 Redirect Conditions을 선택하십시오.
          • None — 리디렉션하지 않습니다.
          • Successful payment — 결제가 성공하면 리디렉션합니다.
          • Successful or canceled payment — 결제가 성공 또는 취소된 경우 리디렉션합니다.
          • Any payment — 모든 결제 상태에서 리디렉션합니다.
        2. Redirect Timeout 필드에 리디렉션 시간 제한을 초 단위로 입력합니다.

      1. 수동 리디렉션 매개 변수 설정 방법:
        1. 드롭다운 목록에서 다음과 같이 Status for Manual Redirection을 선택하십시오.
          • None — 리디렉션하지 않습니다.
          • Successful payment — 결제가 성공하면 리디렉션 버튼이 표시됩니다.
          • Successful or canceled payment — 결제가 성공 또는 취소되면 리디렉션 버튼이 표시됩니다.
          • Any payment — 모든 결제 상태에 리디렉션 버튼이 표시됩니다.
        2. Redirect Button Caption 필드에 반환 URL로 사용자를 리디렉션할 버튼 카피를 입력합니다.

    주의

    리디렉션 버튼 카피는 기본적으로 게임으로 복귀입니다. 이것은 모든 페이 스테이션 언어로 현지화되어 있습니다.

    프로젝트가 여러 언어를 지원할 경우, 개별 필드에 각 언어에 대해 리디렉션 버튼 카피를 지정할 수 있습니다.

    사용자 역시 결제 UI를 닫으면 지정된 반환 URL로 리디렉션 됩니다.

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

    Steam을 통한 결제 설정 방법

    주의
    Unity 프로젝트에 데모 프로젝트를 포함했다면 이 사용 방법 가이드를 사용하세요.

    플레이어가 Steam을 통한 인게임 구매를 위해 지불하는 경우 엑솔라는 결제 게이트웨이의 역할을 할 수 있습니다. 이러한 경우에, Steam SDK를 통합할 필요가 없으며 인게임 스토어 설정 시 Steam을 통한 결제의 미묘한 차이를 고려할 필요도 없습니다.

    Steam을 통한 결제 설정 방법:

    1. 엑솔라와의 추가 계약에 서명합니다.

    알림
    엑솔라는 Steam을 통해 결제할 때 감소된 수익 분배를 받습니다. 계정 관리자에게 세부정보를 확인하세요.

    1. 게시자 계정에서 Steam용 게이트웨이를 설정합니다.
    2. Steam을 통해 기본 인증을 설정합니다.
    3. Unity 프로젝트를 엽니다.
    4. 메인 메뉴에서 Window > Xsolla > Demo Settings을 클릭합니다.
    5. Inspector 패널의 Payments Flow 드롭다운 목록에서 Steam Gateway를 선택합니다.

    Unity 프로젝트 설정을 변경한 후PurchaseItem SDK 메서드를 사용하여 결제 토큰 요청에 x-steam-userid 헤더가 추가됩니다.

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

    유용한 링크

    마지막 업데이트: 2022년 12월 27일

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

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