よくある質問

こちらに回答が見つからない場合、次のいずれかでお手伝いいたします:

  • ライブチャット
  • Eメール(integration@xsolla.com
  • アカウント・マネージャー
  • 統合スペシャリスト(Basecamp経由)

統合

質問 決済ステーションをiframeで開くにはどうしたらいいですか?

回答 決済ステーションをPay Station Embedスクリプトを使用してライトボックスで開くことをお勧めします。このスクリプトは:

  • 決済ステーションのサイズとデバイスの種類(デスクトップvsモバイル)を自動的に決定する
  • 決済インターフェイスからイベントを自動的に受信する
  • UIのテーマの変更を可能にする

Iframe内でまだ決済インターフェイスを開きたい場合は、次の操作を行う必要があります。

  • 端末タイプ(デスクトップvsモバイル)を指定し、トークンのsettings.ui.versionパラメータ内で送信する
  • 決済インターフェイスからイベントを受け取るpostMessageメカニズムを実装する
  • トークンを取得
  • 決済ステーションのウィンドウサイズをトークンに送信する:

決済ステーションのサイズIframeの幅
大(既定サイズ)670~850px
590~740px
510~630px

Iframeで決済ステーション UIを開くには、次のリンクを使用してください。https://secure.xsolla.com/paystation2/?access_token=ACCESS_TOKEN、ここでACCESS_TOKENは決済インターフェイスのトークンです。

質問 決済ステーションUIとパブリッシャ―アカウントが対応しているブラウザを教えてください。

回答 決済ステーション UIとパブリッシャーアカウントをご利用頂く際に、動作保証しているブラウザは以下になります。

  • Google Chrome 49以上
  • Mozilla Firefox 45以上
  • Opera 36以上
  • Internet Explorer 11
  • Microsoft Edge 12 以上
  • Safari 9以上
  • Android ブラウザ 49以上

質問 ホワイトリスト登録をしなくてはいけないエクソラ ネットワーク IP アドレスを教えてください。

回答 以下のIPアドレスからウェブフックを受け入れ、処理する必要があります:185.30.20.0/24、185.30.21.0/24。

質問 エクソラ Network / ストアfront / ログインなどの新しいエクソラ製品の統合方法を教えてください。

回答 エクソラ製品を統合するには、integration@xsolla.comまでお問い合わせください。

質問 支払い方法にpaysafecardを追加するにはどうすればよいですか?

回答 新しいお支払い方法を追加するには、integration@xsolla.comまでお問い合わせください。

質問 Node.JS / C#.NET / Ruby / Java / ASPなどのSDKはありますか?

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

質問 自分のサイトでPHPライブラリが動作しないのはなぜですか?

回答 必要なファイルがすべてインストールされており、相対パスが有効であることを確認してください。設定に関する詳細はGitHubをご覧ください。

ユーザーの確認

質問 ユーザーIDとは何ですか?ユーザーの確認方法を教えてください。

回答 ユーザーIDは、ゲーム内でユーザーを識別する方法です。データベースを使用してユーザーIDを保管することができます。無効なユーザーIDが使用されている場合は、例外をスローする必要があります。GitHubでユーザーの確認の確認方法についてご参照いただけます。

質問 確認処理が完了したら、どのデータを返す必要がありますか?例えば、ユーザーの確認が成功、または失敗した場合、何を返す必要がありますか?

回答 ユーザーの確認が成功した場合は、「200」のレスポンスコードを送る必要があります。失敗した場合、レスポンスコード「400」をエラーコード「INVALID_USER」と共に送ります。

プロジェクト設定

質問 パブリッシャーアカウントで有効にしたモジュールを起動する方法を教えてください。

回答 モジュールを起動する前に、モジュールを設定してテストする必要があります。詳細については、統合ガイドをご参照ください。ウェブフックの受信に問題がある場合は、ウェブフックサーバーが正しくインストールされているかご確認ください。問題が解決しない場合は、integration@xsolla.comまでお問い合わせください。

質問 すべての環境(QA、ステージング、プロダクションなど)で新しいプロジェクトIDを作成する必要がありますか?

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

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

回答 秘密鍵プロジェクト鍵は同じです。秘密鍵は、安全な決済に必要なデジタル署名に使用されます。リクエストのJSON本体をプロジェクトの秘密鍵と連結し、結果の文字列にSHA-1ハッシュを適用します。アカウント内のすべてのプロジェクトで同じAPIキーが使用されます。APIキーは、エクソラサーバーに送信されたAPI呼び出しに使用されます。APIキーは、自分のサーバー上に保存する必要があります。ゲームバイナリやフロントエンドの内部には置かないでください。

質問 ウェブフックURLとリターン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キーに移動してください。

質問 同僚に自分のパブリッシャ―アカウントにアクセスを許可する方法を教えてください。

回答 パブリッシャーアカウントの会社設定>ユーザーでメンバーを招待できます。

質問 モバイルゲームの販売元ですが、プロジェクト設定ページの「ウェブサイト」の欄には何を記入したらいいですか?

回答 御社のゲームのウェブサイトのURL、または御社のウェブサイトのURLを記入してください。

Buycraftプロジェクト設定

質問 BuycraftプロジェクトのプロジェクトID/マーチャントID/APIキー/秘密鍵パラメーターはどこで取得できますか?

回答ガイドを使用してパラメータを取得し、プロジェクトを設定してください。

質問 Buycraft設定の契約情報セクションにあるゲームタイトルには、何を入力したらいいですか?

回答 サーバー名を入力してください。

ウェブフックの設定

質問 ウェブフックプロトコルにはHTTPSを使うべきですか?

回答 エクソラAPIは、Basic認証を使用しているのでhttpsを使用してください。

質問 ウェブフックURLが通知を受け取らなかった理由を教えてください。

回答 必要なファイルがすべて含まれていること、そして、必要な種類のウェブフックリクエストを処理できるようにウェブフックサーバーが設定されていることを確認してください。

質問 ウェブフックがモバイルアプリに送信されない理由を教えてください。

回答 ウェブフックは、プロジェクトの設定で定義された単一のURLエンドポイントにのみ送信されます。したがって、サーバー間通信のため、色々なURLに送信することはできません。ゲーム、ウェブサイト、またはモバイルアプリケーションへの通知を有効にするには、エクソラとゲームの間でデータをやりとりできるメッセージングソリューションをサーバーに構築することをお勧めします。

カスタマイズ

質問 決済ステーションのテーマをカスタマイズできますか?

回答 トークンにsettings.ui.theme = default_darkを送ることで、暗いテーマを選択することができます。暗い色のテーマを使うと、選択した画像や色に背景を設定することもできます(を参照)。他の設定を変更するには、アカウントマネージャーまでお問い合わせください。

質問 ユーザーに送信されるメッセージの外観を変更できますか?

回答 カスタムメールテーマについては、アカウントマネージャーまでお問い合わせください。Eメール要素のレイアウトは、標準テンプレートの一部であるため、変更することはできません。これは、正当な最終販売責任を負う商業者として機能するエクソラとの使用許諾契約書に基づき必要となります。

テスト

質問 テスト決済に使えるテスト用のクレジット/デビットカードはありますか?

回答 はい、サンドボックスモードでテストカードをご利用ください。

質問 サンドボックスモードでPayPalのフローをテストできますか?

回答 残念ながら、現時点ではサンドボックスモードでPayPalでの支払いはテストできません。

質問 払い戻しのエミュレーションの仕方を教えてください。

回答 返金ウェブフックを使用するか、パブリッシャーアカウントでサポート>トランザクション検索に移動できます。

質問 プロジェクトの「テスト」タブにある「エクソラ請求書ID」と「請求書ID」とは何ですか?

回答 エクソラ請求書IDはお客様のエクソラでの取引IDです。請求書IDはゲーム内での任意の取引IDです。テストの場合は、任意の数値を使用できます。

質問 なぜBuycraftプロジェクトのテストに通過できないのでしょうか?

回答 APIキーマーチャントIDプロジェクトID、または秘密鍵がBuycraftアカウントに正しく入力されていないと、BuycraftパートナーにINVALID_SIGNATUREが返されます。

決済

質問 ウェブフックで受け取った決済のリクエスト確認方法を教えてください。

回答 ユーザーIDを確認してプロジェクトに存在することを確認し、エラーコード「200」を返して決済を確認します。

質問 最後に使用された決済アカウントの確認方法を教えてください。

回答 現時点ではこのような確認はできません。

質問 ユーザーを特定の支払い方法にリダイレクトできますか?

回答 できます。ストアUIを開いた時点でsettings.payment_methodパラメーターを送ってください。ユーザーは、選択された支払方法の支払フォームにすぐにリダイレクトされます。支払い方法のID一覧は、パブリッシャ―アカウントの決済方法セクション、または支払い方法の取得メソッドを使用して確認できます。

質問 結果に応じて、決済を処理した直後に自動的にユーザーを「決済成功/失敗」ページにリダイレクトすることはできますか?

回答 はい。パブリッシャーアカウントの決済ステーション設定でレダイレクトポリシーを設定します。

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

回答 external_idパラメータにorder_id値を送信できます。パラメータを有効にために、決済ステーション設定でExternal IDOnにしてください。

質問 全取引のウェブフックURLを上書きできますか?

回答 いいえ。全取引のウェブフックURLは、パブリッシャ―アカウントで設定できます。

質問 失敗した取引の詳細を受け取ることはできますか?

回答 いいえ。完了した取引のウェブフックのみ送ります。ウェブフックが届いたら、取引が完了したということです。

質問 支払総額にVATを追加する方法を教えてください。

回答 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および銀行振り込みをご利用いただけます。

質問 ユーザーデータ(保存済み決済アカウント、サブスクリプションなど)を、エクソラへ移動するには?

回答 アカウントマネージャーに連絡して、ユーザーデータを移動してください。PGP暗号化を必ず使用して、安全性を確保してください。

クーポン

質問 スタンドアロンクーポンとプロモーション用のクーポンの違いは何ですか?

回答 スタンドアロンのクーポンを使用すると、ユーザーがクーポンコードを交換する代わりに無料のアイテムが手に入るように設定できます。プロモーション用のクーポンは、購入時にユーザーに割引とボーナスを提供することができます。

サブスクリプション

質問 サブスクリプションのproduct_idとは何ですか?

回答 このパラメーターは、一人のユーザーが色々なサービスで複数の有料サブスクリプションを購読している場合に使用できます。product_idを使ってユーザーが購読している複数のサブスクリプションを区別できます。

エラーメッセージ

質問 決済ステーション 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までご連絡ください。

質問 ウェブフックのリクエストで認証ヘッダが見つからない理由を教えてください。

回答 .htaccessまたはhttpd.confApacheファイルを編集する必要があります。詳細については、SDKのドキュメンテーションをご覧ください。

質問 SSLエラーのため、トークン文字列が取得できません。エクソラのインターフェイスはSSLサーバ証明書を必須としていますか?

回答 既定では、SSLサーバ証明書の検証を有効にし、オペレーティングシステムが提供する既定のCAバンドルを使用します。SSLエラーのトラブルシューティング方法の詳細については、SDKのドキュメンテーションをご覧ください。