クイックスタート

統合フロー

支払いソリューションを統合するためには、以下の手順を実行します：

  1. パブリッシャーアカウントでプロジェクトを作成します。1つのプロジェクトは1つのゲームに対応します。複数のゲームがある場合、各ゲームごとにプロジェクトを追加します。
  2. エクソーラ側のカタログに販売したいアイテムを追加します。
  3. ユーザーが支払う注文を作成するテストを行います。
  4. テスト購入を行い、通知の設定を行います。
  5. 実際の支払い処理を開始するために、パブリッシャーアカウントでエクソーラとのライセンス契約に署名します。

お知らせ
ライセンス契約はいつでも統合のどのステップでも署名できますが、審査プロセスには最大で3営業日かかる可能性があることを覚えておいてください。

カタログを作成する

仮想アイテムは、ユーザーが実際通貨や仮想通貨で購入できるゲーム内コンテンツです。エクソーラ側で仮想アイテムのカタログを作成することにより、地域別の価格設定や制限をカスタマイズし、エクソーラプロモーションシステムや定期的に追加・更新される他の機能を利用できます。

仮想アイテムを作成する

アイテムリストを取得する

アイテムのリストを取得するには、仮想アイテムリストを取得するAPIメソッドを呼び出します。

  • リクエストヘッダーには、デフォルトで認証に使用されるXsolla Login JWT（Bearerトークン）を渡します。このAPIメソッドの呼び出しをテストするには、以下のテストトークンを使用できます：Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE5NjIyMzQwNDgsImlzcyI6Imh0dHBzOi8vbG9naW4ueHNvbGxhLmNvbSIsImlhdCI6MTU2MjE0NzY0OCwidXNlcm5hbWUiOiJ4c29sbGEiLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6IjA2SWF2ZHpDeEVHbm5aMTlpLUc5TmMxVWFfTWFZOXhTR3ZEVEY4OFE3RnMiLCJzdWIiOiJkMzQyZGFkMi05ZDU5LTExZTktYTM4NC00MjAxMGFhODAwM2YiLCJlbWFpbCI6InN1cHBvcnRAeHNvbGxhLmNvbSIsInR5cGUiOiJ4c29sbGFfbG9naW4iLCJ4c29sbGFfbG9naW5fcHJvamVjdF9pZCI6ImU2ZGZhYWM2LTc4YTgtMTFlOS05MjQ0LTQyMDEwYWE4MDAwNCIsInB1Ymxpc2hlcl9pZCI6MTU5MjR9.GCrW42OguZbLZTaoixCZgAeNLGH2xCeJHxl8u8Xn2aI.
  • project_idパスパラメータには、アドミンページで見つけられるプロジェクトIDを渡してください。

リクエストでは、プロジェクトで作成された仮想アイテムに関する詳細情報を受け取ります。以降の注文の作成には、items.skuパラメータで渡されるアイテムSKUが必要です。

注文を作成する

注文は、ユーザーがストアで購入したい商品で構成されます。注文の支払いが完了すると、ユーザーはアイテムを受け取ることができます。決済を行うには、ユーザーがゲーム内で認証されている必要があります。

ゲームに合った統合方法を選択すると、設定方法が表示されます。

特性サーバー側クライアント側
サーバーを所有するトークンを取得し、サーバーの負荷を制御するには、独自のサーバーが必要です。独自のサーバーは必要ありません。
ユーザーの国を決定する支払いトークンには、国またはIPアドレスのいずれかを渡す必要があります。これは決済方法の利用可能性に影響します。エクソーラはユーザーの国をIPアドレスによって判定します。
決済通貨を決定するトークンに通貨を渡さない場合、通貨は国によって決まります。
トークンに通貨を渡す場合、ユーザーはその通貨で支払いを行います。		国によって通貨が決定されます。

テスト購入を行う

お知らせ
テストを行う際には、実際の銀行口座からお金を引き出す必要はありません。代わりに、テストカードのうちの1つを使用できます。
注意
エクソーラと契約する前に、支払いプロセスをテストすることはサンドボックスモードでのみ可能です。

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

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

他の方法を使用して決済UIを開く場合は、ドキュメンテーションを参照してください。

テスト支払いを行う

  1. サンドボックスモードで決済UIを開きます。
  2. 決済方法の「クレジットカード」を選択します。
  3. クレジットカードの詳細を入力します。他のフィルドで（例えば、名前または住所）、いずれかのデータを入力できます。間違った内容（カード番号や有効期限）を指定して、エラーが発生するかどうかをテストすることもできます。
  4. 支払うをクリックします。
テストカード一覧
テストバンクカードの一覧を参照してください。
お知らせ
郵便番号に関する情報

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

  • ユーザーの国は、米国またはカナダです。
  • 銀行識別番号（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 回限りの支払いと、保存された支払い方法での支払いをテストできます。

ウェブフックのセットアップ

サーバー側での統合を設定した場合、作成された注文をウェブフックへの応答として送信することによって検証する必要があります。クライアント側で統合を設定した場合、ウェブフックにより、設定されたイベント（例：支払いステータスの変更）に関する通知を受け取ることができます。

