サブスクリプション購入

アプリケーションにサブスクリプション購入を実装するには、以下のロジックに従ってください:

  1. 購入可能なサブスクリプションプランのリストを取得し、ユーザーに表示します。
  2. ユーザーが選択したプランの購入処理を開始します。

簡易的な実装については、サンプルをご参照ください。

注意

サブスクリプションの購入および管理は、認証済みのユーザーのみが利用可能です。ユーザー認証にSDKを使用する方法については、認証のセクションをご参照ください。

コードサンプルでは、サブスクリプションのワークフローのデモンストレーションを簡略化するため、ユーザー名とパスワードによるパスワード認証(XsollaAuth.SignInメソッド)を使用し、認証情報をハードコードしています。実際のアプリケーションでは、完全な認証ロジックを実装し、XsollaAuth.AuthBySavedTokenメソッドを使用して現在のセッションの有効性を確認する必要があります。

サブスクリプションプランリストの取得

パブリッシャーアカウントで設定されたプランのリストを取得するには、XsollaSubscriptions.GetSubscriptionPublicPlansまたはXsollaSubscriptions.GetSubscriptionPlansメソッドを呼び出します。返されたデータ(PlanItemオブジェクト)を使用して、アプリケーション内にサブスクリプションカタログを表示します。

UIウィジェット設定の主要フィールド:

  • plan_name — サブスクリプション名。
  • plan_description — プランの特典に関する説明。
  • charge — 価格(amount)と通貨(currency)を含むオブジェクト。
  • period — 請求期間。

サブスクリプション購入の開始

ユーザーが選択したサブスクリプションプランの購入を開始するには、XsollaSubscriptions.GetSubscriptionPurchaseUrlメソッドを呼び出し、planExternalIdパラメータを渡します。リクエストが成功すると、サブスクリプション管理UIへのリンクを含むPaymentLinkオブジェクトがコールバック関数に渡されます。このリンクを外部ブラウザまたはビルドインのWebViewで開くには、XsollaWebBrowser.Openメソッドを使用してください。

お知らせ

注文ステータスを追跡するには、ウェブフックの処理を設定し、アプリケーションのサーバー側で注文情報を受け取る必要があります。これにより、完了した購入に対して追加の検証を実装できるようになります。

ウェブフックの設定とテストに関する詳細については、サブスクリプション情報の取得セクションをご参照ください。

この記事は役に立ちましたか?
ありがとうございます!
改善できることはありますか? メッセージ
申し訳ありません
この記事が参考にならなかった理由を説明してください。 メッセージ
ご意見ありがとうございました!
あなたのメッセージを確認し、体験を向上させるために利用させていただきます。
最終更新日: 2026年4月14日

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

問題を報告する
当社は常にコンテンツを見直しています。お客様のご意見は改善に役立ちます。
フォローアップ用のメールをご提供してください
ご意見ありがとうございました!
フィードバックを送信できませんでした
後でもう一度お試しいただくか、doc_feedback@xsolla.comまでお問い合わせください。