결제 솔루션 통합

추천을 추적하고 협력자에게 비용을 지급하려면 먼저 엑솔라 페이 스테이션을 통합해야 합니다. 요구 사항:

1. 페이 스테이션이 성능 최적화 방문 페이지에서 통합되었습니다.
2. 페이 스테이션은 파트너 네트워크 프로그램을 통해 트래픽을 사용하는 게임 방문 페이지에서 사용하는 유일한 결제 방법입니다.

토큰 가져오기

결제 UI를 통합할 토큰을 입수해야 합니다. 액세스 토큰은 게임, 사용자 및 구매 매개변수를 식별하는 문자열입니다.

엑솔라 API는 기본 액세스 인증을 사용합니다. 판매자 ID를 사용자 이름으로 지정하고 API 키를 암호로 지정합니다.

이 데이터를 확인하는 방법:

1. 게시자 계정에서 회사 설정으로 이동합니다.
2. 회사 탭에서 판매자 ID를 복사합니다.
3. API 키 탭에서 API 키를 복사합니다.

토큰 검색 URL:

https://api.xsolla.com/merchant/v2/merchants/{merchant_id}/token

결제 UI에 전달하려는 매개 변수를 포함하여 HTTP POST 요청을 변경할 수 있습니다. 토큰 생성 메소드의 user.id, user.name, user.email 매개 변수의 사용자 정보를 전달합니다.

알림

user.id 매개 변수에 대해서는 사용자가 기억하고 게임 밖에서 스스로 사용할 수 있는 식별자를 사용합니다(예: 게임 잔액을 다시 보충할 때 푸시 결제를 사용합니다).

API 참조

매개 변수 전체 목록을 봅니다.

요청과 응답은 모두 JSON 형식입니다.

아래에는 엑솔라 PHP SDK를 사용하여 PHP에서 토큰을 얻는 방법에 대한 샘플 코드가 제공되어 있습니다. 다른 프로그래밍 언어를 사용하고 있는 경우, CURL 탭을 클릭하여 CURL 예제를 살펴보세요.

<?php

use Xsolla\SDK\API\XsollaClient;
use Xsolla\SDK\API\PaymentUI\TokenRequest;

$tokenRequest = new TokenRequest($projectId, $userId);
$tokenRequest->setUserEmail('email@example.com')
    ->setExternalPaymentId('12345')
    ->setSandboxMode(true)
    ->setUserName('USER_NAME')
    ->setPurchase(9.99, 'USD');

$xsollaClient = XsollaClient::factory(array(
    'merchant_id' => MERCHANT_ID,
    'api_key' => API_KEY
));
$token = $xsollaClient->createPaymentUITokenFromRequest($tokenRequest);

curl -v https://api.xsolla.com/merchant/v2/merchants/{merchant_id}/token \
-X POST \
-u your_merchant_id:merchant_api_key \
-H 'Content-Type:application/json' \
-H 'Accept: application/json' \
-d '
{
    "user": {
        "id": {
            "value": "1234567"
        },
        "email": {
            "value": "email@example.com"
        }
    },
    "settings": {
        "project_id": 14004,
        "mode": "sandbox"
    },
    "purchase": {
            "checkout": {
                "amount": 9.99,
                "currency": "USD"
            }
    }
}'

결제 UI 열기

결제 UI를 열 수 있는 세 가지 방법:

• 페이 스테이션 임베드 스크립트
• Iframe
• 새 창

페이 스테이션 임베드

예시: 동기화 스크립트 로딩

<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>

페이 스테이션 임베드는 postMessage를 통해 결제 UI에서 이벤트를 받도록 해줍니다. 이러한 이벤트를 분석 시스템으로 보낼 수 있습니다. 분석 시스템에 이벤트 처리 기능을 설정하려면, 계정 관리자에게 연락하거나 am@xsolla.com로 메일을 보내 주세요.

스크립트는 저희 CDN에 위치해 있으며 이곳 에서 구할 수 있습니다. 스크립트를 개발자 웹 사이트와 연동하려면 이 URL을 사용하십시오. 자세한 내용을 알아보려면 Github 저장소 를 확인해 보십시오.

스크립트 초기화 매개 변수 목록:

결제 인터페이스 관련하여 발생하는 이벤트는 스크립트를 통해 추적할 수 있습니다. 인터페이스 이벤트 유형에 따라 다양한 작업을 웹 페이지에서 수행할 수 있습니다.

이벤트 목록:

결제 UI 열기를 직접 초기화하려면 https://secure.xsolla.com/paystation3/?access_token=ACCESS_TOKEN링크를 이용하십시오.

테스트 목적을 위해 다음 URL을 사용하십시오 https://sandbox-secure.xsolla.com/paystation3/?access_token=ACCESS_TOKEN.

Iframe

직접 다음 메커니즘을 구현해야 합니다.

