決済ソリューションを統合する

紹介者を追跡し、協力者への支払いを行うには、まずエクソラ決済ステーションを統合する必要があります。要件は以下の通り：

1. 決済ステーションは、パフォーマンスに最適化されたランディングページに統合されています。
2. 決済ステーションは、パートナーネットワークプログラムでトラフィックを誘導するゲームのランディングページで使用される唯一の決済方法です。

トークンを取得する

決済インターフェースと統合するには、トークンを取得する必要があります。アクセストークンは、ゲームやユーザー、購入パラメータを識別する文字列です。

エクソラAPIは基本アクセス認証を採用しています。マーチャントIDをユーザー名、APIキーをパスワードとして指定します。

トークンの取得はこのURLから：

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

HTTP POSTリクエストの内容を変更して、決済UIに渡したいパラメータを含めることができます。トークンを取得するメソッドでのパラメータuser.id、user.nameおよびuser.emailでのユーザーに関する情報を渡します。

Note

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を開く方法は3つあります：

• Pay Station Embedスクリプト
• Iframe
• 新しいウィンドウ

Pay Station Embed

例：スクリプトの非同期読み込み

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

Pay Station Embedでは、postMessage経由で決済UIからのイベントを取得することができます。これらのイベントを分析システムに送信できます。イベント処理を分析システムで設定するには、担当のアカウントマネージャー、またはEメールでam@xsolla.comまでお問い合わせください。

ウェブサイトに決済UIを簡単に実装するには、当社のCDNからスクリプトをダウンロードしてください。このURLを使用して、あなたのウェブサイトにスクリプトを統合します。詳細については、GitHub リポジトリをご覧ください。

スクリプト初期化パラメータ：

このスクリプトでは、決済インターフェースのイベントを追跡することができます。イベントの種類に応じて、Webページでさまざまな操作を実行できます。

イベントの一覧：

自分で決済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。

新しいウィンドウ

新しいウィンドウで決済インターフェース開くには、次のリンクを使用してください：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"を送信します。

銀行カードの支払いテストを行う場合：

1. サンドボックスモードで決済インターフェースを開く。
2. 決済方法のグループからクレジット/デビットカードを選択する。
3. 銀行カードの詳細情報を入力。その他のフィールドに任意の値を入力。間違った情報（カード番号、有効期限、CVV等）を入力して、エラーを生成することも可能です。

テストカード一覧

テストバンクカードの一覧を参照してください。

実際の支払いで支払い処理をテストするなら、クレジットカードの使用をおすすめします：

1. 決済UIを開く。
2. 決済メソッドのクレジット/デビットカードのグループを選択する。
3. 有効なクレジットカードの詳細情報を入力します。
4. 決済完了後、パブリッシャーアカウントの取引検索セクションをに移動します。
5. テスト取引を選択して、返金をクリックします。（取引のステータスは完了になっています）。

ライブに行く

実際の支払いの処理を開始するには：

1. エクソラとの契約に署名したことを確認してください。
2. secure.xsolla.comリンクで決済ステーションをを開く。またはPay Station Embedスクリプトでサンドボックス-secure.xsolla.comからsecure.xsolla.comまで変更する。
3. トークンを取得する時、"mode":"sandbox"を外す。