よくある質問

統合

iframeでペイステーションを開くにはどうすればいいですか？

ペイステーション埋め込みスクリプトを使用して、ライトボックスで決済UIを開くことをお勧めします。このスクリプトを使用すると、次のことが可能になります：

  • 決済UIサイズとデバイスタイプ（デスクトップ、モバイル）を自動判別
  • 決済UIからのイベントを自動的に受信する
  • UIテーマを変更する

Iframeで決済UIを開くには：

  1. postMessageメカニズムを実装して、決済UIからイベントを受け取ります。
  2. リンクhttps://sandbox-secure.xsolla.com/paystation4/?token=TOKENをたどって決済UIを開き、TOKEN は受信したトークンです。

潜在的な問題：iframeで決済UIを開いたときに、一部の決済システムで必要な決済確認コードをコピーするボタンが表示されない場合は、iframeにallow=“clipboard-read; clipboard-write; payment”属性を渡します。

例：

Copy
Full screen
Small screen
  • html
<iframe
  src="https://sandbox-secure.xsolla.com/paystation4/?token=TOKEN"
  width="800"
  height="700"
  allow="clipboard-read; clipboard-write; payment"
></iframe>

ウェブフックWebhookを設定するために許可リストに追加する必要があるエクソーラネットワークIPアドレスは何ですか？

以下のIPアドレスからウェブフックを受信して処理する必要があります：

  • 185.30.20.0/24
  • 185.30.21.0/24
  • 185.30.23.0/24

ログイン製品を統合した場合は、以下のIPアドレスから処理ウェブフックを追加します：

  • 35.236.32.131
  • 34.94.154.26
  • 34.94.14.95
  • 34.102.48.30
  • 34.94.115.185
  • 34.94.173.132
  • 35.236.35.100
  • 35.236.117.164
  • 34.94.0.85
  • 35.235.99.248
  • 34.94.25.33

Node.JS/C#/Ruby/Java/ASPなどのSDKはありますか？

現在、PHPとAndroid用のSDKがあります。HTTPSリクエスト機能がある限り、任意の言語/プラットフォームを使用して独自のSDKを構築できます。

ユーザー検証

ユーザーIDとは何ですか？

ユーザーIDは、ゲーム内でユーザーを識別するためのパラメータです。ユーザーIDは、データベースに保存することができます。無効なユーザーIDを受信した場合は、例外を投げます。ユーザー認証の例については、GitHubリポジトリを参照してください。

検証が完了した後、どのデータを返しますか?

検証が成功すると、HTTPコード200を返します。エラーの場合は、コード400（INVALID_USER）になります。

プロジェクトの設定

各環境（QA、ステージング、プロダクション）ごとに新しいプロジェクトを作成する必要がありますか？

テスト用には、本番環境に影響を与えないように、別々のプロジェクトを使用することをお勧めします。

秘密鍵、プロジェクト鍵、API鍵の違いは何ですか？

秘密鍵とプロジェクトキーは同じものです。安全な決済処理を行う際に必要となる電子署名に使用されます。リクエストのJSONボディとこの鍵が連結され、その結果がSHA-1でハッシュ化されます。

APIキーはエクソーラサーバーに送信されるAPIコールに使用されます。このキーは自分のサーバーで保持する必要があり、決してバイナリファイルやフロントエンドの中に入れてはいけません。APIキーの操作の詳細については、API リファレンスを参照してください。

ウェブフックURLとリターンURLの違いは何ですか？

ウェブフックURLは、通知を送信するウェブフックサーバーのURLアドレスです。リターンURLは、決済完了後にユーザーがリダイレクトされるURLアドレスです。

プロジェクトIDはどこにありますか？

アドミンページでプロジェクトを開き、プロジェクト設定 > 一般設定セクションに移動します。

マーチャントIDはどこにありますか？

アドミンページを開き、会社設定 > 会社セクションに移動します。

お知らせ
マーチャントIDは、パブリッシャーIDと同じです。

