Cocos Creator用のSDK / 一般情報
  ドキュメントに戻る

Cocos Creator用のSDK

一般情報

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

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

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

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

ハウツー

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

支払い後にアプリケーションへのユーザーリダイレクトをセットアップする方法

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

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

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

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

  • SDK設定で — 以下の場合には、このオプションを使用してください:
    • プロジェクトを複数のアプリケーションに使用する
    • 異なるプラットフォーム向けにビルドを作成する
    • ウェブサイト経由でゲーム内アイテムを販売する
注意
アドミンページとSDKの設定でリダイレクトが設定されている場合は、SDK設定で指定されたパラメータが使用されます。

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

  1. アドミンページでプロジェクトを開きます。
  2. サイドメニューのペイステーションをクリックします。
  3. 設定 > リダイレクトポリシーセクションに移動します。
  1. リターンURLフィールドに、支払い後にユーザーがリダイレクトされるURLまたはパスを入力します。
お知らせ
ユーザーをモバイルアプリケーションにリダイレクトするには、URLが次のスキームのいずれかに一致する必要があります:

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

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

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

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

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

  1. 保存をクリックします。

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

リダイレクトパラメータをinitメソッドに渡します。そのためには、以下のAndroidビルドの例に従って、プロジェクトのソースコードにCocos Creatorで行を追加します。リダイレクトパラメータを設定します:

  1. useSettingsFromPublisherAccountfalseを渡します。
  2. returnUrlパラメータで、支払い後にユーザーがリダイレクトされるURLまたはパスを渡します。
お知らせ
ユーザーをモバイルアプリケーションにリダイレクトするには、URLが次のスキームのいずれかに一致する必要があります:

  1. 自動リダイレクトパラメータを設定するには:
    1. redirectConditionパラメータで、以下のリダイレクトがアクティブになった場合、条件を渡します:
      • PaymentRedirectCondition.none — リダイレクトしません。
      • PaymentRedirectCondition.successful — 支払いが成功するとリダイレクトします。
      • PaymentRedirectCondition.successful_or_canceled — 支払いが成功またはキャンセルされたときにリダイレクトします。
      • PaymentRedirectCondition.any — 任意の決済状況にリダイレクトします。
    2. redirectDelayパラメータで、リダイレクトタイムアウトを秒単位で渡します。

  1. 手動リダイレクトパラメータを設定するには:
    1. redirectStatusManualパラメータで、以下のリダイレクトボタンが表示される場合、決済状況を渡します:
      • PaymentRedirectCondition.none — リダイレクトしません。
      • PaymentRedirectCondition.successful — 支払いが成功するとリダイレクトします。
      • PaymentRedirectCondition.successful_or_canceled — 支払いが成功またはキャンセルされたときにリダイレクトします。
      • PaymentRedirectCondition.any — 任意の決済状況にリダイレクトします。
    2. redirectButtonCaptionパラメータで、リダイレクトタイムアウトを秒単位で渡します。
注意

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

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

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

Androidビルドのリダイレクトの設定例:

Copy
Full screen
Small screen
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を押します。

問題を報告する
当社は常にコンテンツを見直しています。お客様のご意見は改善に役立ちます。
フォローアップ用のメールをご提供してください
ご意見ありがとうございました!