• 장치 유형(데스크톱 또는 모바일)을 확인하고 장치 유형을 토큰의 settings.ui.version 매개 변수 내에서 전송합니다.
• postMessage를 통해 결제 UI로부터 이벤트를 수신합니다. 이러한 이벤트를 분석 시스템으로 전송할 수 있습니다. 분석 시스템에서 이벤트 처리를 설정하려면 계정 관리자에게 문의하거나 am@xsolla.com으로 메일을 보내 주세요.

Iframe에서 결제 UI를 열려면 https://secure.xsolla.com/paystation3/?access_token=ACCESS_TOKEN 링크를 사용하십시오. 여기에서 ACCESS_TOKEN은(는) 이전 단계에서 얻은 토큰입니다. 테스트 목적으로는 URL https://sandbox-secure.xsolla.com/paystation3/?access_token=ACCESS_TOKEN을(를) 사용하십시오.

새 창

새 창에서 결제 UI를 열려면 https://secure.xsolla.com/paystation3/?access_token=ACCESS_TOKEN 링크를 사용하십시오. 여기에서 ACCESS_TOKEN은(는) 이전 단계에서 얻은 토큰입니다. 테스트 목적으로는 URL https://sandbox-secure.xsolla.com/paystation3/?access_token=ACCESS_TOKEN을(를) 사용하십시오.

웹훅 설정

페이 스테이션의 경우 다음과 같은 웹훅을 구현해야 합니다.

• 사용자 유효성 검사
• 결제
• 환불

웹훅이란 무엇인가요?

웹훅이란 무엇인지, 웹훅 작동 방법, 웹훅 사용 시점을 알아봅니다.

메시지 본문 없이 HTTP 코드 204로 응답하여 웹훅을 수신하였음을 확인합니다.

웹훅 핸들러를 테스트하려면 프로젝트 설정 > 웹훅 섹션을 여십시오.

결제 처리 테스트

샌드박스 모드를 사용하여 결제 프로세스를 테스트할 수 있습니다. 샌드박스 모드는 실제 결제 및 결제 거부를 제외한 결제 프로세스 관련 모든 기능을 지원하는 독립형 환경입니다. 토큰 입수 시 "mode":"sandbox"를 전송하여 샌드박스에 액세스할 수 있습니다.

샌드박스 모드에서 테스트할 수 있는 결제 프로세스:

• 은행 카드
• PayPal

은행 카드 결제 테스트

1. 샌드박스 모드로 결제 UI를 엽니다.
2. 결제 방식에서 신용/직불 카드 그룹을 선택합니다.
3. 은행 카드 세부 정보를 입력합니다. 나머지 필드에 값을 입력합니다. 오류를 확인하기 위해 잘못된 세부 정보(카드 번호 또는 만료일)를 입력할 수도 있습니다.
4. 지금 지불을 클릭합니다.

테스트 카드 목록

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

PayPal 결제 테스트

1. PayPal 샌드박스 모드용 계정 생성 방법:
   1. PayPal 개발자 웹사이트를 엽니다.
   2. 계정에 로그인하거나 새 계정을 생성합니다.
   3. Sandbox > Accounts로 이동합니다.
   4. Sandbox Account 섹션에서 Create account를 클릭합니다.
   5. 모달 창에서 Personal 계정 유형과 국가를 선택합니다.
   6. Create를 클릭합니다. 생성한 계정이 샌드박스 계정 목록에 표시됩니다.

2. 샌드박스 모드에서 결제 UI를 엽니다.
3. PayPal 결제 방식을 선택합니다.
4. 결제 창에서 필요한 정보를 입력합니다.
5. Pay Now를 클릭합니다. PayPal 계정에 로그인하는 창으로 리디렉션됩니다.

6. 결제 프로세스 테스트를 완료하려면 1단계에서 생성한 샌드박스 계정 정보, 즉 이메일 주소(Email ID)와 암호(System Generated Password)를 입력합니다. 이 정보를 확인하려면:
   1. PayPal 개발자 웹사이트에서 계정에 로그인합니다.
   2. Sandbox > Accounts로 이동합니다.
   3. Sandbox Account 섹션에서 샌드박스 계정을 선택합니다.
   4. •••를 클릭한 후 드롭다운 목록에서 View/edit account를 선택합니다.
7. Pay Now를 클릭합니다.

기존 샌드박스 계정 정보를 사용할 수도 있습니다.

구동

실제 결제 처리를 시작하는 방법:

1. 엑솔라와 계약했음을 확인합니다.
2. secure.xsolla.com 링크로 페이 스테이션을 엽니다. 또는 sandbox-secure.xsolla.com를 secure.xsolla.com로 페이 스테이션 임베드 스크립트에서 변경합니다.
3. "mode":"sandbox"를 토큰 가져오기를 할 때 제거합니다.