Кастомизация платежного интерфейса

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

По умолчанию для платежного интерфейса доступны две темы — светлая и темная. Для переключения между ними без использования кастомизатора передайте ID темы в параметре settings.ui.theme при получении токена:

  • для светлой темы (по умолчанию) — 6a54b1b3c01b9c25e567a065;
  • для темной темы — 6a54b174c01b9c25e5679fa2.

Чтобы платежный интерфейс соответствовал дизайну игры, вы можете создать собственную тему и настроить в ней следующие характеристики:

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

Внимание
Настройки темы, переданные в токене, имеют приоритет над настройками в Личном кабинете.

Чтобы платежный интерфейс соответствовал дизайну игры, вы можете создать собственную тему и настроить в ней следующие параметры:

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

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

Настройка кастомизации в Личном кабинете

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

Чтобы создать кастомизированную тему:

  1. Откройте проект в Личном кабинете и перейдите в раздел Платежи > Платежный интерфейс > Кастомизация Pay Station.

Настройка кастомизации в аккаунте

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

Чтобы создать кастомизированную тему:

  1. Откройте проект в аккаунте и перейдите в раздел Платежи > Платежный интерфейс > Кастомизация Pay Station.

Настройка кастомизации в аккаунте

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

Чтобы создать кастомизированную тему:

  1. Откройте проект в аккаунте и перейдите в раздел Платежи > Платежный интерфейс > Кастомизация Pay Station.

Настройка кастомизации в аккаунте

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

Чтобы создать кастомизированную тему:

  1. Откройте проект в аккаунте и перейдите в раздел Платежи > Платежный интерфейс > Кастомизация Pay Station.

Настройка кастомизации в аккаунте

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

Чтобы создать кастомизированную тему:

  1. Откройте проект в аккаунте и перейдите в раздел Платежи > Платежный интерфейс > Кастомизация Pay Station.
  1. Нажмите Создать тему.
  1. Нажмите значок карандаша, чтобы изменить название темы.
  1. В раскрывающемся списке Пресет вы можете выбрать базовую тему. Если вы внесли изменения и не опубликовали тему, при переключении пресета они не сохранятся.
  1. Чтобы настроить цвета элементов интерфейса, перейдите на вкладку Цвета. Вы можете изменить цветовую палитру для фона, текста и элементов управления, а также цвета оповещений.
Примечание

Когда вы изменяете цвета темы, происходит автоматическая проверка контрастности, и при нарушении баланса появляется предупреждение с кнопкой Проверить. Нажмите ее, чтобы перейти в раздел Компоненты, в котором отображаются все элементы интерфейса. Изучите их внешний вид и измените цвета у элементов с нарушенным балансом.

  1. Чтобы настроить шрифт и его размер, перейдите на вкладку Типографика.

Используя соответствующие поля в кастомизаторе, вы можете изменить шрифт у следующих элементов интерфейса:

ПолеЭлемент интерфейса
Title 1Заголовок на странице статуса платежа.
Title 2Значение итоговой суммы.
Title 3Заголовки разделов (например, Оплата по карте).
Основной текст L
  • Заголовки подразделов;
  • заголовки в инструкциях по оплате наличными;
  • текст кнопок;
  • надпись К оплате.
Основной текст M
  • Название проекта (отображается, если отсутствует логотип проекта);
  • текст в тултипах и описаниях;
  • текст сообщения на странице статуса платежа;
  • текст в списке способов оплаты (для мобильной версии — раскрывающийся список).
Мелкий текст
  • Имя пользователя;
  • юридические тексты;
  • информация в корзине (например, наименование товара, сумма НДС).
  1. Чтобы настроить толщину границ и радиус скругления элементов интерфейса, перейдите на вкладку Границы и внесите изменения.

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

  1. Чтобы посмотреть, как тема будет выглядеть в мобильной и настольной версиях платежного интерфейса, переключайте вкладки в разделе Превью.
Внимание
В режиме предпросмотра кнопки и ссылки не работают.
  1. Чтобы посмотреть разные состояния платежного интерфейса, переключайте вкладки Оплата картой, Способы оплаты, Статус платежа: успех, Статус платежа: ошибка.
  1. Чтобы изменить изображение на странице со статусом платежа, на вкладке Статус платежа: успех или Статус платежа: ошибка нажмите Загрузить и выберите необходимый файл на вашем устройстве.
Примечание

Максимальный размер файла: 5 МБ.

Поддерживаемые форматы: JPG/JPEG, PNG, GIF, APNG.

Примечание

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

