Syntra Systems
Кейсы Услуги Продукты О нас Блог IT Caravan
+998 70 010 68 44 +7 999 900 22 12
RusEngUzb
Выключенный смартфон на тёмном столе в мягком свете — статья о приёме оплаты в мобильном приложении через Click и Payme
Мобильные

Оплата в мобильном приложении: Click, Payme и правила магазинов

Автор: Никита Жулин · · 10 мин чтения

Если в приложении продаются товары, доставка или услуги, которыми человек пользуется вне приложения, брать за них деньги встроенной покупкой Apple и Google нельзя — нужен платёж картой через Click, Payme или Apple Pay. Если вы продаёте доступ к функциям внутри приложения, правило обратное: подписку и платные разделы оба магазина разрешают оплачивать только своей встроенной покупкой.

Коротко

  • Правила магазинов зависят от того, где человек пользуется покупкой: товары, доставку и услуги вне приложения оплачивают картой через Click или Payme, а доступ к функциям внутри приложения — только встроенной покупкой.
  • Apple записала это в пунктах 3.1.3(e) и 3.1.1 правил проверки, а Google Play перечисляет исключения списком: физические товары, перевозка, доставка еды, билеты, оплата счетов и переводы между людьми.
  • Готовые мобильные библиотеки Click и Payme есть только для Android, поэтому версию для iPhone собирают на серверных методах провайдера и его платёжной странице.
  • Статус заказа меняет только подтверждение провайдера на вашем сервере: параметру в адресе возврата из браузера доверять нельзя.

Что решает, каким способом приложение берёт деньги

Способ оплаты выбирает не бизнес, а правила магазинов, и ключ в них один: где человек пользуется тем, что купил. Покупка, которой пользуются вне приложения, идёт мимо встроенного платежа; всё, что открывает возможности внутри приложения, — только через него.

У Apple это записано прямо: если приложение даёт купить физические товары или услуги, которые будут потреблены вне приложения, для сбора таких платежей нужно использовать способы, отличные от встроенной покупки, — например Apple Pay или обычный ввод карты (App Store Review Guidelines, пункт 3.1.3(e)).

Обратная сторона — пункт 3.1.1 тех же правил. Чтобы открыть возможности внутри приложения — подписку, уровни, доступ к платному содержимому, полную версию, — вы обязаны использовать встроенную покупку, а свои механизмы разблокировки вроде лицензионных ключей или QR-кодов запрещены. Там же отдельно сказано про сертификаты: цифровые подарочные карты и купоны, которые обменивают на цифровые товары, продают в приложении только встроенной покупкой, а физические подарочные карты с отправкой покупателю — другими способами.

У Google Play логика та же, но исключения перечислены списком. Платёжная система Google Play не должна использоваться, когда оплата идёт за покупку или аренду физических товаров, за физические услуги — перевозку, уборку, авиабилеты, абонементы в спортзал, доставку еды, билеты на живые мероприятия, — за погашение счёта по карте или коммунального счёта, а также для переводов между людьми, онлайн-аукционов и донатов, освобождённых от налога (платёжная политика Google Play).

Что продаётеApp StoreGoogle PlayЧем платит клиент
Товары с доставкой, еда, услуги на месте, билеты на мероприятияВстроенная покупка запрещенаПлатёжная система Google Play запрещенаКарта через Click, Payme или Uzum Bank, Apple Pay
Подписка на функции приложения, платные разделы, внутренняя валютаТолько встроенная покупкаТолько платёжная система Google PlayСчёт магазина, деньги приходят выплатой
Оплата коммунальных счетов, погашение счёта по карте, перевод другому человекуВстроенная покупка запрещенаПлатёжная система Google Play запрещенаКарта через местного провайдера
Подарочная карта: цифровая на цифровые товары или физическая с отправкойЦифровая — встроенной покупкой, физическая — другими способамиЦифровая под исключения не попадает, физическая — это товар, платёж запрещёнСчёт магазина или карта, смотря что продаёте

Формулировки в обоих документах точные, а редакции меняются. Свой случай сверяйте с действующей версией правил по ссылкам в конце статьи: решение «встроенная покупка или карта» принимают один раз и переделывают дорого.

Важно Правило касается не только кнопки оплаты. Если доступ к платному разделу открывается по ключу или QR-коду, купленному на стороне, для App Store это нарушение, даже когда внутри приложения вы денег не берёте.

Сколько магазины берут за встроенную покупку

Ставка зависит от магазина и от выручки разработчика. Apple снижает её участникам программы для малого бизнеса: 15 % с платных приложений и встроенных покупок — для разработчиков, у которых поступления по всем приложениям за предыдущий календарный год не превысили 1 млн долларов, и для тех, кто выходит в App Store впервые. Если порог превышен в текущем году, к дальнейшим продажам применяется стандартная ставка (App Store Small Business Program).

