アイテム購入のセットアップ

アプリケーションのサーバー側で注文を作成する

エクソーラ側でユーザーとアイテムのデータを持つオーダーを作成するには、購入のための決済トークンを作成するAPIコールを使用します。このメソッドは、決済UIを開いて支払いを行うために必要な支払いトークンを返します。サンドボックスモードを使用するには、トークンを取得するためのリクエストの本文に“sandbox”: trueパラメータを渡します。

制限：

• 決済トークンをリクエストするときは、ユーザーの国またはユーザーのIPアドレスを渡す必要があります。これらのデータを使用して、システムは購入通貨、決済インターフェースをローカライズするための言語を決定し、税金を計算します。
• トークンに通貨を渡さない場合、通貨は国によって決まります。
• トークンに通貨を渡す場合、ユーザーはその通貨で支払いを行います。
• user_idパラメータには、認証システムからのユーザーIDを渡す必要があります。このIDは、購入前にユーザーを検証するために使用されます。テスト時には、このパラメータに任意のシンボルを渡すことができます。

決済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. 「テストトランザクションを表示する」ボックスのチェックを入れます。

さらに、アドミンページでの「サポート > トランザクション検索」セクションでトランザクションの詳細を確認し、返金をリクエストすることができます。