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

Cocos Creator用のSDK

  • 統合ガイド

  • デモプロジェクト

  • 認証

  • カタログ

  • プロモーション

  • サブスクリプション

  • 商品購入

  • プレイヤーインベントリ

  • ユーザーアカウントと属性


  • 一般情報

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

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

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

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

    ハウツー

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

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

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

    • 自動 — 遅延時間を設定したリダイレクト。
    • 手動 — ユーザーが決済UIを閉じるか、リダイレクトボタンをクリックした後のリダイレクト。

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

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

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

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

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

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

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

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

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

    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
    この記事は役に立ちましたか?
    ありがとうございます!
    改善できることはありますか? メッセージ
    申し訳ありません
    この記事が参考にならなかった理由を説明してください。 メッセージ
    ご意見ありがとうございました!
    あなたのメッセージを確認し、体験を向上させるために利用させていただきます。
    非表示

    続きを読む

    最終更新日: 2023年5月16日

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

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