페이 스테이션

엑솔라 페이 스테이션은 게임 스토어에서 인게임 구매 시 사용자에게 간편한 UI를 제공함으로써 파트너가 자신의 상품을 수익화할 수 있도록 허용합니다. 주요 기능:

  • 200곳 이상의 지리적 위치에서 사용 가능한 은행 카드, 전자 지갑, 모바일 결제, 현금 출납원, 기프트 카드, 특수한 쿠폰 및 암호 화폐를 비롯한 700가지 이상의 결제 방식
  • 130가지 이상의 통화
  • 20개 이상의 언어로 현지화된 UI
  • 데스크톱/모바일 브라우저 및 스마트 TV 버전
  • 구매 가격 계산 시 캠페인, 쿠폰, 세금 청구 및 결제 방식 위탁 지원
  • PayRank 알고리즘을 통해 사용자와 가장 관련있는 결제 방식 자동 제안
  • 사기 방지
  • 엑솔라 게시자 계정: 게이트웨이 구성, 결제 방식 재정렬, 트랜잭션 이력 및 통계 보기, 계산 조정, 보고서 내보내기, 지원 티켓 보기, 결제 취소 등

Note: 통합된 스토어가 있을 경우, 별도의 페이 스테이션 통합 작업이 필요하지 않습니다. 스토어가 자동으로 활성화됩니다.

작동 방식

1 단계

2 단계

3 단계

글로서리

PayRank

PayRank는 사용자에 대한 관련성에 따라 결제 방식을 정렬하는 알고리즘입니다. 이 알고리즘은 위치, 결제 내역, 결제 금액 등과 같은 다양한 매개변수를 고려합니다. 이 알고리즘은 페이 스테이션의 결제 UI에서 자주 사용하는 모든 결제 방식에 대한 목록을 구축 시 사용됩니다. 게시자 계정에서 PayRank를 유연하게 구성할 수 있습니다.

게이트웨이

게이트웨이를 사용하면 페이 스테이션 인터페이스에서 이용할 수 있는 결제 시스템으로부터 직접 결제금을 받을 수 있습니다. 선택한 결제 시스템으로부터 직접 결제금을 받기 원하는 경우 이러한 모델을 사용할 수 있습니다. 이 모델에서 인터페이스는 변경되지 않지만 엑솔라는 기술 서비스 제공자의 역할만을 수행하고 한정적인 매출 수수료만 취합니다.

페이 스테이션 인터페이스에 게이트웨이를 표시하려면 먼제 본인의 게시자 계쩡에서 이를 구성한 후 동의서에 서명해야 합니다.

오퍼월

오퍼월은 귀하가 결제 UI에서 위젯으로 표시된 특수 쿠폰을 통해 사용자의 충성도를 향상시킬 수 있도록 허용합니다. 이 위젯은 사용자가 가입, 설문조사, 구매 등과 같은 특정 작업을 완료하도록 하여 엑솔라 잔액에 보너스를 적립하도록 독려합니다.

기프트 카드

기프트 카드는 특정 스토어의 할인 카드로서, 사용자가 결제 UI 내부의 위젯을 통해 게임 콘텐츠를 구매할 수 있도록 허용합니다. 구매 금액이 카드의 액면가보다 작을 경우, 나머지 금액은 사용자의 엑솔라 잔액에 적립됩니다.

사용자 플로우

통합 플로우

페이 스테이션 활성화 방법:

  1. 엑솔라 게시자 계정을 등록합니다.
  2. 프로젝트를 생성합니다.
  3. 토큰을 가져옵니다.
  4. 결제 UI 열기를 설정합니다.
  5. 웹훅 처리를 설정합니다.

통합에 필요한 매개변수는 다음과 같습니다:

  • 판매자 ID. 프로젝트 설정 > 웹훅에 표시
  • API 키. 회사 설정 > API 키에서 설정한 매개변수입니다.
  • 프로젝트 ID. 프로젝트 설정 > 웹훅에 표시
  • 비밀 키. 프로젝트 설정 > 웹훅에서 설정한 매개변수입니다.

Note: 본 가이드에는 모듈을 빠르게 시작하기 위해 필요한 최소 설정에 대한 설명이 제공되어 있습니다. 질문이 있을 경우, 계정 관리자에게 문의하십시오.