Google Play для рынков вне США, Европейской экономической зоны, Великобритании, Японии и Австралии держит ставку 15 % на первый миллион долларов выручки за год и 30 % на всё, что выше; подписки идут по 15 % независимо от суммы (справка Google Play о сервисных сборах).

Поэтому тип покупки определяют до разработки, а не после релиза: сбор магазина ложится на каждую подписку и на каждый платёж за доступ внутри приложения, а эквайринг местного провайдера работает по условиям вашего договора с ним.

Разница в правилах важнее разницы в долях платформ. Android стоит на большей части устройств Узбекистана, и готовая библиотека есть именно под него, поэтому с Android интеграцию начинать проще. Но строже смотрит Apple, так что платёжный контур проектируют сразу под требования App Store: иначе версию для iPhone придётся переделывать вместе с серверной частью.

Как Click и Payme подключаются к приложению

У обоих провайдеров приём платежей держится на сервере: приложение не общается с банком напрямую, оно отдаёт заказ вашему серверу, а провайдер подтверждает оплату его методами. Готовые мобильные библиотеки у обоих есть только для Android.

Click: Shop API и библиотека для Android

Click подключают по схеме Shop API: ваш сервер реализует запросы Prepare и Complete, после чего услугу можно оплатить в любом интерфейсе Click — в его приложении, в веб-кабинете, через USSD или бота. Отдельно есть Merchant API с разделом фискализации данных и веб-платежи: платёжная ссылка и оплата картой (документация Click).

Для Android Click публикует библиотеку android-msdk, которая встраивает экран оплаты прямо в приложение. В конфигурацию передают идентификатор услуги, идентификатор продавца, идентификатор пользователя в вашей системе, сумму и язык интерфейса; подключается библиотека через репозиторий JitPack и требует разрешения на доступ в интернет. В описании отдельно сказано: поставщик со своим биллингом может обойтись и без библиотеки, но Shop API на сервере приложения реализовать всё равно придётся (android-msdk на GitHub).

Payme: Merchant API, Subscribe API и привязка карты

У Payme два протокола. Merchant API — основной приём платежей: провайдер вызывает методы вашего сервера, чтобы проверить, создать, провести и отменить транзакцию. Subscribe API отвечает за работу с картой клиента и повторные списания, и именно он нужен приложению, в котором карту сохраняют один раз.

Страница об интеграции с мобильным приложением описывает Android SDK так: библиотека даёт клиентский интерфейс и методы работы с картой из Subscribe API, а методы карт и чеков на стороне сервера реализуете вы (Payme Business). Результат оплаты библиотека возвращает приложению без карточных данных: маска номера, срок действия, платёжный токен и признаки повторного списания и подтверждения по SMS. Приложение передаёт токен на свой сервер, и тот завершает платёж через Subscribe API.

Ошибка Планировать версию для iOS в расчёте на готовый SDK провайдера. Публичный репозиторий Payme для Android владелец архивировал 2 августа 2023 года, и он доступен только для чтения (PaycomUZ на GitHub), а в организации Click библиотеки для iOS нет вовсе. Версию для iPhone собирают на серверных методах провайдера и его платёжной странице, а не на мобильной библиотеке.

Что делать на iOS, где официальной библиотеки нет

На iOS оплату собирают из трёх частей: ваш сервер создаёт счёт, приложение открывает платёжную страницу провайдера, сервер получает подтверждение и меняет статус заказа. Экран оплаты показывает провайдер, карточные данные в приложение не попадают.

  1. Сервер создаёт заказ и считает сумму. Итог считается на сервере: сумму, пришедшую с устройства, не принимают.
  2. Сервер получает у провайдера платёжную ссылку или формирует её по документации.
  3. Приложение открывает ссылку — в системном браузерном окне или во внешнем браузере.
  4. Клиент платит картой и при необходимости проходит подтверждение банка.
  5. Провайдер вызывает метод вашего сервера и сообщает результат. Сервер проверяет подпись и не обрабатывает один и тот же платёж дважды.
  6. Приложение запрашивает новый статус заказа у своего сервера, а не берёт его из параметров возврата.

Шестой шаг — тот, на котором чаще всего ломается логика. Параметр в адресе возврата говорит лишь о том, что человек закрыл платёжную страницу, и подделать его легко. Источник истины — ваш сервер после вызова провайдера. Как делить ответственность между приложением и серверной частью, разобрано в статье бэкенд и API для мобильного приложения.

