Как открыть внешний браузер из лаунчера

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

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

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

Совершение покупки

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

  1. Для совершения покупки пользователь открывает приложение WebView и нажимает Купить.
  2. В приложении WebView открывается платежный интерфейс, в котором пользователь выбирает способ оплаты.

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

В приложении WebView появляется описание шагов, которые необходимо выполнить в открывшемся окне внешнего браузера.

  1. Пользователь вводит данные и подтверждает покупку во вкладке внешнего браузера. В случае успеха появляется уведомление об успешной покупке.
  2. Пользователь возвращается в приложение WebView, в котором также отображается уведомление об успешной покупке и кнопка для возвращения в игру.
  3. Пользователь закрывает приложение WebView в лаунчере и возвращается в игру.
Примечание
Кнопка для возвращения в игру отображается только в приложении WebView в лаунчере. Во внешнем браузере появляется только уведомление об успешной покупке. Для изменения настроек редиректа воспользуйтесь инструкцией.

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

Чтобы реализовать переход из лаунчера во внешний браузер для совершения покупки, передайте в токене параметр settings.ui.is_independent_windows: true.
Пример тела запроса на получение токена
Copy
Full screen
Small screen
     1{
     2    "user": {
     3        "id": {
     4            "value": "158804750"
     5        },
     6        "email": {
     7            "value": "email@example.com"
     8        },
     9        "country": {
    10            "value": "US"
    11        }
    12    },
    13    "settings": {
    14        "mode": "sandbox",
    15        "project_id": 53737,
    16        "language": "en",
    17        "currency": "USD",
    18        "ui": {
    19            "is_independent_windows": true,
    20            "user_account": {
    21                "payment_accounts": {
    22                    "order": 1,
    23                    "enable": false
    24                },
    25                "history": {
    26                    "order": 2,
    27                    "enable": true
    28                }
    29            }
    30        }
    31    },
    32    "purchase": {
    33        "description": {
    34            "value": "Test purchase",
    35            "items": [
    36                {
    37                    "name": "Test purchase",
    38                    "quantity": 1,
    39                    "price": {
    40                        "amount": "19.99"
    41                    },
    42                    "image_url": "\/\/images.ctfassets.net\/wn7ipiv9ue5v\/2E36gdKHDOIRmxX6H1y2h2\/6941cea2e876c0466e79a16eccab0351\/greatWhiteCard.jpg"
    43                }
    44            ]
    45        },
    46        "checkout": {
    47            "currency": "USD",
    48            "amount": 19.99
    49        }
    50    }
    51}
    

    Сохранение платежного метода

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

    1. На стороне вашего приложения пользователь переходит на страницу управления своими сохраненными платежными методами.

    1. Пользователь нажимает Добавить платежный метод.
    2. В открывшемся платежном интерфейсе пользователь выбирает метод оплаты.

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

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

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

    Метод автоматически добавится в список сохраненных платежных методов аккаунта пользователя в вашем приложении.

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

    Чтобы реализовать переход в браузер по умолчанию для сохранения платежного метода, передайте в токене параметры settings.ui.mode: user и settings.ui.is_independent_windows: true.
    Примечание
    Чтобы обрабатывать сохраненные платежные методы и инициировать списание, используйте токенизацию.
    Пример тела запроса на получение токена
    Copy
    Full screen
    Small screen
       1{
       2    "user": {
       3        "id": {
       4            "value": "test",
       5            "hidden": true
       6        },
       7        "email": {
       8            "value": "email@example.com"
       9        },
      10        "country": {
      11            "value": "US",
      12            "allow_modify": true
      13        }
      14    },
      15    "settings": {
      16        "project_id": 136187,
      17        "language": "en",
      18        "currency": "USD",
      19        "ui": {
      20        "mode": "user_account",
      21            "is_independent_windows": true
      22        }
      23    }
      24}
      
      Была ли статья полезна?
      Спасибо!
      Что может сделать страницу еще лучше? Сообщение
      Жаль, что так произошло
      Расскажите, почему статья не была полезна. Сообщение
      Спасибо за обратную связь!
      Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
      Последнее обновление: 9 июля 2025

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

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