FAQ: всё о мини-приложениях Antarctic Wallet
Мини-приложения позволяют запускать сервисы прямо внутри Antarctic Wallet. Пользователю не нужно устанавливать отдельное приложение, переходить на другой сайт или создавать новый аккаунт.
Ниже собраны ответы на вопросы о подключении, разработке, платежах, безопасности и правилах платформы.
Общие вопросы
Что такое мини-приложение в Antarctic Wallet?
Это веб-сервис, который открывается прямо внутри кошелька: в iframe в веб-версии и в WebView в мобильном приложении. Пользователь остаётся в Antarctic Wallet, а разработчику не нужно создавать отдельное нативное приложение и публиковать его в сторах.
Чем мини-приложение отличается от обычного сайта?
Технически это тот же веб-интерфейс. Разница в том, что Antarctic Wallet берёт на себя авторизацию пользователя, отображение операций и их подтверждение. Разработчику не нужно самостоятельно создавать эти экраны.
Какие сценарии можно реализовать?
- авторизация и получение уникального идентификатора пользователя для личного кабинета, программы лояльности или доступа к контенту;
- приём платежей за товары и услуги, покупки или донаты;
- сочетание платежей и выплат пользователям, например для маркетплейса, бронирования, отмены заказа или кэшбэка.
Можно ли сделать мини-приложение без платежей?
Да. Платёжные функции подключаются только в том случае, если они нужны вашему сервису.
Зачем мини-приложение разработчику или бизнесу?
Antarctic Wallet даёт доступ к аудитории кошелька, авторизацию без отдельной регистрации и пароля, подтверждение операций внутри интерфейса кошелька, а также возможность принимать платежи и делать выплаты без создания собственного платёжного интерфейса.
Из каких частей состоит система?
В работе участвуют три стороны:
- Antarctic Wallet открывает мини-приложение и показывает пользователю подтверждение операций;
- сервер разработчика хранит секрет приложения, управляет сессиями и создаёт операции;
- мини-приложение отвечает за веб-интерфейс и взаимодействует с кошельком через SDK.
Запуск и публикация
Как пользователь попадает в мини-приложение?
Пользователь открывает раздел «Сервисы» → «Приложения» → «Добавить», вводит ссылку на приложение или сканирует QR-код, проверяет информацию о приложении и подтверждает добавление. Дальше приложение доступно из каталога кошелька.
Где отображается мини-приложение после публикации?
Сейчас его можно открыть по прямой ссылке или QR-коду. Общий каталог приложений ещё находится в разработке.
В Antarctic Wallet действует проверка после запуска (пост-модерация). Пользователь может пожаловаться на приложение, если обнаружит нарушение правил или противоправные действия.
По каким причинам приложение могут не пропустить или ограничить?
Если оно нарушает правила мини-приложений Antarctic Wallet.
Ориентировочно 1–2 рабочих дня, если интерфейс вашего приложения уже готов.
Что нужно, чтобы начать интеграцию?
Четыре шага: получите идентификатор (appId) и секрет приложения в кабинете, возьмите готовый стартер-шаблон, добавьте свои экраны в предусмотренный сценарий и разверните приложение одним Docker-образом.
Куда обращаться по вопросам подключения?
Обсудить интеграцию можно в чате для разработчиков.
Менеджер по подключению – @Milana_Antarctic.
Разработка и интеграция
Да. Для финансовых операций необходимо серверное взаимодействие между сервером разработчика и сервером Antarctic Wallet. Сервер приложения должен храниться только на стороне разработчика.
Можно ли использовать существующий сайт как мини-приложение?
Да. Для этого нужно подключить AW SDK и адаптировать сайт для работы внутри Antarctic Wallet.
Есть ли готовый пример или шаблон приложения?
Да. Готовый пример доступен в репозитории Antarctic Wallet.
SDK – npm-пакет без внешних зависимостей, который закрывает клиентскую часть интеграции: создание и обновление сессии, работу с разрешениями (scopes), запрос подтверждения операций и управление кнопкой «Назад» в интерфейсе кошелька. Работает в iframe и в React Native WebView.
Какие технологии поддерживаются?
Доступны готовые стартеры для Vue, React и Angular с одинаковым набором сценариев, а также референсный бэкенд на Node.js.
Что получает партнёр для разработки?
Не просто документацию, а рабочий репозиторий: три стартовых шаблона, референсный бэкенд, универсальный Dockerfile и документацию на русском и английском языках. Отдельно есть AGENTS.md – машиночитаемая спецификация для генерации мини-приложения с помощью Cursor или Claude Code.
Какие ограничения есть у WebView?
Ответ уточняется. Мини-приложение должно корректно работать внутри WebView мобильного приложения и iframe веб-версии; полный список технических ограничений будет опубликован дополнительно.
Есть ли ограничения на внешние ссылки и переходы?
Да. Ссылки, адрес которых не совпадает с адресом самого приложения (origin), открываются во внешнем браузере устройства.
На что обратить внимание перед запуском?
Мини-приложение должно работать по HTTPS и корректно отображаться внутри iframe и WebView, нужен публичный адрес для вебхуков, секрет приложения хранится только на сервере, подтверждение операций всегда показывает Antarctic Wallet, а статусы заказов разработчик хранит на своей стороне.
Авторизация и данные пользователя
Как устроена авторизация пользователя?
Antarctic Wallet выдаёт подписанный токен (idToken). Сервер разработчика проверяет его по ключам кошелька и получает уникальный идентификатор пользователя (sub) внутри конкретного приложения. Это не номер счёта, телефон или электронная почта. В разных мини-приложениях у одного пользователя будут разные идентификаторы.
Какие данные Antarctic Wallet передаёт при авторизации?
При авторизации приложение получает маскированный уникальный идентификатор пользователя.
Какие ещё данные могут быть доступны мини-приложению?
С разрешения пользователя приложение может получить доступ к балансу, факту прохождения KYC, типам подтверждённых документов и стране их выдачи. Сами документы и персональные данные не передаются.
Может ли мини-приложение получать баланс пользователя?
Да, если пользователь разрешит доступ к этим данным.
Можно ли запросить разрешение позже, а не при первом запуске?
Да. Приложение может запросить дополнительное разрешение (scope) в любой момент работы.
Нужно ли пользователю создавать отдельный аккаунт?
Нет. Пользователь авторизуется в мини-приложении через свой действующий профиль Antarctic Wallet.
Какие разрешения может запросить приложение?
Доступны три разрешения (scopes): запрос платежа (pay), просмотр баланса (balance) и получение данных пользователя (userData).
Может ли пользователь отозвать доступ приложения?
Да. Пользователь может отозвать авторизацию приложения для своего аккаунта.
Платежи и выплаты
Мини-приложение отправляет запрос своему серверу, сервер создаёт операцию через API Antarctic Wallet, а кошелёк показывает пользователю экран подтверждения. Интерфейс мини-приложения не может подтвердить операцию вместо пользователя.
Может ли мини-приложение инициировать платёж самостоятельно?
Оно может отправить запрос на оплату, но без подтверждения пользователя средства не спишутся.
Можно ли принимать оплату не только в долларах?
Сейчас операции доступны только с долларового счёта пользователя.
В какой валюте разработчик получает средства?
Куда поступают средства после оплаты?
На основной счёт разработчика приложения в Antarctic Wallet.
Какая комиссия взимается за платёж?
Комиссия за платёж составляет 0%.
Как мини-приложение узнаёт, что платёж завершён?
Финансовую операцию проводит Antarctic Wallet. Автоматические уведомления сервера (webhooks) пока не поддерживаются – технический способ получения итогового статуса нужно уточнять в документации по интеграции.
Что произойдёт, если пользователь закроет приложение во время оплаты?
Есть ли защита от двойной оплаты?
Да. Для операции используется уникальный reference_id, который не позволяет повторно создать операцию с тем же идентификатором.
Есть ли уведомления сервера о статусе платежа?
Сейчас автоматические уведомления сервера (webhooks) о платежах не поддерживаются.
Как обрабатываются отменённые и неуспешные платежи?
Мини-приложение может повторно запросить подтверждение операции или создать новую операцию. Эту логику реализует разработчик на своей стороне.
Можно ли делать возвраты пользователю?
Приложение может отправить средства пользователю без дополнительных действий с его стороны.
Можно ли делать выплаты пользователям?
Да, приложение может отправлять средства пользователям, которые ранее открывали его и проходили авторизацию.
Поддерживаются ли подписки и регулярные платежи?
Безопасность
Может ли мини-приложение получить доступ к кошельку или приватным ключам пользователя?
Нет. Приватные ключи и управление кошельком приложению не передаются.
Какие действия всегда требуют подтверждения пользователя?
Оплата и предоставление доступа к информации о пользователе.
Какие требования Antarctic Wallet предъявляет к безопасности мини-приложений?
Ответ уточняется. Из уже известного: приложение должно работать по HTTPS, а секрет приложения – храниться только на сервере разработчика (см. «На что обратить внимание перед запуском?»). Полный перечень требований будет опубликован в правилах платформы.
Кто отвечает за хранение пользовательских данных?
Antarctic Wallet не передаёт мини-приложениям персональные данные и документы пользователей.
Правила платформы
Приложения, нарушающие правила Antarctic Wallet или законодательство стран распространения. Перед публикацией сюда необходимо добавить ссылку на актуальные правила платформы.
Можно ли делать VPN-приложения?
Да, если они соответствуют законодательству стран распространения и правилам Antarctic Wallet.
Да, если они соответствуют законодательству стран распространения и правилам Antarctic Wallet.
Можно ли делать приложения с финансовыми механиками?
Да, если они соответствуют законодательству стран распространения и правилам Antarctic Wallet.
Можно ли использовать криптовалюты или токены внутри мини-приложения?
Да, если это соответствует законодательству стран распространения и правилам Antarctic Wallet.
Можно ли создавать приложения с азартными играми, ставками или лотереями?
Только если такие механики соответствуют законодательству стран распространения и правилам Antarctic Wallet.
Можно ли продавать цифровые товары и услуги?
Да, если это соответствует законодательству стран распространения и правилам Antarctic Wallet.
Можно ли продавать физические товары?
Да, если продажа соответствует законодательству стран, в которых распространяется приложение и реализуются товары, а также правилам Antarctic Wallet.
Работа после запуска
Что произойдёт, если мини-приложение перестанет отвечать?
Пользователи смогут сообщить о недоступности приложения в Antarctic Wallet.
Можно ли обновлять приложение без повторной модерации?
Да. В Antarctic Wallet действует проверка после запуска (пост-модерация), поэтому отдельное предварительное согласование каждого обновления не требуется.
Есть ли аналитика по запускам и платежам?
Аналитика находится в разработке.
Как сообщить о проблеме с SDK или платформой?
Обратитесь в поддержку Antarctic Wallet или задайте вопрос в чате для разработчиков.
Бизнес и юридические вопросы
Берёт ли Antarctic Wallet комиссию с разработчика?
Комиссия за отдельный платёж сейчас составляет 0%.
Нужно ли оформлять ИП или юридическое лицо для публикации?
Можно ли опубликовать приложение физическому лицу?
Кто является продавцом товара или услуги?
Кто отвечает перед пользователем за товар или услугу?
Какие данные по платежам получает разработчик?
Сумму операции, обезличенный идентификатор пользователя, дату и время операции.
Как устроена юридическая сторона приёма платежей и уплаты налогов?
Antarctic Wallet не является стороной расчётов между пользователем и разработчиком, не выплачивает разработчику доход, не выступает налоговым агентом и не удерживает налоги. Возможность принимать платежи и порядок налогообложения определяются законодательством страны, в которой разработчик ведёт деятельность и является налоговым резидентом. Разработчик самостоятельно соблюдает эти требования и уплачивает налоги. Antarctic Wallet не консультирует по законодательству других государств.
Остались вопросы? Напишите в чат для разработчиков или обратитесь в поддержку Antarctic Wallet.