애플리케이션의 클라이언트 측에서 주문 생성

엑솔라 측에서 사용자 및 아이템 데이터로 주문을 생성하려면 지정된 아이템으로 주문 생성 API 호출을 사용합니다. 이 방법을 사용하면 결제 토큰이 반환됩니다. 이 과정에서 결제 UI를 열어 결제를 진행해야 합니다. 샌드박스 모드를 사용하려면 토큰을 요청하기 위한 본문에 “sandbox”: true 매개 변수를 전달해야 합니다.

결제 UI 열기

<script>
   var options = {
       access_token: 'ACCESS_TOKEN', //TODO use access token, received on previous step
       sandbox: true //TODO please do not forget to remove this setting when going live
   };
   var s = document.createElement('script');
   s.type = "text/javascript";
   s.async = true;
   s.src = "https://static.xsolla.com/embed/paystation/1.0.7/widget.min.js";
   s.addEventListener('load', function (e) {
       XPayStationWidget.init(options);
   }, false);
   var head = document.getElementsByTagName('head')[0];
   head.appendChild(s);
</script>

<button data-xpaystation-widget-open>Buy Credits</button>

<iframe
  src="https://sandbox-secure.xsolla.com/paystation4/?token=TOKEN"
  width="800"
  height="700"
  allow="clipboard-read; clipboard-write; payment"
></iframe>

테스트 결제하기

결제 프로세스를 테스트하려면 샌드박스 모드를 사용할 수 있습니다. 샌드박스 모드는 실제 결제 및 거부된 결제를 제외한 라이브 환경의 모든 기능을 지원하는 독립 실행형 환경입니다. “sandbox”: true를 전송(주문 생성 시)하여 샌드박스 모드에 액세스할 수 있습니다.

1. 샌드박스 모드로 결제 UI를 엽니다.
2. 은행 카드 결제 방식을 선택합니다.
3. 은행 카드 세부 정보를 입력합니다. 다른 필드(예: 이름 또는 주소)에는 아무 데이터나 입력할 수 있습니다. 오류가 생성되는지 확인하기 위해 잘못된 세부 정보(카드 번호 또는 만료일)를 입력할 수도 있습니다.
4. 지불을 클릭합니다.

테스트 카드 목록

테스트 은행 카드 목록을 봅니다.

샌드박스 모드로 진행한 거래에 대한 수수료를 포함한 세부 정보 확인하기:

1. 관리자 페이지를 엽니다.
2. 계정 > 거래 레지스트리로 이동합니다.
3. 테스트 거래 보기 상자를 확인합니다.

또한 관리자 페이지에서 지원 > 거래 검색 섹션의 거래 세부 정보를 확인하고 환불을 요청할 수 있습니다.

주문 생성 및 결제 UI 열기

엑솔라 측에서 사용자 및 제품 데이터로 주문을 생성하려면, XsollaCatalog.Purchase SDK 메서드를 호출하여 다음 매개 변수를 전달합니다.

• itemSku — 사용자가 구매하려는 아이템의 SKU.
• onSuccess — 주문이 done 상태로 전환될 때 트리거되는 성공적인 구매 콜백.
• onError — 요청 오류 콜백.
• onBrowseClosed — 브라우저 닫기 콜백(선택 사항). 이벤트는 내장 브라우저에서 사용자 결제 인터페이스를 열 때만 추적됩니다. 외부 브라우저 이벤트는 추적되지 않습니다.
• purchaseParams — 로케일 및 통화와 같은 구매 매개 변수 및 사용자 결제 UI 설정(선택 사항).
• customHeaders — 사용자 지정 웹 요청 헤더(선택 사항).

XsollaCatalog.Purchase 메서드는 주문 생성, 사용자 결제 UI 열기, 주문 상태 추적 등 지정된 아이템에 대한 구매 프로세스를 시작합니다. 주문이 done 상태로 전환될 때 호출되는 함수를 onSuccess 매개 변수에 전달합니다.

테스트 결제하기

결제 프로세스를 테스트하려면 샌드박스 모드를 사용할 수 있습니다. 샌드박스 모드는 실제 결제와 거절된 결제를 제외한 라이브 환경의 모든 기능을 지원하는 독립형 환경입니다. 샌드박스 모드에 액세스하려면 Inspector 패널의 Unity Editor에서 Test Payments Mode 상자를 체크 표시해야 합니다(기본으로 체크 표시됨).

1. Unity Editor에서 애플리케이션 또는 장면을 실행합니다.
2. 은행 카드 결제 수단을 선택합니다.
3. 은행 카드 세부 정보를 입력합니다. 다른 필드(예: 이름 또는 주소)에는 아무 데이터나 입력할 수 있습니다. 오류가 생성되는지 확인하기 위해 잘못된 세부 정보(카드 번호 또는 만료일)를 입력할 수도 있습니다.
4. 지불을 클릭합니다.

테스트 카드 목록

테스트 은행 카드 목록을 봅니다.

샌드박스 모드로 진행한 거래에 대한 수수료를 포함한 세부 정보 확인하기:

1. 관리자 페이지를 엽니다.
2. 계정 > 거래 레지스트리로 이동합니다.
3. 테스트 거래 보기 상자를 확인합니다.

또한 관리자 페이지에서 지원 > 거래 검색 섹션의 거래 세부 정보를 확인하고 환불을 요청할 수 있습니다.

주문 생성 및 결제 UI 열기

1. 엑솔라 측에서 사용자 및 품목 데이터로 주문을 생성하려면 스토어 라이브러리에서 createOrderByItemSku 메서드를 호출하여 다음 매개 변수를 전달합니다.

