一般情報

決済UIは、ペイステーション製品をベースにしています。利用可能な決済方法の選択とその他の設定は、ペイステーションセクションのアドミンページで利用可能です。

SDKは、カタログからのワンクリック購入やショッピングカート経由での商品購入に対応しています。

購入プロセスをテストするために、決済UIのサンドボックスモードとテストカードを使用することができます。サンドボックスモードは、決済方法の動作をシミュレートするだけで、実際のお金が絡んでいません。サンドボックスを試すために、エクソーラと契約を結んだり、手数料を支払う必要はありません。

最初の実際の支払いが行われた後、厳格なサンドボックス支払いポリシーが有効になります。サンドボックスモードでの支払いは、アドミンページでの会社設定 > ユーザーセクションで指定されたユーザーのみが利用できます。

決済UIを開く方法は、アプリケーションが構築されたプラットフォームによって異なります：

デスクトップアプリケーションの場合、SDKを使用すると、プロジェクト設定に応じて内部ブラウザで決済UIを開くことができます。
モバイルアプリケーションでは、決済UIは外部ブラウザで開きます。

モバイルアプリケーションのWebViewで決済UIを開く場合は、ユーザーが購入のどの段階でも決済UIを閉じることができるようにボタンを追加します。これを行うには、UXsollaStoreSubsystem::FetchPaymentTokenまたはUXsollaStoreSubsystem::FetchCartPaymentToken SDKメソッドを呼び出す時に、FXsollaPaymentTokenRequestPayload構造のPurchaseParamsパラメータのbShowCloseButtonフィールドにtrueを渡します。

ボタンに表示されるアイコンを選択できます。これを行うには、PurchaseParamsパラメータのCloseButtonIconフィルドで、次のいずれかの値を渡します：

“arrow” — ←アイコンを表示する
“cross” — ×アイコンを表示する（デフォルトで使用される）

WebViewでのbShowCloseButtonとCloseButtonIconパラメータの使用例：

ハウツー

高度な設定については、ハウツーをご覧ください。

すべてを展開する

すべてを折りたたむ

ユーザーが支払いを完了した後に別のページにリダイレクトするには、2種類のリダイレクトを構成することができます：

自動 — 遅延時間を設定したリダイレクト。
手動 — ユーザーがリダイレクトボタンをクリックした後、リダイレクトされます。

リダイレクトは次の方法で設定できます：

アドミンページで — 単一アプリケーション用のプロジェクトを設定していて、異なるプラットフォーム用のビルドを作成する予定がない場合は、このオプションを使用してください。

SDK設定で — 以下の場合には、このオプションを使用してください：
- プロジェクトを複数のアプリケーションに使用する
- 異なるプラットフォーム向けにビルドを作成する
- ウェブサイト経由でゲーム内アイテムを販売する

アドミンページとSDKの設定でリダイレクトが設定されている場合は、SDK設定で指定されたパラメータが使用されます。

アドミンページでのリダイレクトを構成する

アドミンページでプロジェクトを開きます。
サイドメニューのペイステーションをクリックします。
設定 > リダイレクトポリシーセクションに移動します。

リターンURLフィールドに、支払い後にユーザーがリダイレクトされるURLまたはパスを入力します。

ユーザーをモバイルアプリケーションにリダイレクトするには、URLが次のスキームのいずれかに一致する必要があります：

app://xpayment.<ANDROID_PACKAGE_NAME>で、<ANDROID_PACKAGE_NAME>はAndroidアプリケーションのパッケージ名。
app://xpayment.<BUNDLE_ID>で、<BUNDLE_ID>はiOSアプリケーションの識別子です。

自動リダイレクトパラメータを設定するには：
1. ドロップダウンリストから、以下の自動リダイレクト条件を選択する場合：
  - なし — リダイレクトしません。
  - 決済成功 — 決済が成功したときにリダイレクトします。
  - 決済成功またはキャンセル — 決済が成功またはキャンセルされたときにリダイレクトされます。
  - 任意の決済 — 任意の決済状況にリダイレクトします。
2. 遅延フィールドに、リダイレクトタイムアウトを秒単位で入力します。デフォルトでは、リダイレクトは0秒でアクティブになります。

手動リダイレクトパラメータを設定するには：
1. ドロップダウンリストから、手動リダイレクト条件を選択します：
  - なし — リダイレクトしません。
  - 決済成功 — 決済が成功するとリダイレクトボタンが表示されます。
  - 決済成功またはキャンセル — 決済が完了したときやキャンセルされたときに、リダイレクトボタンが表示されます。
  - 任意の決済 — すべての支払いステータスにリダイレクトボタンが表示されます。
