UIにMetaframeの仮想通貨販売を実装する方法

メタフレームウィジェットを使用せずに仮想通貨を販売できます。たとえば、独自のストアUIを実装したり、別の認証サービスを使用したりする場合などです。そのためには、購入ロジック、仮想通貨オートチャージ、ユーザー残高表示ロジックをMetaframe APIで実装する必要があります。

前提条件

開始する前に、必要なプロジェクト設定を行います：

1. プロジェクトを作成します。
2. アドミンページで仮想通貨パッケージを作成します。
3. 必要なIDと秘密鍵を取得します。これを行うには、カスタマーサクセスマネージャーに連絡し、csm@xsolla.comまたはintegration@xsolla.comまでお問い合わせください。アドミンページから以下の情報を提供してください：

• マーチャントIDは、次の場所にあります：
  • 会社名の横に表示されます。
  • 「会社設定 > 会社」セクションにあります。
  • 任意のアドミンページのブラウザアドレスバーにあるURLの中で。URLは以下の形式です：https:​//publisher.xsolla.com/マーチャントID/パブリッシャーアカウントのセクション。

• プロジェクトIDはプロジェクト名の横にあります。

• プロジェクトのウェブフックに署名するための秘密鍵で、「プロジェクト設定 > ウェブフック」セクションにあります。

• APIキーは、作成時に一度だけアドミンページに表示され、お客様側で保存する必要があります。新しいキーは、次のセクションで作成することができます：
  • 会社設定 > APIキー。
  • プロジェクト設定 > APIキー。

エクソーラチームは、さらなる設定に必要な以下の情報を提供します：

• ホストID
• エクソーラアカウント OAuth 2.0 クライアントID
• エクソーラアカウント OAuth 2.0 クライアント秘密鍵

サーバートークンを取得する

サーバートークンは、ユーザーアクセストークンの取得とオートチャージのために必要です。

アプリケーションのバックエンドで、JWTを生成するAPIコールを使用してサーバーJSONウェブトークン（JWT）を取得するメソッドを実装します。リクエストには、以下のパラメータを含める必要があります：

• grant_typeはJWTタイプで、client_credentialsの値を渡します。
• client_secretはエクソーラから受け取った秘密鍵です。
• client_idはエクソーラから受け取ったクライアントIDです。

ユーザーアクセストークンを取得する

ユーザー認証トークンは、決済トークンを生成し、ユーザーの仮想通貨残高を要求するために必要です。

独自の認証システムを使用している場合は、以下を使用して適切な認証トークンを取得できます。

• ソーシャルネットワークのアクセストークン
• カスタムID — サーバーで生成されたユーザーID

ソーシャルログイン時にトークンを取得する

1. アドミンページでソーシャルネットワーク経由でユーザー認証を設定します：

1. 1. アドミンページでプロジェクトを開きます。
   2. サイドメニューで「ログイン」をクリックします。
   3. 「ログインプロジェクト」をクリックします。
   4. 「標準ログインプロジェクト」を選択し「作成して設定する」をクリックします。新しいログインプロジェクトが作成されると、ログインプロジェクト設定のページが表示されます。
   5. 「ログイン方法」ブロックで、「ソーシャルログイン」を選択し、「設定」をクリックします。
   6. ソーシャルログインに使用するソーシャルネットワークをアプリケーションに接続します。
   7. パンくずリストでログインプロジェクトの名前をクリックして、「ログイン」プロジェクトページに戻ります。
   8. 「セキュリティブロック」に移動し、「JWT署名セクションを選択します。
   9. 署名生成アルゴリズムとして「RS256」を選択し、「変更を保存する」をクリックします。

2. アプリケーションのクライアント側では、ソーシャルネットワークのアクセストークンを介した認証APIコールを使用してトークンの受信と更新を実装します。

カスタムIDでトークンを取得する

アプリケーションのバックエンドで、カスタムIDによる認証APIコールを使用してトークンを取得し、更新するメソッドを実装します。リクエストはX-Server-Authorization: <server_JWT>ヘッダーを含まなければなりません。ここで、<server_JWT>は前のステップで取得したサーバーJWTです。

APIコールで仮想通貨を管理する