テスト購入を行う

テストを行う際には、実際の銀行口座からお金を引き出す必要はありません。代わりに、テストカードのうちの1つを使用できます。

サンドボックス環境を利用するには、トークン取得時の指定されたアイテムで注文を作成するコールのリクエスト本文に“sandbox”: trueパラメータを渡します。

決済UIを開くには、以下のURLをご利用ください：https://sandbox-secure.xsolla.com/paystation4/?token=TOKEN。TOKENは取得したトークンです。

本番環境に切り替えるには：

ライセンス契約を締結します。
トークン取得時にリクエストボディから“sandbox”: trueパラメータを削除します。
以下のリンクから決済UIを開きます：https://secure.xsolla.com/paystation4/?token=TOKEN。

最初の実際の支払いが行われた後、厳格なサンドボックス支払いポリシーが有効になります。サンドボックスモードでの支払いは、アドミンページでの会社設定 > ユーザーセクションで指定されたユーザーのみが利用できます。

サンドボックスモードで決済UIを開く

この方法では、ゲームキーの販売には対応していません。ゲームキーを販売するには、以下の手順に従ってください。

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

Copy

Full screen

Small screen

<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からイベントを取得できます。これらのイベントは分析システムに送信できます。分析システムでイベント処理を設定するには、カスタマーサクセスマネージャーに連絡するか、csm@xsolla.comに電子メールを送信してください。

エクソーラチームは、決済UIのウェブサイトへの統合を簡素化するウィジェットを作成しました。ウィジェットスクリプトはGitHubリポジトリにあります。

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

パラメータ	種類	説明文
access_token	string	APIから受信したトークン。必須。
sandbox	boolean	決済処理をテストするには、`true`に設定します。`sandbox-secure.xsolla.com`が`secure.xsolla.com`の代わりに使用されます。
lightbox	object	ライトボックスパラメータ（オブジェクト、デスクトップバージョンのみ）。
lightbox.width	string	ライトボックスのフレームの高さ。`null`の場合、ペイステーションの高さに依存します。既定は`null`です。
lightbox.height	string	ライトボックスのフレームの高さ。`null`の場合、ペイステーションの高さに依存します。既定は`100%`です。
lightbox.zIndex	integer	配置順序を定義します。既定は`1000`です。
lightbox.overlayOpacity	integer	ウィジェットの背景の不透明度（`0` — 完全透明、`1` — 完全不透明）。デフォルト値は60%です（`.6`）。
lightbox.overlayBackground	string	オーバーレイの背景色。既定は`#000000`。
lightbox.modal	boolean	`true`の場合、ライトボックスフレームを閉じることはできません。既定は`false`です。
lightbox.closeByClick	boolean	`true`の場合、オーバーレイをクリックするとライトボックスが閉じます。既定は`true`です。
lightbox.closeByKeyboard	boolean	`true`の場合、ESCを押すとライトボックスが閉じます。既定は`true`です。
lightbox.contentBackground	string	フレームの背景色。デフォルトは`#ffffff`。これらの色の変更は、ペイステーションiframe自体には影響を与えず、それを保持するライトボックスの設定のみに影響を与えることに注意してください。
lightbox.contentMargin	string	フレームマージン。既定は`10px`です。
lightbox.spinner	string	ローディングアニメーションのインジケータの種類。`xsolla`または`round`に指定できます。既定は`xsolla`です。
lightbox.spinnerColor	string	スピナーの色。既定値はありません。
childWindow	object	ペイステーションUIを含む子ウィンドウのオプション。モバイル版でサポートされています。
childWindow.target	string	ペイステーションウィンドウを開く場所。`_blank`、`_self`、`_parent`に指定できます。既定は`_blank`です。

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

イベントの一覧：

パラメータ	説明文
init	ウィジェットが初期化されました。
open	ウィジェットが開かれました。
load	決済インターフェース（ペイステーション）が読み込まれました。
close	決済インターフェース（ペイステーション）が閉じられています。
status	ユーザーはステータスページにいます。
status-invoice	ユーザーはステータスページにいます。支払いが進行中です。
status-delivering	ユーザーはステータスページにいます。支払いが完了しました。支払い通知が送信されました。
status-done	ユーザーはステータスページにいます。支払いはユーザーのアカウントに振り込まれます。
status-troubled	ユーザーはステータスページにいます。支払いに失敗しました。

決済UIのオープンを初期化する場合は、次のリンクを使用してください。https://secure.xsolla.com/paystation4/?token=TOKEN。

https://のプレフィックスが付いたリンクは、決済画面を開くときにのみ使用する必要があります。

テストには次のURLを使用してください。https://sandbox-secure.xsolla.com/paystation4/?token=TOKEN。

access_tokenパラメータにはプライベートユーザーデータが含まれます。このパラメータを取得するときは、必ずサーバー間通信を使用してください。

テスト支払いを行う

支払い処理をテストするには、サンドボックスモードを使用します。サンドボックスモードは独立した環境で、実際の支払いと拒否された支払いを除き、ライブ環境のすべての機能をサポートします。注文を作成するときに“sandbox”: trueを送信すると、サンドボックスモードにアクセスできます。

エクソーラと契約する前に、支払いプロセスをテストすることはサンドボックスモードでのみ可能です。

サンドボックスモードで決済UIを開きます。
決済方法の「クレジットカード」を選択します。
クレジットカードの詳細を入力します。他のフィルドで（例えば、名前または住所）、いずれかのデータを入力できます。間違った内容（カード番号や有効期限）を指定して、エラーが発生するかどうかをテストすることもできます。
支払うをクリックします。

テストカード一覧

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

カード情報に加えて、以下の条件のうち少なくともひとつに該当する場合は、郵便番号の指定が必要です：

ユーザーの国は、米国またはカナダです。
銀行識別番号（BIN）は、カードが米国で発行されたことを示します。

有効な郵便番号（例：12345）を指定することができます。これは消費税率を決定するもので、テスト支払の進行に影響を与えるものではありません。
サンドボックスモードでは、テストバンクカードのみを使用できます。サンドボックス銀行カードでの決済は、次の通貨で行うことができます：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。

サンドボックスモードでは、クレジットカードとPayPalを使用して、1 回限りの支払いと、保存された支払い方法での支払いをテストできます。

サンドボックスモードで行われたトランザクションを確認するには：

アドミンページを開きます。
会計 > トランザクションレジストリに移動します。
テストトランザクションを表示するボックスのチェックを入れます。

進捗状況

最終更新日: 2024年1月31日

誤字脱字などのテキストエラーを見つけましたか？テキストを選択し、Ctrl+Enterを押します。

Your browser is not supported. Please try a different browser

決済ソリューション

テスト購入を行う

サンドボックスモードで決済UIを開く

access_token

sandbox

lightbox

lightbox.width

lightbox.height

lightbox.zIndex

lightbox.overlayOpacity

lightbox.overlayBackground

lightbox.modal

lightbox.closeByClick

lightbox.closeByKeyboard

lightbox.contentBackground

lightbox.contentMargin

lightbox.spinner

lightbox.spinnerColor

childWindow

childWindow.target

テスト支払いを行う