よくある質問
- ライブチャット
- メール（integration@xsolla.com）
- アカウントマネージャー
- Basecamp経由の統合スペシャリスト
統合
iframeでPay Stationを開くにはどうすればいいですか？
決済ステーションをPay Station Embedスクリプトを使用してライトボックスで開くことをお勧めします。このスクリプトは：
- 決済ステーションのサイズとデバイスの種類（デスクトップvsモバイル）を自動的に決定する
- 決済インターフェイスからイベントを自動的に受信する
- UIのテーマの変更を可能にする
Iframe内でまだ決済UIを開きたい場合は、次の操作を行う必要があります：
- 端末タイプ（デスクトップvsモバイル）を指定し、トークンのsettings.ui.versionパラメータ内で送信する
- 決済インターフェイスからイベントを受け取るpostMessageメカニズムを実装する
- トークンを取得する
- 決済ステーションのウィンドウサイズをトークンに送信する：
| 決済ステーションサイズ | Iframeの幅 |
|---|---|
| 大（既定サイズ） | 670–850 px |
| 中 | 590–740 px |
| 小 | 510–630 px |
決済ステーションUIをiframeで開くには、以下のリンクを使用します：https://secure.xsolla.com/paystation3/?access_token=ACCESS_TOKENは、ACCESS_TOKENが決済UIトークンです。
ホワイトリストに登録する必要があるXsollaネットワークのIPアドレスは何ですか？
以下のIPアドレスからウェブフックを受け入れ、処理する必要があります：185.30.20.0/24、185.30.21.0/24。
paysafecardを支払い方法に追加する方法を教えてください。
新しい決済方法を追加するには、integration@xsolla.comまでお問い合わせください。
Node.JS/C#/Ruby/Java/ASPなどのSDKはありますか？
現在、PHPとAndroid用のSDKがあります。HTTPSリクエスト機能を備えていれば、任意の言語/プラットフォームを使用して独自のSDKを構築できます。
なぜ私のサイトではPHPライブラリが動作しないのですか？
必要なファイルがすべてインストールされ、相対パスが有効であることを確認してください。GitHubにセットアップの詳細が掲載されています。
ユーザー検証
ユーザーIDは？ユーザーバリデーションはどのように設定すればいいのでしょうか？
ユーザーIDは、ゲーム内でユーザーを識別する方法です。データベースを使用してユーザーIDを保管することができます。無効なユーザーIDが使用されている場合は、例外をスローする必要があります。GitHubでユーザーの確認の確認方法についてご参照いただけます。
バリデーションが完了した後、どのようなデータを返すべきですか？例えば、ユーザーバリデーションが成功した場合と失敗した場合、何を返すべきでしょうか？
ユーザーの確認が成功した場合は、「200」のレスポンスコードを送る必要があります。失敗した場合、レスポンスコード「400」をエラーコード「INVALID_USER」と共に送ります。
プロジェクトの設定
QA、ステージング、本番といった環境ごとに新しいプロジェクトIDを作成する必要があるのでしょうか？
本番環境のプロジェクトに影響を与えないように、別々のプロジェクトを使用することをお勧めします。
秘密鍵、プロジェクト鍵、API鍵の違いは？
秘密鍵とプロジェクト鍵は同じです。秘密鍵は、安全な決済に必要なデジタル署名に使用されます。リクエストのJSON本体をプロジェクトの秘密鍵と連結し、結果の文字列にSHA-1ハッシュを適用します。アカウント内のすべてのプロジェクトで同じAPIキーが使用されます。APIキーは、エクソラサーバーに送信されたAPI呼び出しに使用されます。キーは自分のサーバー上に保存する必要があります。ゲームバイナリやフロントエンドの内部には置かないでください。
WebhookのURLとReturn URLの違いは？
ウェブフックURLは、ご利用のウェブフックサーバーのURLです。リターンURLは、決済完了後にユーザーがリダイレクトされるURLです。
プロジェクトID/マーチャントID/パブリッシャーIDはどこで確認できますか？
プロジェクトIDは、パブリッシャーアカウントのプロジェクト名の横にある番号です。また、次のURLにも記載されています。https://publisher.xsolla.com/{merchant_id}/projects/{project_id}/。マーチャントIDとパブリッシャーIDは同じ番号です。次のURLに記載されています。https://publisher.xsolla.com/{merchant_id}/。
APIキーはどこにありますか？
APIキーを生成するには、パブリッシャーアカウントの会社設定>APIキーに移動してください。
バイクラフトプロジェクトの設定
BuycraftプロジェクトのプロジェクトID/マーチャントID/APIキー/シークレットキーのパラメータはどこで確認できますか？
本ガイドを使用してパラメータを取得し、プロジェクトを設定してください。
BUYCRAFTの設定で、契約情報欄のゲームタイトルには何を入力すればいいですか？
サーバー名を入力してください。
ウェブフックの設定
WebhookプロトコルにHTTPSを使用しますか？
エクソラAPIは、Basic認証を使用しているのでhttpsを使用してください。
webhookのURLに通知が届かないのはなぜですか？
必要なファイルがすべて含まれていること、および必要なタイプのwebhookリクエストを処理するようにwebhookサーバーが設定されていることを確認してください。
なぜウェブフックがモバイルアプリに送信されないのですか？
ウェブフックは、プロジェクトの設定で定義された単一のURLエンドポイントにのみ送信されます。したがって、サーバー間通信のため、色々なURLに送信することはできません。ゲーム、ウェブサイト、またはモバイルアプリケーションへの通知を有効にするには、エクソラとゲームの間でデータをやりとりできるメッセージングソリューションをサーバーに構築することをお勧めします。
カスタマイズ
決済ステーションテーマをカスタマイズできますか？
トークンにsettings.ui.theme = default_darkを送ることで、暗いテーマを選択することができます。暗い色のテーマを使うと、選択した画像や色に背景を設定することもできます（例をご覧ください）。他の設定を変更するには、アカウントマネージャーまでお問い合わせください。
ユーザーに送信されるメッセージの外観を変更できますか？
カスタムメールテーマについては、アカウントマネージャーにお問い合わせください。メール要素は標準テンプレートの一部であるため、レイアウトを変更することはできません。これは、レコードの合法的なマーチャントとして機能するXsollaとのライセンス契約に基づいて必要とされています。
テスト
支払いのテストに使えるダミーのクレジットカード/デビットカードはありますか？
はい、サンドボックスモードでテストカードをご利用ください。
サンドボックスモードでPayPalの流れをテストできますか？
残念ながら、現時点ではサンドボックスモードでPayPalでの支払いはテストできません。
還付金をエミュレートするには？
返金ウェブフックを使用するか、パブリッシャーアカウントでサポート>トランザクション検索に移動できます。
プロジェクトのテストタブにあるXsollaのインボイスIDとインボイスIDは何ですか？
エクソラ請求書IDはお客様のエクソラでの取引IDです。請求書IDはゲーム内での任意の取引IDです。テストの場合は、任意の数値を使用できます。
なぜバイクラフトプロジェクトの試験に合格できないのか？
APIキー、マーチャントID、プロジェクトID、または秘密鍵がBuycraftアカウントに正しく入力されていないと、BuycraftパートナーにINVALID_SIGNATUREが返されます。
決済
Webhookで受信した支払い要求を検証するにはどうすればよいですか？
ユーザーIDを確認してプロジェクトに存在することを確認し、エラーコード「200」を返して決済を確認します。
最後に使用した支払い口座の確認方法を教えてください。
現時点ではこのような確認はできません。
すぐに特定の支払い方法にリダイレクトすることはできますか？
できます。ストアUIを開いた時点でsettings.payment_methodパラメーターを送ってください。ユーザーは、選択された支払方法の支払フォームにすぐにリダイレクトされます。支払い方法のID一覧は、パブリッシャ―アカウントの決済方法セクション、または決済方法を取得するメソッドを使用して確認できます。
支払いを処理した直後に、結果に応じて自動的に成功/失敗した支払いページにリダイレクトすることはできますか？
はい。パブリッシャーアカウントの決済ステーション設定でレダイレクトポリシーを設定します。
エクソラの請求システムは、注文ごとにorder_idを自動的に設定します。トークンを受け取る際、user_idの代わりにorder_idを使うことはできますか？
external_idパラメータにorder_id値を送信できます。パラメータを有効にために、決済ステーション設定でExternal IDをオンにしてください。
トランザクションごとにwebhookのURLを上書きすることはできますか？
いいえ。全取引のウェブフックURLは、パブリッシャ―アカウントで設定できます。
失敗した取引の詳細を送ってもらえませんか？
いいえ。完了した取引のウェブフックのみ送ります。ウェブフックが届いたら、取引が完了したということです。
消費税を支払総額に加算するにはどうすればいいですか？
VATの設定はXsollaで設定します。デフォルトの設定であるVATを自分で支払うのではなく、ユーザーにVATを請求したい場合は、アカウントマネージャーに連絡して設定を変更させていただきます。
PIDとは何を意味するのでしょうか？
PIDはエクソラ側の決済システム識別子です。
ユーザーの仮想通貨残高を更新するには？
残高更新APIメソッドを使用できます。
外部IDはゲーム/プラットフォームのカスタムIDですか？取引のたびに新たに外部IDを作成したほうがいいのでしょうか？
外部IDは、システム上の請求書IDです。一定のexternal_idを使用できる決済は常時1回のみです。したがって、ユーザーが支払いを行うたびに新しいものを送信する必要があります。
setExternalPaymentId メソッドにはどのような値を設定すればよいですか？
external_idと同じ値に設定してください。
PHP SDKでpurchase.description.valueを設定する方法は？
購入内容は、決済ステーションのUIとEメールの領収書で使用されます。トークンに値を設定できます。
ゲートウェイとは？
ゲートウェイでは、決済ステーションのUI内で利用できる支払いシステムから、配当を直接受け取れます。この操作下でお客様側で変わったことはありません。購入ごとにお好きな決済方法をお選びいただけます。つまりここでは、お好きな支払いシステムかアグリゲータを接続して、支払いシステムプロバイダーから配当を直接受け取れることがポイントです。
エクソラの役割は技術サービスプロバイダーとしてのみで、軽減した収益分配（1.25% + $0.10）を受け取ります。そつまり、本格的なエクソラのソリューションを受けることになりますが、次のようなことを引き受けることになります。：
- 税務管理
- 決済機関別契約をサインする
- 決済システムからの直接のお金の流れを維持する
- 決済システムの手数料、チャージバック、払い戻し、ペイアウト手数料、操作コストの管理
例えば、PayPalを使用して直接支払いを受けたい場合、ゲートウェイが必要です。このモデルを使用するとインタフェースは変わりませんが、重要な違いが何点かあります。支払い処理後、エンドユーザー側の料金がPayPalアカウントに直接振り込まれます。この処理にエクソラは関わりません。
BUYCRAFTプロジェクトにはどのようなペイアウト方法がありますか？
Buycraftプロジェクトでは、PayPalおよび銀行振り込みをご利用いただけます。
ユーザーデータ（保存された支払いアカウント、購読など）をXsollaに移行するにはどうすればいいですか？
ユーザーデータの移行については、アカウントマネージャーにお問い合わせください。PGP暗号化を使用してセキュリティを確保してください。
エラーメッセージ
Pay StationのUIを開くと、エラーコードが出てきます。0004-0008.これは何を意味するのか？
サンドボックスモードに間違ったURLを使用しています。実際の支払いをしたい場合は、secure.xsolla.comを使用してください。テスト決済をしたい場合は、sandbox-secure.xsolla.comを使用してください。エラーの詳細については、APIリファレンスをご参照ください。
エクソラPHP SDKはINVALID_CLIENT_IPエラーを返します。どうすればいいの？
ウェブフックサーバにリバースプロキシIPアドレスを追加してください。
2205や2207のエラー(ユーザーIDエラー)は何を意味しているのでしょうか？
これらのエラーは、有効なユーザーIDが必要であることを意味します。データベースからユーザーIDを使用していることを確認してください。
1000-0003のエラーの意味は？
プロジェクトのモジュールを有効化する必要があります。また、チェックアウトの場合は、購入パラメータが不足している可能性があります。
0002-0004のエラーの意味は？
このエラーは、払い戻しを受け取るために契約書に署名する必要があることを意味します。アカウントマネージャーまたはonboarding@xsolla.comまでご連絡ください。
webhookリクエストでAuthorizationヘッダーが見つからないのはなぜですか？
.htaccessまたはhttpd.confApacheファイルを編集する必要があります。詳細については、SDK説明書をご覧ください。
SSLの問題でトークン文字列が取得できないのでしょうね。インターフェイスのSSL検証は必須ですか？
既定では、SSLサーバ証明書の検証を有効にし、オペレーティングシステムが提供する既定のCAバンドルを使用します。SSLエラーのトラブルシューティング方法の詳細については、SDK説明書をご覧ください。