1. • callback — 성공적인 주문 생성 콜백. 결제 UI를 열고 결제하는 데 필요한 결제 토큰을 수신합니다.

1. • itemSku — 사용자가 구매하려는 아이템의 SKU.

1. • options — 결제 매개 변수(선택 사항).

1. • quantity — 사용자가 구매하려는 아이템 수(선택 사항). 수량을 지정하지 않으면 기본값은 1로 설정됩니다.

2. 결제 UI 열기 로직을 구현:

val intent = XPayments.createIntentBuilder(activity)
    .accessToken(AccessToken(<payment token>))
    .isSandbox(<isSandbox>)
    .build()
startActivityForResult(intent, RC_PAYSTATION)

3. 결제 결과 처리 구현:

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    super.onActivityResult(requestCode, resultCode, data)
    if (requestCode == RC_PAYSTATION) {
        val (status, _) = XPayments.Result.fromResultIntent(data)
        when (status) {
            XPayments.Status.COMPLETED -> Log.d("MainActivity", "Payment completed")
            XPayments.Status.CANCELLED -> Log.d("MainActivity", "Payment cancelled")
            XPayments.Status.UNKNOWN -> Log.d("MainActivity", "Status unknown")
        }
    }
}

테스트 결제하기

결제 프로세스를 테스트하려면 샌드박스 모드를 사용할 수 있습니다. 샌드박스 모드는 실제 결제와 거절된 결제를 제외한 라이브 환경의 모든 기능을 지원하는 독립형 환경입니다. 샌드박스 모드에 액세스하려면 IntentBuilder 객체 생성 시 isSandbox 메서드를 호출하고 true를 인수로 전달해야 합니다.

1. 애플리케이션을 실행합니다.
2. 은행 카드 결제 수단을 선택합니다.
3. 은행 카드 세부 정보를 입력합니다. 다른 필드(예: 이름 또는 주소)에는 아무 데이터나 입력할 수 있습니다. 오류가 생성되는지 확인하기 위해 잘못된 세부 정보(카드 번호 또는 만료일)를 입력할 수도 있습니다.
4. 지불을 클릭합니다.

테스트 카드 목록

테스트 은행 카드 목록을 봅니다.

샌드박스 모드로 진행한 거래에 대한 수수료를 포함한 세부 정보 확인하기:

1. 관리자 페이지를 엽니다.
2. 계정 > 거래 레지스트리로 이동합니다.
3. 테스트 거래 보기 상자를 확인합니다.

또한 관리자 페이지에서 지원 > 거래 검색 섹션의 거래 세부 정보를 확인하고 환불을 요청할 수 있습니다.

주문 생성 및 결제 UI 열기

1. 엑솔라 측에서 사용자 및 아이템 데이터로 주문을 생성하려면 FetchPaymentToken SDK 메서드를 호출하여 다음 매개 변수를 전달합니다.

1. • AuthToken — 엑솔라 로그인을 사용하여 인증하는 동안 획득한 사용자 인증 토큰.

1. • ItemSKU — 사용자가 구매하려는 아이템의 SKU.

1. • SuccessCallback - 결제 토큰을 성공적으로 수신했을 때 트리거되는 콜백.

1. • ErrorCallback — 요청 오류 콜백.

1. • PurchaseParams — 로케일 및 통화와 같은 구매 및 사용자 결제 인터페이스 매개 변수(선택 사항).

2. 결제 인터페이스를 엽니다. 이렇게 하려면 LaunchPaymentConsole SDK 메서드를 호출하여 다음 매개 변수를 전달합니다.

1. • WorldContextObject — 월드 컨텍스트 객체(C++ 호출용).

1. • OrderId — 주문 ID.

1. • AccessToken — 결제 토큰.

1. • SuccessCallback — 결제 토큰을 성공적으로 수신했을 때 트리거되는 콜백.

1. • ErrorCallback — 요청 오류 콜백.

1. • BrowserClosedCallback — 브라우저 닫기 콜백. 이벤트는 내장 브라우저에서 사용자 결제 인터페이스를 열 때만 추적됩니다. 외부 브라우저 이벤트는 추적되지 않습니다.

1. • PayStationVersion — Pay Station 버전을 선택합니다. 기본적으로 버전 4가 사용됩니다.

테스트 결제하기

결제 프로세스를 테스트하려면 샌드박스 모드를 사용할 수 있습니다. 샌드박스 모드는 실제 결제와 거절된 결제를 제외한 라이브 환경의 모든 기능을 지원하는 독립형 환경입니다. 샌드박스 모드에 액세스하려면 Unreal Editor의 Settings > Project Settings > Plugins > Xsolla Settings > Purchases섹션에서 Enable Sandbox 박스를 체크해야 합니다(기본적으로 체크되어 있음).

1. Unreal Editor에서 애플리케이션 또는 맵을 실행합니다.
2. 은행 카드 결제 수단을 선택합니다.
3. 은행 카드 세부 정보를 입력합니다. 다른 필드(예: 이름 또는 주소)에는 아무 데이터나 입력할 수 있습니다. 오류가 생성되는지 확인하기 위해 잘못된 세부 정보(카드 번호 또는 만료일)를 입력할 수도 있습니다.
4. 지불을 클릭합니다.

테스트 카드 목록

테스트 은행 카드 목록을 봅니다.

샌드박스 모드로 진행한 거래에 대한 수수료를 포함한 세부 정보 확인하기:

1. 관리자 페이지를 엽니다.
2. 계정 > 거래 레지스트리로 이동합니다.
3. 테스트 거래 보기 상자를 확인합니다.

또한 관리자 페이지에서 지원 > 거래 검색 섹션의 거래 세부 정보를 확인하고 환불을 요청할 수 있습니다.