決済トークンの取得方法

決済UIを開くには、トークンを取得する必要があります。トークンとは、ゲームとユーザーに関する暗号化されたデータを含む文字列です。トークンを取得してユーザーを識別し、購入を許可するように実装する必要があります。

決済トークンを取得するには：

1. ユーザー認証トークンを取得します。
2. 注文を作成します。

ユーザー認証トークンを取得する

トークンの有効期限は、最後にエクソーラAPIを呼び出してから24時間後です。有効期限が切れた後に新しいトークンを受け取るロジックを実装してください。ユーザーがアプリケーションに再ログインする必要がないように、バックグラウンドで新しいトークンを取得することをお勧めします。

アプリケーションのバックエンドで、ユーザー認証トークンの取得を実装します。これを行うには、基本的なHTTP認証を含むHTTP POSTリクエストを使用し、リクエスト本文で必要なパラメータを渡します。

APIリファレンス

パラメータの全リストを参照してください。

基本HTTP認証

エクソーラAPIは基本アクセス認証を採用しています。APIに対する全リクエストは、Authorization: Basic <your_authorization_basic_key>ヘッダーを含む必要があります。<your_authorization_basic_key>はマーチャントID：APIキーのペアで、Base64の基準に従ってエンコードしています。パブリッシャーアカウントに移動して、次のパラメータを見つけます：

• マーチャントIDは以下の場所で表示されます：
  • 会社設定 > 会社セクション。
  • パブリッシャーアカウントページのブラウザーアドレスバーのURL。URLは以下の形式があります：https://publisher.xsolla.com/<merchant_id>/。

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

リクエスト本文

リクエスト本文に、以下の必須パラメータを渡します：

ユーザーエクスペリエンスを向上させるために、以下のパラメータを渡すこともできます：

 1curl -i -X POST \
 2  -u 2340:ZHgbSDVP6LtAJVWu \
 3  https://api.xsolla.com/merchant/v2/merchants/<merchant_id>/token \
 4  -H 'Content-Type: application/json' \
 5  -d '{
 6    "settings": {
 7      "currency": "USD",
 8      "language": "en",
 9      "project_id": <project_id>
10      }
11    },
12    "user": {
13      "email": {
14        "value": "<user_email>"
15      },
16      "id": {
17        "value": "<user_id>"
18      },
19      "name": {
20        "value": "<user_name>"
21      }
22    }
23  }'

応答で受け取ったユーザー認証トークンの例

1{
2    "token": "1230OWrp0KF6uqvmN8jWuzLyoXMzxTyK_lc_en"
3}

決済トークンを取得する

レスポンスでは、今後の作業に必要なデータを受け取ります：

• token — 決済トークン