2. リダイレクトボタンキャプションフィールドに、ユーザーをリターンURLにリダイレクトさせるボタンのコピーを入力します。

リダイレクトボタンのコピーは、デフォルトでゲームに戻るになっています。すべてのペイステーション言語にローカライズされています。

プロジェクトが複数の言語をサポートしている場合は、それぞれのフィールドでそれぞれのリダイレクトボタンのコピーを指定できます。

ユーザーが決済UIを閉じると、指定されたリターンURLにもリダイレクトされます。

保存をクリックします。

SDK設定でリダイレクトを構成する

Unreal Engineプロジェクトを開きます。
Settings > Project Settings > Plugins > Xsolla Settings > Redirect Policyセクションに移動します。
以下のリダイレクトパラメータを指定します：

1. Use settings from Publisher Accountチェックボックスのチェックを外します。
2. Return URLフィールドに、支払い後にユーザーがリダイレクトされるURLまたはパスを入力します。

ユーザーをモバイルアプリケーションにリダイレクトするには、URLが次のスキームのいずれかに一致する必要があります：

app://xpayment.<ANDROID_PACKAGE_NAME>で、<ANDROID_PACKAGE_NAME>はAndroidアプリケーションのパッケージ名。
app://xpayment.<BUNDLE_ID>で、<BUNDLE_ID>はiOSアプリケーションの識別子です。

1. 自動リダイレクトパラメータを設定するには：
  1. ドロップダウンリストから、以下のRedirect Conditionsを選択します：
    - None — リダイレクトしません。
    - Successful payment — 支払いが成功するとリダイレクトします。
    - Successful or canceled payment — 支払いが成功またはキャンセルされたときにリダイレクトします。
    - Any payment — 任意の決済状況にリダイレクトします。
  2. Redirect Delayフィールドに、リダイレクトタイムアウトを秒単位で入力します。

1. 手動リダイレクトパラメータを設定するには：
  1. ドロップダウンリストから以下のStatus for Manual Redirectionを選択します：
    - None — リダイレクトしません。
    - Successful payment — 決済が成功するとリダイレクトボタンが表示されます。
    - Successful or canceled payment — 決済が成功またはキャンセルされると、リダイレクトボタンが表示されます。
    - Any payment — すべての支払いステータスにリダイレクトボタンが表示されます。
  2. Redirect Button Captionフィールドに、ユーザーをリターンURLにリダイレクトするボタンのコピーを入力します。

リダイレクトボタンのコピーは、デフォルトでゲームに戻るになっています。すべてのペイステーション言語にローカライズされています。

プロジェクトが複数の言語をサポートしている場合は、それぞれのフィールドでそれぞれのリダイレクトボタンのコピーを指定できます。

ユーザーが決済UIを閉じると、指定されたリターンURLにもリダイレクトされます。

ご意見ありがとうございました！

あなたのメッセージを確認し、体験を向上させるために利用させていただきます。

非表示

エクソーラは、プレイヤーがSteam経由でゲーム内購入の支払いを行う際に、決済ゲートウェイとして機能することができます。この場合、インゲームストアを設定する際に、Steam SDKを統合したり、Steam経由での支払いのニュアンスを考慮したりする必要はありません。

Steam経由の決済を設定するには：

エクソーラと追加契約を締結します。

エクソーラは、Steam経由で決済を行う際に、収益分配を減らします。詳細はカスタマーサクセスマネージャーに確認してください。

アドミンページでSteamのゲートウェイを設定します。
Unreal Engineプロジェクトに移動します。
Settings > Project Settings > Plugins > Xsolla Settingsに移動して、Build for Steamボックスをチェックします。
Steam経由でネイティブ認証を設定します。

Unreal Engineプロジェクトの設定を変更した後、決済トークンリクエストにx-steam-useridヘッダーが追加されます。

ご意見ありがとうございました！

あなたのメッセージを確認し、体験を向上させるために利用させていただきます。

非表示

続きを読む

トップの支払い方法の管理方法ユーザーにメールをカスタマイズする方法

ワンクリック購入仮想通貨の購入ショッピングカート経由の購入単一のアイテムの購入注文状況を追跡する

最終更新日: 2024年8月1日

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

Your browser is not supported. Please try a different browser