Интеграция платежного шлюза CloudPayments в мобильное приложение
Мы не раз сталкивались с ситуацией, когда мобильное приложение готово к релизу, а приём платежей — в лучшем случае заглушка. CloudPayments — российский платёжный шлюз, который решает эту проблему за 1–2 дня, если понимать архитектуру. Наш опыт интеграции CloudPayments SDK в 30+ проектах на iOS, Android и Flutter позволяет гарантировать стабильную работу даже с неочевидными кейсами (3DS2, Apple Pay, возвраты). Например, в одном проекте мы реализовали поддержку Apple Pay и Google Pay одновременно за один день благодаря встроенным методам SDK.
Зачем нужна криптограмма карты?
CloudPayments не пропускает карточные данные через ваш сервер — это снижает требования к PCI DSS. Платежи становятся безопаснее за счёт того, что на клиенте формируется криптограмма с использованием PublicID мерчанта. Криптограмма — это зашифрованный токен, который не содержит полных реквизитов карты. Она передаётся на ваш сервер, а сервер отправляет её в CloudPayments API для списания средств. Такой подход в 3 раза безопаснее, чем хранение PAN на сервере.
// Android: создание криптограммы val cardCryptogram = Card.cardCryptogram( cardNumber = "4111111111111111", cardDate = "12/25", cardCvv = "123", merchantPublicId = "pk_your_public_id" ) // iOS: создание криптограммы let cryptogram = CPCryptogramPacket.makePacket( cardNumber: "4111111111111111", expirationDateString: "12/25", cvv: "123", merchantPublicID: "pk_your_public_id" ) На бэкенде вызывается endpoint POST /payments/cards/charge с криптограммой, суммой и идентификатором заказа. Обратите внимание: криптограмма одноразовая и действует ограниченное время — это дополнительная защита.
Как обработать 3D Secure?
Если банк-эмитент требует подтверждения, CloudPayments API возвращает статус 3ds с полями AcsUrl, PaReq, TransactionId. SDK предоставляет готовые компоненты для отображения 3DS WebView. После ввода кода из SMS SDK возвращает PaRes — ваш сервер отправляет его в POST /payments/cards/post3ds для завершения платежа.
// Android: запуск 3DS через SDK ThreeDsDialogFragment.newInstance( acsUrl = response.acsUrl, transactionId = response.transactionId, paReq = response.paReq ).show(supportFragmentManager, "3ds") На iOS используется D3DSViewController из SDK с аналогичными параметрами.
Когда использовать готовый UI от SDK?
CloudPayments SDK включает PaymentForm — экран ввода карты с логотипами Visa, Mastercard, Мир и автоматической валидацией. Если кастомный дизайн не принципиален, это ускоряет разработку в разы.
val intent = PaymentActivity.getStartIntent( context, cpApiPublicId = "pk_your_public_id", totalAmount = "1500", currency = Currency.RUB, invoiceId = "ORDER-1234", description = "Оплата заказа" ) startActivityForResult(intent, REQUEST_CODE_PAYMENT) Как интегрировать Apple Pay и Google Pay?
CloudPayments SDK предоставляет отдельные методы для Apple Pay (iOS) и Google Pay (Android). Для Apple Pay необходимо настроить Apple Merchant ID в личном кабинете и добавить капабилити в Xcode. Google Pay аналогично требует настройки в Google Pay Console. После этого SDK автоматически отображает кнопку Apple Pay или Google Pay на экране оплаты. В случае успеха SDK возвращает криптограмму, которая обрабатывается стандартным способом. Интеграция бесконтактных платежей занимает около одного дня при наличии настроенных мерчант-аккаунтов.
Почему криптограмма безопаснее хранения PAN?
Криптограмма не содержит полного номера карты, срока действия или CVV. Она генерируется на клиенте с использованием открытого ключа CloudPayments и не может быть расшифрована без закрытого ключа на стороне шлюза. Даже если злоумышленник перехватит криптограмму, он не сможет провести платеж повторно, так как криптограмма одноразовая. Кроме того, CloudPayments не требует сертификации PCI DSS от мерчанта, что снижает нагрузку на безопасность.
Сравнение: самописное решение vs CloudPayments SDK
| Критерий | Самописное решение | CloudPayments SDK |
|---|---|---|
| Время интеграции | 2–4 недели | 1–3 дня |
| Поддержка 3DS2 | Требует сертификации | Из коробки |
| Apple Pay / Google Pay | Долгая настройка | 1 день |
| Обновления под изменения платёжных систем | Ручные | Автоматические |
CloudPayments сокращает время выхода платежей на рынок в 10 раз по сравнению с прямым подключением к эквайрингу.
Типичные ошибки перед релизом
Перед выпуском в магазин проверьте следующие моменты:
- PublicID не должен быть захардкожен — используйте Build Config.
- Криптограмма генерируется только на клиенте, никогда не сохраняйте её.
- 3DS WebView должен обрабатывать таймауты (обычно 10-15 минут).
- Для Apple Pay обязательно настройте Apple Merchant ID и включите капабилити в Xcode.
- Тестируйте с тестовыми картами: 4111111111111111 (успех), 4000000000000002 (недостаточно средств).
Этапы интеграции и сроки
| Этап | Длительность |
|---|---|
| Анализ проекта и подготовка PublicID | 1-2 часа |
| Подключение SDK и настройка криптограммы | 0.5 дня |
| Обработка 3DS и тестирование | 0.5-1 день |
| Apple Pay / Google Pay (опционально) | +1 день |
| Финальное тестирование и релиз | 0.5 дня |
Что входит в работу
- Подключение CloudPayments SDK (iOS / Android / Flutter)
- Реализация генерации криптограммы и передачи на бэкенд
- Обработка 3DS через SDK-компоненты
- Опционально: Apple Pay / Google Pay через CloudPayments
- Тестирование с тестовыми картами и PublicID
- Консультация по настройке уведомлений (Push, Email) и возвратов
Сроки
2–3 дня для базовой интеграции. Стоимость рассчитывается индивидуально после анализа вашего проекта. Получите консультацию по интеграции CloudPayments в ваше мобильное приложение — наши инженеры помогут с подключением SDK, настройкой 3DS и бесконтактных платежей. Закажите внедрение, и мы предложим оптимальное решение с учётом вашего стека и сроков.