Архитектура платформы
Braintree — это не просто «ещё один платёжный шлюз». PayPal приобрёл его в 2013 году за $800M, и с тех пор Braintree обрабатывает транзакции для Uber, Airbnb, GitHub, Dropbox и ещё 150 000+ компаний. В отличие от Stripe, который построен на собственной инфраструктуре, Braintree сидит на платёжной магистрали PayPal — это даёт плюсы (глобальный охват) и минусы (зависимость от одного вендора).
Архитектурно Braintree разделён на три слоя:
- Gateway Layer — API-фасад: REST/GraphQL, SDK для 7 языков
- Processing Engine — ядро: маршрутизация транзакций, валютная конвертация, фрод-скоринг
- Settlement Layer — расчёты: ACH, SEPA, SWIFT, локальные клиринговые системы
API и интеграция
Braintree предлагает два подхода к интеграции:
Drop-in UI — готовая платёжная форма, встраиваемая одним <script>-тегом. Поддерживает кастомизацию CSS, 23 языка интерфейса. Полная PCI SAQ A (минимальный уровень требований), потому что платёжные данные уходят напрямую в Braintree, минуя ваш сервер.
Custom Integration — полный контроль через Client SDK + Server SDK. Клиентский SDK генерирует payment method nonce (одноразовый токен), серверный проводит транзакцию. Схема:
Client (Browser/App) → Braintree Client SDK → Payment Method Nonce
Your Server → Braintree Server SDK → Transaction (sale/auth/submitForSettlement)SDK доступны для Node.js, Python, Ruby, PHP, Java, .NET, Go. Качество документации — выше среднего, с рабочими примерами под каждую комбинацию языка и фреймворка.
GraphQL API появился в 2025 году — позволяет одним запросом создавать мерчанта, настраивать webhook и обрабатывать тестовую транзакцию. Для платформ с онбордингом десятков суб-мерчантов это сокращает код в 3-4 раза.
Безопасность
Braintree PCI DSS Level 1 (как Stripe и Adyen). Ключевые компоненты:
- Tokenization — номера карт никогда не касаются вашего сервера. Payment nonce одноразовый, привязан к merchant ID.
- 3D Secure 2.x — поддержка всех трёх флоутов (frictionless, challenge, fallback). Конфигурируется в песочнице без отдельного контракта.
- Fraud Protection — машинное обучение на данных 400M+ аккаунтов PayPal. Risk scoring от 0 до 100 с объяснением факторов.
- Webhook Signatures — каждая нотификация подписана приватным ключом. SDK валидирует сигнатуру автоматически.
Масштабирование и валюта
Braintree поддерживает 130+ валют и 45+ стран для процессинга. Ключевое отличие от Stripe: тот же мерчант-аккаунт PayPal работает в Braintree. Если вы уже принимаете PayPal, подключение Braintree для карт — это одна кнопка в дашборде.
Для маркетплейсов: Braintree Marketplace обрабатывает split-платежи, эскроу и выплаты суб-мерчантам. В отличие от Stripe Connect, где сложная система connected accounts, Braintree делает это через sub-merchant onboarding API с KYC-проверками, делегированными PayPal.
Rate limiting: 100 запросов/сек на standard, до 1000/сек на enterprise. Webhook доставка с экспоненциальным backoff (10 попыток за 7 дней).
Подводные камни
Документация по ошибкам — слабое место. Validation errors возвращают HTTP 422 с кодом ошибки, но message часто неинформативен. Приходится держать открытой страницу с полным списком кодов ошибок.
Локализация UI — 23 языка, но русского нет. Придётся кастомизировать Drop-in или использовать custom integration.
Санкционные ограничения — наследуются от PayPal. Некоторые страны недоступны для приёма платежей, даже если Braintree там официально присутствует.
Партнёрская программа
Braintree Partner Program ориентирована на платформы и агентства. Два уровня:
- Referral Partner — $100 за каждого мерчанта с оборотом >$1K в первые 3 месяца
- Solution Partner — technical accreditation + revenue share (до 20% от interchange на первые 2 года)
Для разработчиков, внедряющих Braintree в клиентские проекты, Solution Partner даёт приоритетную поддержку и доступ к бета-фичам.
Сайт: braintreepayments.com EOF" 2>&1 | tail -3