決済設定
ユーザー検証
ユーザーIDとは何ですか？
ユーザーIDは、ゲーム内でユーザーを識別するためのパラメータです。ユーザーIDは、データベースに保存することができます。無効なユーザーIDを受信した場合は、例外を投げます。ユーザー認証の例については、GitHubリポジトリを参照してください。
検証が完了した後、どのデータを返しますか?
検証が成功すると、HTTPコード200を返します。エラーの場合は、コード400（INVALID_USER）になります。
カスタマイズ
決済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を渡すことができます。これを行うには：
- パブリッシャーアカウントでプロジェクトを開き、プロジェクト設定 > 統合設定セクションに移動します。
- external IDを使用するチェックボックスをオンにします。
- 「保存」をクリックします。
トランザクションごとにウェブフックのURLを上書きすることはできますか？
いいえ、すべてのトランザクションのウェブフックURLは、パブリッシャーアカウントのプロジェクト設定で設定されています。
取引に失敗した場合、その内容を教えてもらえますか？
いいえ、エクソーラはトランザクションが成功した場合のみウェブフックを送信します。もしあなたが支払いに関する通知を受け取ったなら、それはトランザクションが成功したことを意味します。
支払総額に付加価値税を加えるにはどうしたらよいですか？
VAT設定は、デフォルトではエクソーラ側で設定されています。設定を変更し、ユーザーの支払総額にVATを追加したい場合は、カスタマーサクセスマネージャーにお問い合わせるか、csm@xsolla.comまでメールを送信してください。PIDとは何ですか？
PIDはエクソーラ側の決済方法識別子です。
external IDとは何ですか？
external IDは、ゲーム内のトランザクションIDであり、システム内のオーダーに割り当てられます。エクソーラ側では、external IDはトランザクションIDにリンクされています。そのため、external IDを有効にすることで、エクソーラは同一トランザクションに対する重複支払いを防ぐことができるのです。
“external_id”: “1”でテスト支払いを行っている場合、“external_id”: “1”で実際の支払いを行うことはできません。- パブリッシャーアカウントでプロジェクトを開き、プロジェクト設定 > 統合設定セクションに移動します。
- 決済ソリューションセクションで、必要なチェックボックスを選択します：
- external IDを使用する — トークン作成時にexternal IDの検証を必須にします。
- external IDの検証をスキップする — トークン作成時に外部IDの検証を無効にします。
- 「保存」をクリックします。
「ユーザーのexternal ID」設定が有効になっている場合、パブリッシャーアカウントを通じてテスト決済を行うことはできません。テスト支払いを正常に行うには、一時的にこの設定を無効にしてください。
トランザクションごとに新しいexternal IDを生成する必要がありますか？
はい。external IDは、支払いごとに一意である必要があります。
setExternalPaymentIdメソッドにはどのような値を設定する必要がありますか？
setExternalPaymentIdメソッドがある場合は、external_idと同じ値を持つ必要があります。
ゲートウェイとは？
決済システムと契約を結ぶと、ゲートウェイを利用して、これらの決済オプションを決済UIに表示することができます。プレイヤーは、選択された決済方法を使用して購入代金を支払うことができ、これらの決済システムプロバイダから直接出金を受け取ることになります。ゲートウェイを接続するには、パブリッシャーアカウントでプロジェクトを開き、決済ソリューション > 決済設定 > ゲートウェイセクションに移動します。
エクソーラは技術サービスプロバイダーとして機能し、減額された収益分配を受け取ります：取引金額の1.25% + $0.10。エクソーラのすべてのソリューションにフルアクセスできるようになりますが、以下のことを行う必要があります：
- 税務関連の問題を管理する
- 各決済システムと個別の契約に署名する
- 決済システムから直接的に資金が流れる
- 決済システム手数料、チャージバックと返金、出金手数料、および運営コストを管理する
たとえば、PayPalを利用していて、直接決済方法として設定したい場合は、ゲートウェイを接続することで対応できます。決済UIに変更はありません。出金プロセス後、プレイヤーのお金はあなたのPayPalアカウントに振り込まれます。この場合、エクソーラは出金プロセスに関与していません。
ユーザーデータ（保存された支払いアカウント、購読など）をXsollaに移行するにはどうすればいいですか？
カスタマーサクセスマネージャーまでお問い合わせるか、csm@xsolla.comに電子メールを送信してください。データのセキュリティを確保するには、必ずPGP暗号化を使用してください。
エクソーラのPGPキーパラメータ：
- キーID：DA1E62CB
- キーの種類：RSA
- キーの長さ：4096
- フィンガープリント：0209 8489 757F 4451 F431 FB0C FBFC 4D97 DA1E 62CB
- ユーザーID：admins@xsolla.com
1-----BEGIN PGP PUBLIC KEY BLOCK-----
2
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
62=naL7
63-----END PGP PUBLIC KEY BLOCK-----
ユーザーの国はどのように判定されますか？
決済トークンを生成するためにクライアント側のAPIコールを使用すると、エクソーラはリクエストのIPアドレスからユーザーの国を判定します。
決済トークンを生成する用のサーバー側のAPIコールを使用する場合、国は、以下の逐次チェックによって判定されます：
- リクエスト本文の
user.country.valueパラメータの値 X-User-Ipヘッダー内のIPアドレス
これらの値がどれも渡されない場合、エラーが表示されます。両方の値が渡された場合、リクエスト本文の情報が使われます。
誤字脱字などのテキストエラーを見つけましたか？ テキストを選択し、Ctrl+Enterを押します。
