一般情報
決済UIは、ペイステーション製品をベースにしています。利用可能な決済方法の選択とその他の設定は、ペイステーションセクションのアドミンページで利用可能です。
SDKは、カタログからのワンクリック購入やショッピングカート経由での商品購入に対応しています。
購入プロセスをテストするために、決済UIのサンドボックスモードとテストカードを使用することができます。サンドボックスモードは、決済方法の動作をシミュレートするだけで、実際のお金が絡んでいません。サンドボックスを試すために、エクソーラと契約を結んだり、手数料を支払う必要はありません。
ハウツー
ユーザーが支払いを完了した後に別のページにリダイレクトするには、2種類のリダイレクトを構成することができます:
- 自動 — 遅延時間を設定したリダイレクト。
- 手動 — ユーザーがリダイレクトボタンをクリックした後、リダイレクトされます。
リダイレクトは次の方法で設定できます:
- アドミンページで — 単一アプリケーション用のプロジェクトを設定していて、異なるプラットフォーム用のビルドを作成する予定がない場合は、このオプションを使用してください。
- SDK設定で — 以下の場合には、このオプションを使用してください:
- プロジェクトを複数のアプリケーションに使用する
- 異なるプラットフォーム向けにビルドを作成する
- ウェブサイト経由でゲーム内アイテムを販売する
アドミンページでのリダイレクトを構成する
- アドミンページでプロジェクトを開きます。
- サイドメニューのペイステーションをクリックします。
- 設定 > リダイレクトポリシーセクションに移動します。
- リターンURLフィールドに、支払い後にユーザーがリダイレクトされるURLまたはパスを入力します。
app://xpayment.<ANDROID_PACKAGE_NAME>
で、<ANDROID_PACKAGE_NAME>
はAndroidアプリケーションのパッケージ名。app://xpayment.<BUNDLE_ID>
で、<BUNDLE_ID>
はiOSアプリケーションの識別子です。
- 自動リダイレクトパラメータを設定するには:
- ドロップダウンリストから、以下の自動リダイレクト条件を選択する場合:
- なし — リダイレクトしません。
- 決済成功 — 決済が成功したときにリダイレクトします。
- 決済成功またはキャンセル — 決済が成功またはキャンセルされたときにリダイレクトされます。
- 任意の決済 — 任意の決済状況にリダイレクトします。
- 遅延フィールドに、リダイレクトタイムアウトを秒単位で入力します。デフォルトでは、リダイレクトは0秒でアクティブになります。
- ドロップダウンリストから、以下の自動リダイレクト条件を選択する場合:
- 手動リダイレクトパラメータを設定するには:
- ドロップダウンリストから、手動リダイレクト条件を選択します:
- なし — リダイレクトしません。
- 決済成功 — 決済が成功するとリダイレクトボタンが表示されます。
- 決済成功またはキャンセル — 決済が完了したときやキャンセルされたときに、リダイレクトボタンが表示されます。
- 任意の決済 — すべての支払いステータスにリダイレクトボタンが表示されます。
- リダイレクトボタンキャプションフィールドに、ユーザーをリターンURLにリダイレクトさせるボタンのコピーを入力します。
- ドロップダウンリストから、手動リダイレクト条件を選択します:
リダイレクトボタンのコピーは、デフォルトでゲームに戻るになっています。すべてのペイステーション言語にローカライズされています。
プロジェクトが複数の言語をサポートしている場合は、それぞれのフィールドでそれぞれのリダイレクトボタンのコピーを指定できます。
ユーザーが決済UIを閉じると、指定されたリターンURLにもリダイレクトされます。
- 保存をクリックします。
SDK設定でリダイレクトを構成する
リダイレクトパラメータをinit
メソッドに渡します。そのためには、以下のAndroidビルドの例に従って、プロジェクトのソースコードにCocos Creatorで行を追加します。リダイレクトパラメータを設定します:
useSettingsFromPublisherAccount
でfalse
を渡します。returnUrl
パラメータで、支払い後にユーザーがリダイレクトされるURLまたはパスを渡します。
app://xpayment.<ANDROID_PACKAGE_NAME>
で、<ANDROID_PACKAGE_NAME>
はAndroidアプリケーションのパッケージ名。app://xpayment.<BUNDLE_ID>
で、<BUNDLE_ID>
はiOSアプリケーションの識別子です。
- 自動リダイレクトパラメータを設定するには:
redirectCondition
パラメータで、以下のリダイレクトがアクティブになった場合、条件を渡します:PaymentRedirectCondition.none
— リダイレクトしません。PaymentRedirectCondition.successful
— 支払いが成功するとリダイレクトします。PaymentRedirectCondition.successful_or_canceled
— 支払いが成功またはキャンセルされたときにリダイレクトします。PaymentRedirectCondition.any
— 任意の決済状況にリダイレクトします。
redirectDelay
パラメータで、リダイレクトタイムアウトを秒単位で渡します。
- 手動リダイレクトパラメータを設定するには:
redirectStatusManual
パラメータで、以下のリダイレクトボタンが表示される場合、決済状況を渡します:PaymentRedirectCondition.none
— リダイレクトしません。PaymentRedirectCondition.successful
— 支払いが成功するとリダイレクトします。PaymentRedirectCondition.successful_or_canceled
— 支払いが成功またはキャンセルされたときにリダイレクトします。PaymentRedirectCondition.any
— 任意の決済状況にリダイレクトします。
redirectButtonCaption
パラメータで、リダイレクトタイムアウトを秒単位で渡します。
リダイレクトボタンのコピーは、デフォルトでゲームに戻るになっています。すべてのペイステーション言語にローカライズされています。
プロジェクトが複数の言語をサポートしている場合は、それぞれのフィールドでそれぞれのリダイレクトボタンのコピーを指定できます。
ユーザーが決済UIを閉じると、指定されたリターンURLにもリダイレクトされます。
Androidビルドのリダイレクトの設定例:
- typescript
let redirectPolicySettingsAndroid: RedirectPolicySettings = {
useSettingsFromPublisherAccount: false,
returnUrl: 'app://xpayment.com.example.myapp',
redirectCondition: PaymentRedirectCondition.successful,
redirectDelay: 0,
redirectStatusManual: PaymentRedirectStatusManual.successful,
redirectButtonCaption: 'Back to the game'
};
var settings: XsollaSettings = {
loginId: '<yourLoginId>',
projectId: '<yourProjectId>',
clientId: '<yourClientId>',
enableSandbox: IsSandbox,
redirectPolicySettingsAndroid: redirectPolicySettingsAndroid
}
Xsolla.init(settings);
redirectPolicySettingsAndroid
redirectPolicySettingsIOS
redirectPolicySettingsWebGL
続きを読む
最終更新日: 2024年3月6日誤字脱字などのテキストエラーを見つけましたか? テキストを選択し、Ctrl+Enterを押します。