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

SDK для Cocos Creator

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

  • Демопроект

  • Аутентификация

  • Каталог

  • Акции

  • Подписки

  • Покупка товара

  • Инвентарь игрока

  • Личный кабинет и атрибуты пользователя


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

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

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

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

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

    Инструкции

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

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

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

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

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

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

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

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

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

    1. Откройте ваш проект в Личном кабинете.
    2. В боковом меню выберите пункт Pay Station.
    3. Перейдите в раздел Настройки > Политика редиректа.

    1. В поле Return URL введите URL-адрес страницы или путь в приложении, куда будет перенаправлен пользователь.

    Примечание
    Приложение URL-адрес должен соответствовать одной из схем:

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

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

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

    Последнее обновление: 16 мая 2023

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

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