프로젝트 생성

  1. 프로젝트로 이동하고 새 프로젝트 만들기를 클릭합니다.
  2. 설정 모드에서:
    1. 웹훅 URL을 지정합니다.
    2. 프로젝트 웹훅에 서명할 비밀 키를 생성합니다.

토큰 가져오기

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

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

토큰 검색 URL:

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

토큰 요청하기

결제 UI로 전달하기 원하는 매개변수를 포함하여 HTTP POST 요청을 변경할 수 있습니다. 요청 및 응답은 JSON 형식으로 되어 있습니다.

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

Copy
Full screen
  • php
  • 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"
            }
    }
}'

매개변수 전체 목록은 API 레퍼런스에서 확인할 수 있습니다.

결제 프로세스 테스트

결제 프로세스를 테스트하려면

  • 샌드박스
  • 를 사용하여 실제로 지불하고 게시자 계정을 통해 환불을 시작할 수 있습니다.

엑솔라 샌드박스는 실제 결제를 제외한 결제 프로세스 관련 모든 기능을 지원하는 독립형 환경입니다. “mode”:“sandbox”를 전송하여 샌드박스에 액세스할 수 있습니다(토큰 입수 시 가능).

은행 카드 결제 테스트 방법:

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

테스트에 사용할 은행 카드 목록

Note: 샌드박스 은행 카드 지불은 다음과 같은 통화로 가능합니다. USD, EUR, RUB, GBP, AED, ALL, AMD, ARS, AUD, AZN, BGN, BRL, BYN, CAD, CHF, CLP, CNY, COP, CZK, DKK, DZD, EGP, GEL, HKD, HRK, HUF, IDR, ILS, INR, ISK, JPY, KES, KGS, KRW, KZT, MAD, MDL, MKD, MNT, MXN, MYR, NGN, PEN, PHP, PKR, PLN, RON, RSD, SAR, SEK, SGD, THB, TRY, TWD, UAH, UYU, UZS, VEF, VND, ZAR.
Notice: 실제 결제 금액을 수령하려면 우선 “mode”:“sandbox”를 제거하십시오.

실제 지불을 통해 결제 프로세스를 테스트하려면 다음과 같은 방법으로 은행 카드를 사용하는 것이 좋습니다.

  1. 결제 UI를 개설합니다.
  2. 결제 방법으로 신용 카드/직불 카드를 선택합니다.
  3. 유효한 은행 카드 세부 정보를 입력합니다.
  4. 결제를 완료한 후, 게시자 계정의 거래 검색 섹션으로 이동하십시오.
  5. 테스트 거래를 선택하고 환불을 누르십시오(거래가 완료된 상태에서 수행해야 함).

Note: 결제 프로세스를 테스트하려면 Visa 및 MasterCard 카드를 사용하도록 권장합니다.

결제 UI 열기

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

Note: 샌드박스 모드에서 결제 UI를 열려면 다음 URL을 사용합니다 https://sandbox-secure.xsolla.com/.

페이 스테이션 임베드

페이 스테이션 임베드 스크립트가 장치 유형을 결정하고 라이트박스(데스크톱 화면) 또는 새 창(모바일 및 태블릿 화면)에서 결제 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>

스크립트 초기화 매개변수 천체 목록은 API reference에서 확인할 수 있습니다.

새 창

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

Iframe

Iframe에서 결제 UI를 열려면 다음 메커니즘을 실행해야 합니다.

  • 장치 유형(데스크톱 또는 모바일)을 확인하고 장치 유형을 토큰의 settings.ui.version 매개변수 내에서 전송합니다
  • postMessage를 통해 결제 UI로부터 이벤트를 수신합니다

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

웹훅 설정

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

메시지 본문 없이 HTTP 코드 204로 응답하여 웹훅을 수신하였음을 확인합니다. API 레퍼런스에서 예제를 비롯해 웹훅에 대해 자세히 알아볼 수 있습니다.

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

Note: 웹훅을 설정한 후, 페이 스테이션 설정을 열고 체크아웃으로 설정합니다.

레시피

당사 레시피는 귀하가 다음과 같은 페이 스테이션의 몇 가지 고급 기능을 시도해보도록 지원합니다.

  • 고급 부정 결제 방지 기능
  • 토큰화
  • 선택한 방식으로 결제
  • 스마트 TV를 통한 구매 결제
  • 오퍼월
  • 게임 도메인에서 페이 스테이션 열기
  • 페이 스테이션 사용자 정의