仕組み
友達へのギフト機能は、ユーザーが仮想通貨、仮想アイテム、またはゲームアクセスキーを実際の通貨で購入し、ゲーム内の友達にギフトとして送ることを可能にします。支払いが成功すると、送信者は領収書を受け取り、受取人はギフトの詳細を記載したEメールを受け取ります。送信者は素性を隠し、匿名でギフトを送ることも可能です。
このオプションにはさまざまな統合オプションがあり、ゲームプロジェクトによって次のものを送れます:
- 仮想通貨パッケージ
- 仮想アイテム
- ゲームキー
Note:
このオプションは、エクソラ側のユーザーデータストレージが無効になっているプロジェクトでのみ使用できます。
使用に適した方
ストアを統合し、仮想アイテムと仮想通貨/ゲームキー機能を有効にしているパートナー。
使用するには
機能の有効化:
- 仮想通貨パッケージ、仮想アイテムおよび/またはゲームキーパッケージの設定します。
- 友達を作るAPIメソッドを実装して、友達オブジェクトをトークンのリクエストに追加します。
- ギフト・データを含む成功した支払いウェブフックの処理を実装します。
- アカウントマネージャーに連絡して、機能を有効化します。
トークン経由で友達一覧を送信する
必要に応じて、ユーザーの友達の配列をリクエストに追加できます。配列に要素が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つの文字列に連結します。
- SHA1 アルゴリズムを使用してストリングをハッシュ化。
- 署名パラメータに署名を送信します。
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
}
]