APIキーはどこにありますか？

APIキーは、作成時に一度だけアドミンページに表示され、お客様側で保存する必要があります。次のセクションでキーを作成できます：

  • 会社設定 > APIキー
  • プロジェクト設定 > APIキー

注意

APIキーの操作については、APIリファレンスを参照してください。

キーに関する推奨事項：

  • 生成されたAPIキーは、お客様側で保存してください。APIキーは、アドミンページで作成時に一度だけ表示することができます。
  • APIキーは秘密にしておいてください。APIキーは、お客様の個人アカウントとアドミンページのプロジェクトへのアクセスを提供します。
  • APIキーはサーバーに保存する必要があり、決してバイナリやフロントエンドに保存してはいけません。

必要なAPIコールにproject_idパスパラメータが含まれていない場合は、会社のすべてのプロジェクトで有効なAPIキーを使用して認証を設定します。

ウェブフックの設定

ウェブフックプロトコルにHTTPSを使用する必要がありますか？

はい。

エクソーラの通知がウェブフックURLに送信されなかったのはなぜですか？

ウェブフックサーバーが必要なタイプのHTTPリクエスト（POST、GET）をサポートしていることを確認してください。

ウェブフックがモバイルアプリケーションに送信されないのはなぜですか？

ウェブフックは、プロジェクト設定で指定された単一のURLアドレスにのみ送信されます。サーバー間であるため、ウェブフックを複数のURLアドレスに送信することはできません。ゲーム、ウェブサイト、またはモバイルアプリケーションで通知を受け取りたい場合は、エクソーラとゲームの間でデータを渡すようにサーバーにウェブフックを送信するように設定してください。

カスタマイズ

決済UIのテーマをカスタマイズすることはできますか？

トークンでsettings.ui.theme = default_darkパラメータを送信すると、ダークテーマを有効にすることができます。ダークテーマでは、背景画像の設定や背景色（デモと同じ）の変更が可能です。その他の設定を変更する場合は、カスタマーサクセスマネージャーにお問い合わせるか、csm@xsolla.comに電子メールを送信してください。

ユーザーに送信されるメールの外観を変更できますか？

はい。ユーザー向けのメールをカスタマイズする方法に関する説明に従ってください。メールの要素の順序は、標準テンプレートの一部であるため、変更できません。これは、レコードの法的なマーチャントとして機能するエクソーラとのライセンス契約に従って必要となります。

テスト

テストカードで決済テストはできますか？

ただし、アプリケーションまたはペイステーションデモをサンドボックスモードで実行した場合のみです。異なるブランドや発行国のテストカードの一般的なリストを参照してください。

PayPalの決済フローをサンドボックスモードでテストできますか？

はい、詳しくは説明をご覧ください。

決済返金をテストする方法は何ですか？

返金をリクエストするAPIコールを使って返金のテストを行うことができます。詳細については、説明書を参照してください。

アドミンページのウェブフックテストタブにあるエクソーラ請求書IDと請求書IDとは何ですか？

エクソーラ請求書IDは、エクソーラ側のトランザクションIDです。テストのため、任意の数値を使用することができます。

請求書IDは、ゲーム内の任意のトランザクションIDです。テストのため、文字と数字の組み合わせで自由に入力できます。

決済ソリューション

ウェブフックで受信した支払い要求を検証するにはどうすればよいですか？

まず、指定したユーザーIDがプロジェクトに存在するかどうかを確認します。次に、コード200を返し、支払いを検証します。

ユーザーを特定の決済方法にリダイレクトすることはできますか？

ストアUIを開く際に、settings.payment_methodパラメータで決済方法IDを渡すことができます。この場合、ユーザーは選択した決済方法の決済フォームにリダイレクトされます。決済方法IDのリストは、アドミンページの「ペイステーション > 決済方法」セクションで確認できます。

決済処理後、結果に応じて自動的に決済成功/失敗のページにリダイレクトすることは可能ですか？