Пример:

  1. Нажмите Опубликовать.
  1. В открывшемся модальном окне активируйте переключатель Сделать темой по умолчанию, чтобы тема применилась во всех проектах вашего аккаунта в Личном кабинете, кроме тех, в которых тема передана в токене.
  1. В открывшемся модальном окне активируйте переключатель Сделать темой по умолчанию, чтобы тема применилась во всех проектах вашего аккаунта, кроме тех, в которых тема передана в токене.
  1. В открывшемся модальном окне активируйте переключатель Сделать темой по умолчанию, чтобы тема применилась во всех проектах вашего аккаунта, кроме тех, в которых тема передана в токене.
  1. В открывшемся модальном окне активируйте переключатель Сделать темой по умолчанию, чтобы тема применилась во всех проектах вашего аккаунта, кроме тех, в которых тема передана в токене.
  1. В открывшемся модальном окне активируйте переключатель Сделать темой по умолчанию, чтобы тема применилась во всех проектах вашего аккаунта, кроме тех, в которых тема передана в токене.
  1. Нажмите Опубликовать.
Внимание
После публикации темы вы в любое время сможете вернуться к ее редактированию. Тема не применится к платежному интерфейсу, пока вы не установите ее темой по умолчанию или не включите ее с помощью настроек токена.

На вкладке Тема UI при нажатии ••• в блоке конкретной темы вам доступны следующие быстрые действия:

  • Кастомизировать — открыть кастомизатор, чтобы внести изменения.
  • Редактировать — изменить название темы и активировать переключатель Использовать по умолчанию.
  • Дублировать — копировать тему, чтобы создать на ее основе другую собственную тему.
  • Удалить тему.

Настройка кастомизации через API

Отображение способов оплаты

Чтобы настроить отображение способов оплаты при открытии платежного интерфейса, вы можете передать в токене следующие параметры:

  • is_payment_methods_list_mode, который позволяет отображать при открытии платежного интерфейса способы оплаты, доступные в стране игрока.
  • settings.ui.gp_quick_payment_button, который определяет расположение способа оплаты с помощью Google Pay в платежном интерфейсе. Может принимать следующие значения:

    • true — в этом случае кнопка для быстрой оплаты с помощью Google Pay отображается в верхней части платежного интерфейса вне зависимости от устройства и браузера пользователя.
Примечание
Если параметр не передан, Google Pay отображается в верхней части платежного интерфейса на любых устройствах и браузерах пользователя, кроме Safari. В Safari он отображается в списке способов оплаты.
    • false — в этом случае Google Pay отображается в списке способов оплаты в соответствии с алгоритмом PayRank.
  • settings.​ui.​alternative_first_screen, который позволяет настроить альтернативный вид экрана платежного интерфейса при его открытии. Может принимать следующие значения:

    • apple-pay — в этом случае при открытии платежного интерфейса пользователь видит приоритетную кнопку оплаты с помощью Apple Pay и ссылку для перехода к списку других способов оплаты. На устройства Android эта логика не распространяется.
    • compact_list — в этом случае при открытии платежного интерфейса пользователь видит кнопку Все способы наряду с основными способами оплаты. При нажатии на кнопку пользователь видит список всех способов оплаты в виде плиток. Если пользователю доступно меньше 4 способов, кнопка не отображается.

Передача настроек собственной темы в токене

Чтобы кастомизированные настройки применились для конкретной игры, передайте ID опубликованной кастомизированной темы в параметре settings.ui.theme при создании токена.

Вы можете найти ID темы:

  • В списке всех тем на вкладке Тема UI.
  • В кастомизаторе под названием темы.
Внимание
Настройки темы, переданные в токене, имеют приоритет над настройками в Личном кабинете.
Внимание
Настройки темы, переданные в токене, имеют приоритет над настройками, указанными в аккаунте.

Чтобы отображать логотип вашей игры в платежном интерфейсе:

  1. Откройте проект в Личном кабинете и загрузите изображение в разделе Платежи > Платежный интерфейс > Общие настройки.

Чтобы отображать логотип вашей игры в платежном интерфейсе:

  1. Откройте проект в аккаунте и загрузите изображение в разделе Платежи > Платежный интерфейс > Общие настройки.

Чтобы отображать логотип вашей игры в платежном интерфейсе:

  1. Откройте проект в аккаунте и загрузите изображение в разделе Платежи > Платежный интерфейс > Общие настройки.

Чтобы отображать логотип вашей игры в платежном интерфейсе:

  1. Откройте проект в аккаунте и загрузите изображение в разделе Платежи > Платежный интерфейс > Общие настройки.

Чтобы отображать логотип вашей игры в платежном интерфейсе:

  1. Откройте проект в аккаунте и загрузите изображение в разделе Платежи > Платежный интерфейс > Общие настройки.
Примечание
Максимальный размер файла: 1 МБ.
Поддерживаемые форматы: JPEG, PNG, SVG.

  1. В запросе на получение токена передайте true в параметрах settings.ui.desktop.header.is_visible и settings.ui.desktop.header.visible_logo. В зависимости от сценария интеграции, вы можете использовать серверный или клиентский метод получения токена.

Пример отображения логотипа игры в платежном интерфейсе:

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

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

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