Інтеграція платіжного шлюзу 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 та безконтактних платежів. Замовте впровадження, і ми запропонуємо оптимальне рішення з урахуванням вашого стеку та термінів.