はい、リダイレクト条件を構成できます。詳細については、説明を参照してください。

エクソラの請求システムは、注文ごとにorder_idを自動的に設定します。トークンを受け取る際、user_idの代わりにorder_idを使うことはできますか？

いいえ、すべてが正しく機能するためにはuser_idが必要です。

さらに、external_idパラメータでorder_idを渡すことができます。これを行うには：

  1. アドミンページを開きます。
  2. ペイステーション > 設定セクションに移動します。
  3. 追加の設定ブロックで、トランザクションexternal IDのトグルをオンに設定します。

トランザクションごとにウェブフックのURLを上書きすることはできますか？

いいえ、すべてのトランザクションのウェブフックURLは、アドミンページのプロジェクト設定で設定されています。

取引に失敗した場合、その内容を教えてもらえますか？

いいえ、エクソーラはトランザクションが成功した場合のみウェブフックを送信します。もしあなたが支払いに関する通知を受け取ったなら、それはトランザクションが成功したことを意味します。

支払総額に付加価値税を加えるにはどうしたらよいですか？

VAT設定は、デフォルトではエクソーラ側で設定されています。設定を変更し、ユーザーの支払総額にVATを追加したい場合は、カスタマーサクセスマネージャーにお問い合わせるか、csm@xsolla.comまでメールを送信してください。

PIDとは何ですか？

PIDはエクソーラ側の決済方法識別子です。

External IDとは何ですか？

External IDは、ゲーム内のトランザクションIDであり、システム内のオーダーに割り当てられます。エクソーラ側では、External IDはトランザクションIDにリンクされています。そのため、External IDを有効にすることで、エクソーラは同じトランザクションの繰り返しの支払いを防ぐことができます。

注意
External IDは、テスト（サンドボックスモード）とライブ環境の両方で、ユーザーごとの支払いで一意である必要があります。例：“external_id”: “1”でテスト支払いを行っている場合、“external_id”: “1”で実際の支払いを行うことはできません。
プロジェクトでexternal IDを有効にするには：
  1. アドミンページでプロジェクトを開き、「ペイステーション > 設定」セクションに移動します。
  2. 「トランザクション外部ID」トグルを「オン」に切り替えます。

トランザクションごとに新しいExternal IDを生成する必要がありますか？

はい。External IDは、支払いごとに一意である必要があります。

setExternalPaymentIdメソッドにはどのような値を設定する必要がありますか？

setExternalPaymentIdメソッドがある場合は、external_idと同じ値を持つ必要があります。

ゲートウェイとは？

決済システムと契約を結ぶと、ゲートウェイを利用して、これらの決済オプションを決済UIに表示することができます。プレイヤーは、選択された支払方法を使用して購入代金を支払うことができ、これらの支払システムプロバイダから直接支払いを受けることになります。ゲートウェイを接続するには、アドミンページでプロジェクトを開き、ペイステーション > ゲートウェイセクションに移動します。

エクソーラは技術サービスプロバイダーとして機能し、減額された収益分配を受け取ります：取引金額の1.25% + $0.10。エクソーラのすべてのソリューションにフルアクセスできるようになりますが、以下のことを行う必要があります：

  • 税務関連の問題を管理する
  • 各決済システムと個別の契約に署名する
  • 決済システムから直接的に資金が流れる
  • 決済システムの手数料、チャージバックと返金、支払い手数料、および運用コストを管理する

例えば、PayPalと連携し、直接の決済手段として設定したい場合は、ゲートウェイを接続します。決済UIに変更はありません。支払い処理後、プレイヤーのお金はあなたのPayPalアカウントに振り込まれます。この場合、エクソーラはペイアウトのプロセスに関与していません。

ユーザーデータ（保存された支払いアカウント、購読など）をXsollaに移行するにはどうすればいいですか？

カスタマーサクセスマネージャーまでお問い合わせるか、csm@xsolla.comに電子メールを送信してください。データのセキュリティを確保するには、必ずPGP暗号化を使用してください。

