Платежные системы Unity IAP 5: Альтернатива платежам в App Store и Google Play.

В Unity In-App Purchasing (IAP) версии 5.4 и новее поддерживаются сторонние платежные системы Stripe и Coda Payments в качестве альтернативы традиционным платежам в магазинах приложений. В Unity функция прямых платежей потребителю (D2C) позволяет разработчикам обходить традиционные системы оплаты в магазинах приложений, перенаправляя игроков через веб-формы оформления заказа.

Интеграция управляется через панель управления Unity Gaming Services (UGS): разработчики подключают учетную запись поставщика через OAuth, развертывают облачный каталог продуктов или создают его на облачной панели управления и направляют игроков через веб-интерфейс оформления заказа, который возвращает в игру посредством глубоких ссылок, где можно отобразить сообщение об успешной или неудачной покупке.

Что нужно знать о платежных системах в Unity IAP 5

• В Unity In-App Purchasing 5.4 и более новых версиях доступны сторонние платежные системы Stripe и Coda Payments.
• Платежные системы подключаются в панели управления UGS в разделе LiveOps > In-App Purchases > Payment Providers с использованием авторизации OAuth с учетной записью песочницы или реального поставщика услуг.
• Оформление заказа происходит на внешней веб-странице, поэтому для доставки приобретенных товаров на правильный аккаунт необходимо подтвердить личность игрока с помощью пакета Authentication Unity (учетные записи игроков Unity или анонимный вход).
• Управление каталогами товаров возможно локально в редакторе Unity или их удаленное развертывание на панели управления UGS (LiveOps > In-App Purchases > Catalog). Удалённое развертывание позволяет отделам продаж и маркетинга изменять цены и проводить рекламные акции без обновления клиентского приложения.
• После оформления заказа в качестве URL-адресов перенаправления следует использовать прямые ссылки (например, mygame://checkout-success), а не стандартные веб-адреса, чтобы мобильная OS автоматически закрывала браузер и возвращала фокус на игру.
• В панели управления платежными системами UGS правила маршрутизации позволяют направлять транзакции различным поставщикам в зависимости от платформы или страны.
• Вы можете настроить тестирование в песочнице в разделе «Настройки проекта» > «Среды», создать среду разработки, а затем подключиться через OAuth к учетной записи песочницы Stripe или Coda, где вы сможете протестировать процесс с использованием фиктивных номеров кредитных карт, без участия реальных денег.
• Вы можете начать работу с минималистичным примером кода для внутриигровых покупок (IAP 5 Sample ), импортированным со вкладки «Примеры» пакета «Внутриигровые покупки» в менеджере пакетов.

Как интегрировать платежный провайдер с Unity IAP 5

Интеграция состоит из семи этапов:

Настройте учетные записи. Свяжите проект Unity с организацией Unity и идентификатором проекта через окно «Сервисы» и создайте учетные записи разработчиков в Stripe и/или Coda Payments (начните работу в их тестовых средах).

Подготовьте проект. Установите или обновите функцию внутриигровых покупок (версия 5.4+) в Менеджере пакетов и импортируйте пример кода IAP 5. Установите пакет Authentication и добавьте поставщика идентификации (учетные записи игроков Unity или анонимный вход) в разделе «Управление доступом» > «Authentication игроков» на панели управления UGS .

Разверните каталог продукции. Настройте элементы каталога (тип продукта — расходный материал, нерасходный материал или подписка — и базовую цену) в редакторе, а затем загрузите их в облако через раздел «Сервисы» > «Развертывание». Проверьте артикулы товаров в разделе LiveOps > Встроенные покупки > Каталог или создайте каталог непосредственно на той же панели управления: LiveOps > Встроенные покупки > Каталог.

Раздельные среды. Создайте среду разработки в разделе «Настройки проекта» > «Службы» > «Среды», выберите её в редакторе и сопоставьте строку среды со скриптом IAPService из примера (const string k_Environment = "development";). Соедините среду разработки с учетной записью поставщика песочницы, а производственную среду — с рабочей учетной записью.

Подключите провайдера. В панели управления UGS откройте LiveOps > Встроенные покупки > Платежные провайдеры, нажмите «Подключиться к Stripe или Coda», выберите «Учетная запись песочницы» и авторизуйте связь через диалоговое окно OAuth провайдера.

Настройка перенаправлений с использованием глубоких ссылок. В настройках оплаты укажите пользовательскую схему URL адресов для успешных платежей, чтобы игроки возвращались в игру после оплаты, и товар автоматически обрабатывался. Пользовательские схемы объявляются в соответствии с документацией Unity по глубоким ссылкам.

Протестируйте и проверьте. Запустите сцену Coded Sample в редакторе, инициируйте покупку, завершите оформление заказа в тестовой системе Stripe с помощью фиктивной карты и подтвердите возврат по прямой ссылке баннером подтверждения заказа. Проверьте транзакции на панели управления поставщика (тестовый режим) и в UGS в разделе LiveOps > In-App Purchases > Logs, обращая внимание на сообщения «Order Creator Success», за которыми следует «Order Status Update» (Успешно выполнено).

Процесс покупки IAP в Unity 5

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

Скачать PDF-файл высокого разрешения можно здесь.

Распространенные ошибки при добавлении платежных провайдеров

• Игроки, оказавшиеся в затруднительном положении после оформления заказа: использование обычной веб-страницы в качестве URL подтверждения оплаты приводит к тому, что игрок после оплаты оказывается во внешнем браузере и вынужден вручную переключаться обратно в игру, если, например, он использовал настольный браузер. Всегда используйте прямые ссылки, чтобы OS автоматически возвращала их в приложение или обрабатывала подтвержденные покупки при загрузке товаров (FetchProducts) при инициализации игры, как показано на инфографике.
• Неправильная среда: разработка в производственной среде чревата нарушением работы основных функций. Используйте выделенную среду разработки с учетной записью поставщика песочницы и убедитесь, что строка среды в коде соответствует выбору в редакторе.
• Отсутствие идентификации игрока: поскольку оплата происходит вне приложения, сбой Authentication Unity означает, что покупки не могут быть надежно сопоставлены с правильной учетной записью игрока.
• Стандартные страницы оформления заказа: небрендированный платежный портал нарушает визуальную целостность. Панели управления провайдеров (например, Stripe в разделе «Бизнес» > «Брендинг») поддерживают пользовательские шестнадцатеричные коды цветов, типографику и логотипы студий, соответствующие пользовательскому интерфейсу игры.

Узнайте больше о настройке платежных систем для Unity IAP 5 →