PayPal в мобильном приложении: интеграция SDK и Braintree

Выбор SDK для PayPal: Checkout или Braintree?

Представьте: вы добавили платёжный SDK, протестировали в sandbox, выпустили релиз — а первые пользователи не могут оплатить, потому что возврат в приложение ломается на некоторых устройствах. Такая ситуация — следствие неправильного выбора SDK или настройки returnUrl. После 15 внедрений мы выявили схему: 60% проектов выбирают PayPal Checkout из-за простоты, но потом сталкиваются с ограничениями, когда нужна поддержка карт. Или наоборот, команды выбирают Braintree, но тратят на интеграцию в 2 раза больше времени. Разберём критерии, конфигурацию и типичные ловушки.

Как выбрать между PayPal Checkout SDK и Braintree?

PayPal Checkout SDK — простой способ добавить оплату через PayPal Wallet. Пользователь авторизуется в WebView, и после подтверждения приложение получает orderId. Однако если нужна поддержка карт VISA/Mastercard без перехода в PayPal, понадобится Braintree. Он предоставляет готовый UI для ввода карты и возвращает nonce — одноразовый токен для списания. Выбор зависит от географии и требований к UX.

Почему серверный capture обязателен?

Самая частая ошибка — считать платёж завершённым после onApprove на клиенте. На самом деле деньги списываются только после вызова capture на сервере. Это требование безопасности PayPal: клиент инициирует ордер, сервер фиксирует списание. Игнорирование этого шага приводит к потере средств или задвоению заказов.

Nonce как основа безопасности Braintree

nonce — одноразовый токен, который Braintree возвращает после успешного ввода карты или авторизации PayPal. Его нельзя использовать повторно, что исключает фрод. Для получения nonce нужно сгенерировать client_token на сервере через Braintree API. Это дополнительный шаг, но он повышает безопасность.

Проблемы, которые решаем

• Неправильный returnUrl — платёж не возвращается в приложение. Проверьте схему в Info.plist (iOS) или AndroidManifest.xml. Используйте Universal Links / App Links для надёжности.
• Sandbox-тесты с неполными аккаунтами — платежи падают с ошибкой. Обновите профиль тестового аккаунта в PayPal Developer Dashboard, добавьте подтверждённый email.
• Пропуск webhook-уведомлений — упущены изменения статуса платежа. Настройте обработку событий CHECKOUT.ORDER.APPROVED и PAYMENT.CAPTURE.COMPLETED.

Как мы это делаем: стек и конфиги

Для iOS используем Swift 5.9+ с async/await, для Android — Kotlin с Coroutines. Серверная часть на Node.js или Python (Flask). Пример создания ордера (сервер):

POST https://api-m.paypal.com/v2/checkout/orders Authorization: Bearer access_token { "intent": "CAPTURE", "purchase_units": [{ "amount": { "currency_code": "USD", "value": "15.00" }, "description": "Order #1234" }] } 

Ответ включает id — его передаём в мобильный SDK. Android (PayPal Checkout SDK):

// build.gradle implementation("com.paypal.checkout:android-sdk:1.x.x") // Application.onCreate() PayPalCheckout.setConfig( CheckoutConfig( application = this, clientId = "your_client_id", environment = Environment.LIVE, returnUrl = "yourapp://x-callback-url/paypal-sdk/paypal-checkout", currencyCode = CurrencyCode.USD, userAction = UserAction.PAY_NOW ) ) // Запуск оплаты PayPalCheckout.start( createOrder = CreateOrder { createOrderActions -> createOrderActions.set(orderId) }, onApprove = OnApprove { approval -> capturePaymentOnServer(approval.data.orderId) }, onCancel = OnCancel { }, onError = OnError { errorInfo -> Log.e("PayPal", errorInfo.reason) } ) 

iOS (PayPalCheckout SDK):

// SPM: PayPalCheckout import PayPalCheckout PayPalCheckout.set(config: CheckoutConfig( clientID: "your_client_id", createOrder: nil, onApprove: nil, onCancel: nil, onError: nil, environment: .live )) Checkout.start( createOrder: { action in action.set(orderId: "order_id_from_server") }, onApprove: { approval in self.capturePayment(orderId: approval.data.ecToken) }, onCancel: { }, onError: { error in print("PayPal error: \(error.reason)") } ) 

Сравнение SDK: PayPal Checkout vs Braintree

Braintree подходит для мультивалютных проектов с карточными платежами, но его интеграция сложнее. По нашим оценкам, настройка Braintree занимает в 2 раза больше времени, чем PayPal Checkout SDK, зато позволяет принимать карты без редиректа, что увеличивает конверсию на 10–20%.

Типичные ошибки и решения

Что входит в работу

• Архитектурная документация с обоснованием выбора SDK
• Настройка sandbox-среды и серверных endpoints
• Интеграция SDK на iOS (Swift) и Android (Kotlin)
• Тестирование всех сценариев: успех, отмена, ошибка, восстановление после сбоя
• Инструкция по деплою и мониторингу платежей
• Обучение команды (2 часа онлайн)

Процесс работы

1. Аналитика — изучаем требования к платёжному шлюзу, готовим архитектуру.
2. Проектирование — выбираем SDK, проектируем серверные endpoints.
3. Реализация — настраиваем SDK, пишем код создания и захвата ордера.
4. Тестирование — sandbox-тесты, проверка deeplink, обработка ошибок.
5. Деплой — публикация в App Store / Google Play, мониторинг.

Сроки ориентировочно

Интеграция базового PayPal Checkout SDK занимает от 2 до 3 дней для одной платформы (iOS или Android). Если нужен Braintree с картами — до 5 дней. Стоимость рассчитывается индивидуально в зависимости от сложности и количества платформ. Получите консультацию по интеграции — оценим проект за 1 день. Закажите консультацию для детального обсуждения.

Наши инженеры имеют сертификации и многолетний опыт в мобильной разработке, что гарантирует качество. Документация: PayPal Checkout SDK.