友達へのギフト

仕組み

友達へのギフト機能は、ユーザーが仮想通貨、仮想アイテム、またはゲームアクセスキーを実際の通貨で購入し、ゲーム内の友達にギフトとして送ることを可能にします。支払いが成功すると、送信者は領収書を受け取り、受取人はギフトの詳細を記載したEメールを受け取ります。送信者は素性を隠し、匿名でギフトを送ることも可能です。

このオプションにはさまざまな統合オプションがあり、ゲームプロジェクトによって次のものを送れます:

  • 仮想通貨パッケージ
  • 仮想アイテム
  • ゲームキー

Note: このオプションは、エクソラ側のユーザーデータストレージが無効になっているプロジェクトでのみ使用できます。

使用に適した方

ストアを統合し、仮想アイテム仮想通貨/ゲームキー機能を有効にしているパートナー。

使用するには

機能の有効化:

  1. 仮想通貨パッケージ仮想アイテムおよび/またはゲームキーパッケージの設定します。
  2. 友達を作るAPIメソッドを実装して、友達オブジェクトをトークンのリクエストに追加します。
  3. ギフト・データを含む成功した支払いウェブフックの処理を実装します。
  4. アカウントマネージャーに連絡して、機能を有効化します。

トークン経由で友達一覧を送信する

必要に応じて、ユーザーの友達の配列をリクエストに追加できます。配列に要素が1つしか含まれていない場合、その友達は自動的にギフト受取人とみなされます。トークンのリクエストで最大100人の友達を送信することができます。また、リクエストにギフト・データを含めることもできます。

例をリクエスト

"purchase":{
   "virtual_currency":{
       "quantity":100
   },
   "description":{
       "value":"Test Purchase"
   },
   "gift":{
       "giver_id":"John Smith",
       "message":"GG WP",
       "hide_giver_from_receiver" : true,
       "friends": [
       {
        "id": "123",
        "name": "captain",
        "email": "captain@ship.com"
       }]
   }
}

APIリクエスト経由で友達一覧を送信する

エクソラは、プロジェクト用に設定されたウェブフックURLに友達一覧のリクエストを送信します。

署名の作成

電子署名の作成:

  1. エクソラから受け取ったパラメータをアルファベット順に並べ替えます。
  2. パラメータ値と秘密鍵(プロジェクト設定ページで生成)を1つの文字列に連結します。
  3. SHA1 アルゴリズムを使用してストリングをハッシュ化。
  4. 署名パラメータに署名を送信します。

Note: APIリクエストを処理するときは、受信した署名が署名パラメータで送信されたものと同じであることを確認してください。

友達一覧表の取得

例をリクエスト

$ curl -v 'https://your.webhook.url?notification_type=friends_list&user=user_id&query=frien&offset=10&limit=20&sign=12dfg3f5gdsf4g5s6dfg2sdg1' \
-X GET \
-u merchant_id:merchant_api_key

レスポンスの例

[
  {
  "friends": [
      {
        "id": "1",
        "name": "John Carter",
        "email": "carter@xsolla.com",
        "image_url": "https://partner/link/doctor.jpg"
      },
      {
        "id": "2",
        "name": "John Smith",
        "email": "smith@xsolla.com",
        "image_url": "https://partner/link/cook.jpg"
      }
    ],
  "total": 10
  }
]