Подарок другу

Как это работает

Вы можете предоставить пользователям возможность покупать за реальную валюту пакеты виртуальной валюты, виртуальные предметы или ключи доступа в качестве подарка друзьям в игре. После успешной оплаты покупатель получает чек, получатель - письмо с информацией о подарке. Покупатель подарка также может скрыть свои данные и отправить подарок анонимно.

Опция имеет несколько вариантов интеграции и предлагает игровым проектам следующие варианты покупки подарка:

  • Покупка пакета виртуальной валюты
  • Покупка виртуальных предметов
  • Покупка ключа активации игры

Note: Опция доступна только для проектов, у которых отключено хранение данных пользователей на стороне Иксоллы.

Для кого подходит

Для партнеров, у которых подключен продукт Buy Button и модуль Виртуальные предметы, Виртуальная валюта или Игровые ключи.

Как настроить

Для подключения опции необходимо:

  1. Настроить пакеты виртуальной валюты, виртуальные предметы и/или пакеты игровых ключей.
  2. Реализовать метод API для передачи списка друзей в Иксоллу или добавить объект с данными о друзьях в запрос на получение токена.
  3. Реализовать обработку оповещения об успешной оплате с добавленными данными о подарке.
  4. Связаться с аккаунт-менеджером проекта для включения опции.

Передача списка друзей в токене

При необходимости в запрос можно добавить массив со списком друзей пользователя. Если массив содержит всего один элемент, переданный друг автоматически определяется как получатель подарка. В запросе на получение токена можно передавать не более 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

Иксолла отправляет проекту запрос на получение списка друзей по адресу, указанному в качестве webhook URL в настройках проекта.

Формирование подписи

Процесс формирования подписи включает следующие шаги:

  1. Параметры, переданные в запросе от сервера Иксоллы, сортируются в алфавитном порядке.
  2. Значения параметров и секретный ключ проекта (генерируется на странице настройки проекта) конкатенируются в строку.
  3. Полученная строка хешируется с помощью SHA1 хеш-алгоритма.
  4. Подпись передается в параметре sign.

Note: При обработке запроса к API необходимо проверить, что полученная подпись и подпись, переданная в параметре sign, совпадают.

Получение списка друзей

Пример запроса

$ 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
  }
]