エクソーラのPGPキーパラメータ：

  • キーID：FBA38225
  • キーの種類：RSA
  • キーの長さ：4096
  • フィンガープリント：4D63 4B67 B265 5464 D39D 7228 67B0 672A FBA3 8225
  • ユーザーID：admins@xsolla.com

Copy
Full screen
Small screen
  • html
-----BEGIN PGP PUBLIC KEY BLOCK-----
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
=7AyM
-----END PGP PUBLIC KEY BLOCK-----

ユーザーの国はどのように判定されますか？

支払いトークンを生成するためにクライアント側のAPIコールを使用すると、エクソーラはリクエストのIPアドレスからユーザーの国を判定します。

支払いトークン生成のためのサーバー側のAPIコールを使用する場合、国は、以下の逐次チェックによって判定されます：

  • リクエスト本文のuser.country.valueパラメータの値
  • X-User-Ipヘッダー内のIPアドレス

これらの値がどれも渡されない場合、エラーが表示されます。両方の値が渡された場合、リクエスト本文の情報が使われます。

エラーメッセージ

お知らせ
決済UIを開く際に起こりうるエラーの詳細については、ドキュメンテーションを参照してください。

0004-0008エラーが発生した場合はどうすればよいですか？

正しいURLアドレスを使用しているかどうか確認します：

2205または2207エラー（ユーザーIDエラー）が発生した場合はどうすればよいですか？

  • データベースから有効なユーザーID（user_id）を渡します。
  • ウェブフックの使い方に関する推奨事項：
    • ウェブフックを使用しない場合は、プロジェクトでウェブフックが無効になっていることを確認してください。そのためには、アドミンページから、プロジェクト設定 > ウェブフックのセクションで、トグルをオフに設定します。
    • ウェブフックを使用する場合は、ユーザー検証用ウェブフックの処理を成功させるように実装してください。

1000-0003エラーが発生した場合はどうすればよいですか？

プロジェクトの各モジュールを有効化します。

0002-0004エラーが発生した場合はどうすればよいですか？

エクソーラとライセンス契約を結び、支払いを受けてください。サポートが必要な場合は、カスタマーサクセスマネージャーを連絡してまたはonboarding@xsolla.comまでメールしてください。

3032エラーが発生した場合はどうすればよいですか？

エラーのある決済トークン、またはユーザーID、プロジェクトIDに関する情報を、利用可能なコミュニケーションチャネルを通じて統合チームに送信します。
お知らせ
決済トークンは、開いた決済UIのURLアドレスに記載されています。決済UIがiframeで開かれる場合、iframeを右クリックし、ドロップダウンリストからiframeのソースを表示するオプションを選択します。

ウェブフックリクエストで認証ヘッダーが見つからないのはなぜですか？

このエラーを修正するには、.htaccessまたはhttpd.conf Apacheファイルを編集する必要があります。詳細については、SDKドキュメンテーションを参照してください。

お問い合わせ先

よくある質問で質問に対する回答が見つからない場合は、他のチャネルまでお問い合わせください：
  • 右下隅のチャットアイコンをクリックし、メッセンジャー経由で統合チームに連絡してください。リアルタイムで問題を解決する回答が得られます。
  • integration@xsolla.comにメールを送ってください。
  • カスタマーサクセスマネージャーまでお問い合わせるか、csm@xsolla.comに電子メールを送信してください。
  • Basecamp経由で統合スペシャリストにお問い合わせください。
カスタマーサービス統合ガイド（PDF）
カスタマーサービスチームと統合するためのオプションについて説明しています。
この記事は役に立ちましたか？
ありがとうございます！
改善できることはありますか？ メッセージ
申し訳ありません
この記事が参考にならなかった理由を説明してください。 メッセージ
ご意見ありがとうございました！
あなたのメッセージを確認し、体験を向上させるために利用させていただきます。
最終更新日: 2024年8月30日

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

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