アイテム購入のセットアップ
エクソーラデータにアクセスするために、プロジェクトに最も適した方法を選択してください：
アプリケーションのクライアント側で注文を作成する
1つのSKUを持つアイテムを任意の数量で販売することも、ユーザーが事前に入力された異なるSKUを持つアイテムをカートに入れて販売することもできます。エクソーラ側のユーザーとアイテムに関するデータを使用して注文を作成するには、次のいずれかのAPIコールを使用します：
使用されるAPIコールは、決済UIを開いて支払いを行うために必要な支払いトークンを返します。サンドボックスモードを使用するには、トークンを取得するためのリクエスト本文に“sandbox”: trueパラメータを渡します。
決済UIを開く
決済UIを新しいウィンドウで開くには、以下のURLをご利用ください：https://sandbox-secure.xsolla.com/paystation4/?token=TOKEN。TOKENは取得したトークンです。
また、他のオプションを使って決済UIを開くこともできます：
- ペイステーション埋め込みを利用します。制限：ゲーム内ブラウザ（WebView）で開くと不具合が発生する場合があります。
- iframeで。制限：をゲーム内ブラウザ（WebView）やモバイル版アプリケーションで開くと、不具合が発生する場合があります。
テスト支払いを行う
支払い処理をテストするには、サンドボックスモードを使用します。サンドボックスモードは独立した環境で、実際の支払いと拒否された支払いを除き、ライブ環境のすべての機能をサポートします。注文を作成するときに“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。
サンドボックスモードで行われたトランザクションに関する手数料を含む詳細情報を確認するには：
- アドミンページを開きます。
- 「会計 > トランザクションレジストリ」に移動します。
- 「テストトランザクションを表示する」ボックスのチェックを入れます。
さらに、アドミンページでの「サポート > トランザクション検索」セクションでトランザクションの詳細を確認し、返金をリクエストすることができます。
誤字脱字などのテキストエラーを見つけましたか？ テキストを選択し、Ctrl+Enterを押します。