Apple Pay в приложении — не замена эквайрингу: платёж всё равно идёт через вашего провайдера, Apple лишь подставляет карту и подтверждение владельца. Для сценария «товары и услуги вне приложения» правила Apple прямо называют Apple Pay допустимым способом оплаты.

Как оплата встраивается в путь клиента

Оплата в приложении — это не один экран, а состояние заказа, которое клиент видит и после того, как закрыл приложение. Минимум, который нужно спроектировать, выглядит так.

Идентификатор операции сохраняйте рядом с заказом в тот момент, когда он приходит: по нему потом ищут платёж при разборе спора и оформляют возврат. То же правило работает и в платёжном контуре веб-платформы — он описан в статье биллинг и приём оплат на веб-платформе.

Если продажи уже идут в мессенджере, переносить их в приложение целиком не нужно: бот и приложение закрывают разные привычки клиентов. Как устроен приём заказов с оплатой в Telegram, разобрано в статье приём заказов в Telegram-боте с оплатой Click и Payme.

Из-за чего приложение с оплатой не проходит проверку

Большинство отказов связано не с кодом, а с тем, что способ оплаты не совпадает с типом покупки. Проверяющий открывает экран оплаты и сверяет его с правилом.

Отдельная частая причина — расхождение между описанием в магазине и тем, что происходит на экране. Если в описании обещана подписка, а приложение просит карту, проверку это не пройдёт. Что ещё смотрят перед публикацией, собрано в статье как опубликовать приложение в App Store и Google Play.

Что проверить до отправки сборки

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

Как мы это делаем

Syntra Systems начинает такие проекты не с кода, а с разбора продаж: что именно покупает клиент и где он этим пользуется. От ответа зависит, что в приложении станет встроенной покупкой, а что уйдёт на Click, Payme или Uzum Bank, и каким будет платёжный контур на сервере.

Дальше мы собираем серверную часть — заказы, статусы, обработку уведомлений провайдера и защиту от повторной оплаты, — подключаем библиотеку провайдера на Android и платёжную страницу на iOS, проходим тестовую среду по всем сценариям и готовим сборку так, чтобы экран оплаты соответствовал правилам магазинов. Что входит в работы и как обсудить задачу, видно в каталоге услуг.

Обсудим вашу задачу

Расскажите, что нужно сделать, — оценим сроки и стоимость и предложим решение.

Обсудить оплату в приложении

Частые вопросы

Можно ли принимать оплату в приложении только через Click и не делать встроенную покупку?

Да, если всё, что вы продаёте, человек получает вне приложения: товары с доставкой, еду, услуги на месте, билеты. Как только в приложении появляется платный доступ к его собственным функциям, для этой части продаж потребуется встроенная покупка магазина.

Нужен ли отдельный договор с Click или Payme, если оплата уже работает на сайте?

Это уточняют у провайдера: в документации Click и Payme мобильное приложение описано как ещё один интерфейс поставщика, а не как отдельная услуга. На стороне разработки переиспользуются серверные методы, которые уже реализованы для сайта, а в приложение добавляется экран оплаты и обработка результата.

Почему приложение не должно доверять результату оплаты из браузера?

Параметр в адресе возврата означает лишь то, что платёжная страница закрылась, и подделать его легко. Единственное подтверждение — вызов провайдера на ваш сервер, после которого приложение запрашивает у сервера новый статус заказа.

Где хранить карту клиента, чтобы он не вводил её каждый раз?

У провайдера, а не у себя. За привязку карты и повторные списания у Payme отвечает Subscribe API, а приложению возвращаются маска номера, срок действия и платёжный токен. Карточные данные не должны проходить через ваш сервер и храниться в приложении.

Что происходит с подпиской, если приложение выходит и в App Store, и в Google Play?

Подписку придётся вести в двух системах магазинов сразу, а ваш сервер должен сводить их к одному состоянию доступа у клиента. Иначе человек, купивший подписку на Android, не получит её, когда зайдёт с iPhone.

Можно ли из приложения отправить клиента платить на свой сайт?

Для товаров и услуг, которыми пользуются вне приложения, это рабочий сценарий: правила прямо допускают ввод карты. Для платного доступа внутри приложения обходные пути ограничены — альтернативные платёжные системы у Google работают только в странах, включённых в соответствующую программу.

Сколько способов оплаты стоит показывать на экране?

Достаточно тех, которыми действительно платят ваши клиенты: карта через местного провайдера и, на iPhone, Apple Pay. Каждый добавленный способ приходится целиком проводить через тестовую среду и поддерживать при каждом релизе.

Фото на обложке: Hasan Albari, Pexels

Читайте также