ウェブフックの受信を有効にするには：

  1. アドミンページでプロジェクトを開きます。
  2. サイドメニューの「プロジェクト設定」をクリックし、「ウェブフック」タブに移動します。
  3. 「ウェブフックサーバー」フィールドに、https://example.com形式でウェブフックを受信したいサーバーのURLを指定します。ウェブフックをテストするツールで見つけたURLを指定することもできます。
  4. プロジェクトのウェブフックに署名するための秘密鍵がデフォルトで生成されます。新しい秘密鍵を生成したい場合は、更新アイコンをクリックします。
  5. 「ウェブフックを有効にする」をクリックします。

PHP SDK
ウェブフック処理には既製のクラスを使用します。
お知らせ
ウェブフックをテストするには、webhook.siteなどの専用サイトや、ngrokなどのプラットフォームを選択することもできます。
ユーザーの検証および成功した支払いに関する通知を受け取るために、以下のウェブフックを設定してください：
  • ユーザー検証 — ゲームに登録されたユーザーを確認するための通知用。
  • 支払い — 支払いが行われたことを通知するための通知用。
お知らせ
ウェブフックの設定とテストの詳細については、ドキュメンテーションを参照してください。

ウェブフックリスナーを構成する

ウェブフックリスナーは、指定されたURLアドレスで受信したウェブフックを受信し、署名を生成し、エクソーラウェブフックサーバーに応答を送信できるようにするプログラムコードです。
署名の生成とウェブフックへの応答の送信に関する情報

署名の生成

ウェブフックを受信する場合、データ伝送のセキュリティを確保する必要があります。そのためには、ウェブフックのデータから署名を生成し、それがHTTPリクエストヘッダで送信された署名と一致することを検証する必要があります。 署名を生成するには：
  1. リクエスト本文のJSONとプロジェクトの秘密鍵を連結します。
  2. 最初のステップで取得した文字列にSHA-1暗号化ハッシュ関数を適用します。

ウェブフックへの応答の送信

ウェブフックの受信を確認するには、サーバーが以下のことを返す必要があります：
  • 成功した応答の場合は200、201、または204 HTTPコード。
  • 指定されたユーザーが見つからなかったり、無効な署名が渡された場合、問題に関する説明が記載された400 HTTPコードが表示されます。
ウェブフックハンドラーは、サーバーに一時的な問題が発生した場合に5xxコードを返すこともあります。 「ご注文の決済が完了した」と「注文キャンセル」のウェブフックで応答を受信しなかった場合、または5xxコードの応答を受信した場合、以下のスケジュールでウェブフックを再送信します：
  • 5分間隔で2回再試行
  • 15分間隔で7回再試行
  • 60分間隔で10回再試行
ウェブフックの送信は、最初の試行から12時間以内に最大20回まで試行されます。 決済ウェブフックの応答が受信されなかった場合、または5xxコードを含む応答を受け取った場合は、ウェブフックも時間間隔を空けて再送信されます。12時間以内に最大12回の試行が行われます。 ユーザー検証ウェブフックに対する応答が受信されなかった場合、400または5xxのコードを含む応答が受信された場合、ユーザー検証ウェブフックは再送信されません。 この場合、ユーザーにはエラーが表示され、「決済」と「ご注文の決済が完了した」のウェブフックは送信されません。

起動

注意
ライセンス契約にサインする前は、サンドボックスモードのみで決済UIを開くことができます。

ライセンス契約に署名する

ライセンス契約に署名すると、エクソーラがサポートする任意の支払い方法で実際の支払いを受け取ることができます。ライセンス契約に署名するには：

  1. アドミンページを開きます。
  2. サイドメニューで契約と税金 > 契約セクションに移動します。
  3. ライセンス契約タブでアプリケーションフォームに記入するをクリックします。
  4. 該当するフィールドに情報を入力します。

アプリケーションは3営業日以内に審査されます。確認作業中に不明な点があった場合、エクソーラはアプリケーションに記載された連絡先に通知します。エクソーラ側での確認手続きが完了すると、契約書のステータスが署名済みに変更されます。

本番環境へ切り替える

注意
最初の実際の支払いが行われた後、厳格なサンドボックス支払いポリシーが有効になります。サンドボックスモードでの支払いは、アドミンページでの会社設定 > ユーザーセクションで指定されたユーザーのみが利用できます。
上記の手順を完了すると、実際の支払いの受け取りを開始できます：
  1. エクソーラとのライセンス契約に署名していることを確認してください。
  2. トークンを取得するときは、リクエスト本文から“sandbox”: trueパラメータを削除します。
  3. 次のリンクを使用して決済UIを開きます：https://secure.xsolla.com/paystation4/?token=TOKEN。
お知らせ
このガイドでは、統合をクイックスタートするために必要な最小限の設定について説明します。ご不明な点がございましたら、ページ右下のエクソーラチャットからお問い合わせいただくか、カスタマーサクセスマネージャーまでcsm@xsolla.comまでメールにてお問い合わせください。
この記事は役に立ちましたか？
ありがとうございます！
改善できることはありますか？ メッセージ
申し訳ありません
この記事が参考にならなかった理由を説明してください。 メッセージ
ご意見ありがとうございました！
あなたのメッセージを確認し、体験を向上させるために利用させていただきます。
このページを評価する
このページを評価する
改善できることはありますか？

答えたくない

ご意見ありがとうございました！
最終更新日: 2024年3月18日

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

問題を報告する
当社は常にコンテンツを見直しています。お客様のご意見は改善に役立ちます。
フォローアップ用のメールをご提供してください
ご意見ありがとうございました！