Конструктор сайтов / Как создать сайт с возможностью прямого пополнения
 На главную

Конструктор сайтов

  • Руководство по интеграции

  • Инструкции

  • Расширения

  • Справочники

  • Как создать сайт с возможностью прямого пополнения

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

    Прямое пополнение — это решение, которое упрощает продажу внутриигровых товаров на сайте вашей игры. Пользователь может совершать покупки после авторизации на сайте, которая выполняется с помощью ID пользователя игры. Дополнительная проверка пользователя с помощью стандартных методов Авторизации (через email и пароль, номер телефона или социальную сеть) не требуется. Решение позволяет исключить комиссию мобильных платформ за проведение транзакций внутри игры.

    Если вы хотите полностью исключить продажу товаров внутри игры, вместо создания внутриигрового магазина разместите в игре ссылку на сайт, на котором реализована возможность прямого пополнения, и дополнительно продвигайте его с помощью рекламы в различных сервисах.

    Чтобы использовать возможность прямого пополнения, необходимо быть участником Партнерской сети.

    Сценарий пользователя

    1. Пользователь переходит на сайт, на котором реализована возможность прямого пополнения.
    2. Пользователь вводит свой ID из игры в специальном поле. Если включена валидация пользователя после ввода ID, Иксолла отправляет вебхук для проверки существования пользователя. Если введенный ID существует в игре, пользователь может продолжить прямое пополнение. В противном случае пользователь получает сообщение об ошибке.
    3. Пользователь выбирает товары и переходит к этапу оплаты.
    4. Пользователь выбирает способ оплаты. Если валидация пользователя после ввода ID не включена, Иксолла отправляет вебхук для проверки существования пользователя после выбора способа оплаты. Если введенный ID существует в игре, пользователь может продолжить оплату. В противном случае пользователь получает сообщение об ошибке.
    5. Пользователь оплачивает товары. Если оплата прошла успешно, Иксолла отправляет вебхук об успешном платеже.
    6. Пользователь видит купленные товары в своем аккаунте в игре.

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

    1. В Личном кабинете перейдите в Конструктор сайтов и нажмите Создать сайт.

    1. Выберите шаблон Прямое пополнение.

    По умолчанию в конструкторе для этого шаблона добавлены блоки Хедер, Прямое пополнение, Магазин и Футер.

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

    1. При необходимости вы можете добавить дополнительные блоки с помощью соответствующей кнопки в конструкторе.

    1. В боковом меню отредактируйте содержимое каждого добавленного блока, выберите тему сайта и задайте настройки механизмов SEO и локализации. В основной части конструктора вы можете загрузить в блоки изображения и видео, а также отредактировать тексты, которые будут видны пользователям.

    1. Чтобы добавлять товары в аккаунт конкретного пользователя в игре, перейдите в Личный кабинет > Настройки проекта > Оповещения и настройте вебхук для проверки существования пользователя и вебхук об успешном платеже.

    1. На своей стороне реализуйте валидацию пользователя.

    1. Нажмите Опубликовать.

    Notice
    Если публикация сайта недоступна, убедитесь, что соблюдаются все необходимые условия:
    • Отсутствуют незаполненные разделы на сайте (отмечены красным кругом).
    • Подписан Лицензионный договор с Иксоллой.
    • На сайт добавлен раздел с авторизацией пользователей (если на сайте добавлен блок Магазин).

    1. Внесите изменения в домен (опционально). Для этого перейдите в Конструктор сайтов и нажмите Настроить в карточке вашего сайта. В разделе Домен внесите изменения в Доменное имя Иксоллы или подключите собственный домен.

    1. Настройте автоматическое добавление купленных товаров в аккаунт пользователя в игре. Необходимо делать это каждый раз после получения оповещения об успешной оплате.

    1. Присоединитесь к программе Партнерской сети. Партнерская сеть будет отслеживать активности по трекинговым ссылкам и автоматически начислять инфлюенсерам долю прибыли за увеличение продаж.

    Валидация пользователя

    По умолчанию валидация пользователя включена после выбора способа оплаты, но вы также можете ее настроить на этапе ввода ID:

    1. В Личном кабинете перейдите в Конструктор сайтов > ваш сайт > Прямое пополнение.
    2. В блоке Ввод ID пользователя установите переключатель Проверка ID в положение Вкл и укажите URL-адрес вебхука для проверки существования пользователя.

    Notice
    URL-адрес вебхука должен начинаться с https://. При использовании протокола http:// браузер будет выдавать ошибку.

    Чтобы выполнить валидацию пользователя:

    1. Выполните поиск пользователя по полученному в вебхуке идентификатору.
    2. В зависимости от результата отправьте один из кодов статуса:
      • 200 (с дополнительной информацией) или 204 (без дополнительной информации) — если пользователь найден.
      • 455 — если пользователя с таким ID не зарегистрирован в игре.

    Copy
    Full screen
    Small screen
      "http_status_code": 200
      {
        "status": "success"
        "user": {
          "id": 1234567,
          "name": "Xsolla User",    
          "level": "80",
        }
      }

      Описание параметров для статуса 200:

      ПараметрОписание
      user.idID пользователя. Обязательный.
      user.nameИмя пользователя. Если передан, отображается вместо user.id.
      user.levelУровень пользователя.

      При успешной валидации пользователь сможет продолжить прямое пополнение, при неуспешной — получит сообщение об ошибке.

      Была ли статья полезна?
      Спасибо!
      Что может сделать страницу еще лучше? Сообщение
      Жаль, что так произошло
      Расскажите, почему статья не была полезна. Сообщение
      Спасибо за обратную связь!
      Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
      Оценить страницу
      Оценить страницу
      Что может сделать страницу еще лучше?

      В другой раз

      Спасибо за обратную связь!
      Последнее обновление: 15 сентября 2021

      Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.

      Сообщите о проблеме
      Мы постоянно улучшаем качество нашей документации. Ваш отзыв поможет нам в этом.
      Укажите email-адрес, чтобы мы могли связаться с вами
      Спасибо за обратную связь!