非推奨

新しいCommerce APIメソッドの使い方

どのように動作するか

Commerce APIを接続します:

  • すでにXsollaでサーバー統合(トークンによる統合)を実施しているが、新しいCommerce APIのメソッドに切り替えたい場合
  • 新たなスタートのために店舗のサーバー部分を実装したい場合

主な機能:

  • エクソラログイン経由の認証
  • 決済ステーションアクセストークン経由の認証
  • 仮想アイテム管理
  • ユーザーインベントリ管理
  • カートおよび注文管理

使用に適した方

  • ストアインターフェースを開発し、サードパーティのソリューションを使用してサーバー側を実装したいパートナー。
  • エクソラとのサーバー統合を既に実装済みで新しいストアと新しいCommerce APIメソッドを接続したいパートナー。

入手方法

アプリにCommerce APIを接続するには:

  1. パブリッシャーアカウント仮想アイテムモジュールを設定します。
  2. 認証を設定します。
  3. ストア管理メソッドを実装します。

統合するには、プロジェクト設定 > Webhookに表示されるプロジェクトIDまたはマーチャントIDが必要です。

認証設定

以下のユーザー認証オプションを利用できます:

エクソラログイン経由の認証

  1. パブリッシャーアカウントでのプロジェクトをセットアップします
  2. JSONウェブトークンまたはOAuth 2.0プロトコルを使用して、認証メソッドの呼び出しを実装します。

ユーザーデータがエクソラデータストレージに保存されている場合には、以下のメソッドの呼び出しを実装します:

ユーザーデータがPlayFabのデータストレージに保存されている場合は、PlayFabのハウツーをご利用ください。

ユーザーデータをあなたの側で保存されている場合は、カスタムストレージのハウツーをご利用ください。

決済ステーションアクセストークンを介した認証

認証フロー:

  1. あなたのアプリケーション(クライアント)は、認証リクエストをあなたのサーバーに送信します。
  2. あなたのサーバは認証トークンを要求し、project_id/merchant_idapi_keyのパラメータを含むヘッダをエクソラサーバーに送信します。
  3. エクソラサーバーは、パラメータaccess_token認証トークンをあなたのサーバに送信します。
  4. あなたのサーバーはパラメータaccess_tokenをクライアントに送信します。

返されたaccess_tokenCommerce APIでの認証のための認証トークンとして使用されます。また、ストアインターフェースの構築のためにも使用されます。

ストア管理の方法

ベースとなる店舗管理方法を導入する必要があります:

アイテム管理のリストを取得する

  • Get virtual items list — ストアに追加されたバーチャルアイテムの全リストを表示するため
  • Get item groups list — あなたのストアに追加された仮想アイテムのグループの全リストを表示するため
  • バンドルを取得する — カタログを作成するため:

カートと注文管理

  • カートを取得する — 仮想アイテムを購入するため — Get cart by IDまたはGet current user’s cart。パラメータcard_idアイテムの追加または削除に使用されます。
  • Get order — 購入がすでに処理されているかどうかを判断します。次の注文ステータスが可能です。
    • New — 注文は作成されますが、支払われません
    • Paid — 注文は支払われました
    • Canceled — 注文はキャンセルされました
    • Done — 注文が支払われ、アイテムがインベントリに追加されました

Note
ステータスの確認は一定の頻度で実行されるべきです。1度だけの確認だと、注文に新しいステータスが付与される前に確認される可能性があるためです。

作成された注文はNewオーダーステータスを受取ります。

新しいウィンドウで決済UIを開くには、以下のリンクをご利用ください:https://secure.xsolla.com/paystation3/?access_token=ACCESS_TOKEN、ここでACCESS_TOKENは注文作成時に受け取ったトークンです。

決済プロセスをテストするには:

  1. 次のURLを使用します:https://sandbox-secure.xsolla.com/paystation3/?access_token=ACCESS_TOKEN
  2. リクエストでサンドボックスパラメータをtrueに設定します。
  3. テストに銀行カードのリストを使用します。

ユーザーインベントリ管理

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

答えたくない

ご意見ありがとうございました!
最終更新日: 2021年6月25日

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

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