SDK для Cocos Creator / Основная информация
  На главную

SDK для Cocos Creator

Основная информация

Платежный интерфейс реализован на основе продукта Pay Station. Выбор доступных способов оплаты и другие настройки выполняются в Личном кабинете в разделе Pay Station.

SDK поддерживает покупку товаров из каталога в один клик или через корзину.

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

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

Инструкции

Узнайте о дополнительных настройках из наших инструкций.

Как настроить перенаправление пользователя в приложение после оплаты

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

  • автоматический — перенаправление через заданный промежуток времени;
  • ручной — перенаправление пользователя после закрытия окна платежного интерфейса или нажатия кнопки редиректа.

Вы можете задать параметры редиректов:

  • в Личном кабинете — используйте этот вариант, если вы настраиваете проект для одного приложения и не планируете создавать сборки под разные платформы;

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

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

  1. Откройте проект в Личном кабинете.
  2. В боковом меню выберите пункт Pay Station.
  3. Перейдите в раздел Настройки > Политика редиректа.
  1. В поле Return URL введите URL-адрес страницы или путь в приложении, куда будет перенаправлен пользователь.
Примечание
Приложение URL-адрес должен соответствовать одной из схем:

  1. Чтобы задать параметры автоматического редиректа:
    1. Выберите значение в поле Условия для автоматического редиректа:
      • Нет — редирект не выполняется;
      • Успешный платеж — редирект при успешном платеже;
      • Успешный или отмененный платеж — редирект при успешном или отмененном платеже;
      • Любой платеж — редирект при любых статусах платежа.
    2. В поле Задержка введите количество секунд, через которое должен выполняться редирект. По умолчанию автоматический редирект осуществляется с задержкой 0 секунд.

  1. Чтобы задать параметры ручного редиректа:
    1. Выберите значение в поле Условия для ручного редиректа:
      • Нет — редирект не выполняется;
      • Успешный платеж — кнопка редиректа появляется при успешном платеже;
      • Успешный или отмененный платеж — кнопка редиректа появляется при успешном или отмененном платеже;
      • Любой платеж — кнопка редиректа появляется при любых статусах платежа.
    2. В поле Надпись на кнопке редиректа введите текст кнопки редиректа, при нажатии на которую пользователь перенаправляется на return URL.
Внимание

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

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

Когда пользователь закрывает платежный интерфейс, он переходит на указанный return URL.

  1. Нажмите Сохранить.

Настройка редиректов в SDK

Передайте настройки редиректа в метод init. Для этого добавьте в исходный код проекта в Cocos Creator строки в соответствии с примером для сборки под Android ниже. Задайте настройки редиректов:

  1. В параметре useSettingsFromPublisherAccount передайте false.
  2. В параметре returnUrl передайте URL-адрес страницы или путь в приложении, куда будет перенаправлен пользователь.
Примечание
Приложение URL-адрес должен соответствовать одной из схем:

  1. Чтобы задать параметры автоматического редиректа:
    1. В параметре redirectConditionпередайте условия редиректа:
      • PaymentRedirectCondition.none — редирект не выполняется;
      • PaymentRedirectCondition.successful — редирект при успешном платеже;
      • PaymentRedirectCondition.successful_or_canceled — редирект при успешном или отмененном платеже;
      • PaymentRedirectCondition.any — редирект при любых статусах платежа.
    2. В параметре redirectDelay передайте количество секунд, через которое должен выполняться редирект.

  1. Чтобы задать параметры ручного редиректа:
    1. В параметре redirectStatusManual передайте статус платежа, при котором появляется кнопка для возврата на return URL:
      • PaymentRedirectCondition.none — редирект не выполняется;
      • PaymentRedirectCondition.successful — редирект при успешном платеже;
      • PaymentRedirectCondition.successful_or_canceled — редирект при успешном или отмененном платеже;
      • PaymentRedirectCondition.any — редирект при любых статусах платежа.
    2. В параметре redirectButtonCaption передайте текст кнопки, при нажатии на которую пользователь перенаправляется на return URL.
Внимание

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

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

Когда пользователь закрывает платежный интерфейс, он переходит на указанный return URL.

Пример настройки редиректов для сборки под Android:

Copy
Full screen
Small screen
let redirectPolicySettingsAndroid: RedirectPolicySettings = {
                useSettingsFromPublisherAccount: false,
                returnUrl: 'app://xpayment.com.example.myapp',
                redirectCondition: PaymentRedirectCondition.successful,
                redirectDelay: 0,
                redirectStatusManual: PaymentRedirectStatusManual.successful,
                redirectButtonCaption: 'Back to the game'
        };
var settings: XsollaSettings = {
            loginId: '<yourLoginId>',
            projectId: '<yourProjectId>',
            clientId: '<yourClientId>',
            enableSandbox: IsSandbox,
            redirectPolicySettingsAndroid: redirectPolicySettingsAndroid
        }

        Xsolla.init(settings);
Примечание
Вы можете задать разные параметры редиректов для разных платформ сборки вашего приложения. Для этого используйте параметры:
  • redirectPolicySettingsAndroid;
  • redirectPolicySettingsIOS;
  • redirectPolicySettingsWebGL.
Была ли статья полезна?
Спасибо!
Что может сделать страницу еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
Скрыть

Продолжить чтение

Последнее обновление: 6 марта 2024

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

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