Начало работы
Выберите способ интеграции с Plexy
Это документация для API v2 и интеграции через SDK. Ищете более стабильную legacy-версию? См. документацию API v1.
Скорость или полный контроль — решать вам.
Plexy предлагает два способа интеграции: Сессии — один API-вызов, а Plexy берёт на себя всё остальное, — или Расширенный поток, где вы жертвуете усилиями ради полного контроля над интерфейсом оплаты и жизненным циклом платежа.
Сравнение двух потоков
| Сессии | Расширенный поток | |
|---|---|---|
| Когда подходит | Самый быстрый путь к живым платежам | Полностью брендированная кастомная оплата |
| Необходимые API-вызовы | Один (POST /v2/sessions) | Три и более (/paymentMethods → /payments → /payments/details) |
| Кто обрабатывает 3DS и редиректы | Plexy | Вы |
| Контроль над UX | Средний — чекаут от Plexy с возможностью темизации | Высокий — ваша собственная форма оплаты, полная кастомизация |
| Время до первого платежа | Минуты | Дни |
| Примеры подходящих сценариев | Чекаут для SMB, выставление счетов, подписочная оплата | Маркетплейсы, флагманские приложения с кастомным брендингом, многошаговые чекауты |
Не знаете, что выбрать?
Начните с Сессий — этот поток подходит большинству мерчантов и быстрее всего приведёт вас к первому живому платежу. Выбирайте Расширенный поток, когда вам нужна полностью брендированная форма оплаты или кастомная оркестрация, которую Сессии не могут обеспечить.
Продолжите выбранным потоком
Сессии →
Создайте сессию, установите чекаут на страницу, обработайте результат через вебхук.
Расширенный поток →
Отрисуйте способы оплаты, отправьте платежи, обработайте 3DS самостоятельно.
Дальше
- Руководства по SDK для вашей платформы
- Справочник API со всеми эндпоинтами
Выберите способ отрисовки Plexy на клиенте
Два способа подключить Plexy в ваше приложение.
Drop-in — это одна готовая компонента, которая отрисовывает весь чекаут целиком: выбор способа оплаты, формы и 3DS-запросы. Components — отдельные компоненты способов оплаты (Card, Apple Pay, Google Pay, ...), которые вы размещаете и стилизуете в собственном интерфейсе. Оба варианта работают и с Сессиями, и с Расширенным потоком — это выбор о клиентской отрисовке, а не о потоке.
| Drop-in | Components | |
|---|---|---|
| Когда подходит | Самая быстрая клиентская интеграция | Композируемые, кастомные раскладки |
| Что вы рендерите | Один маунт <Dropin /> — чекаут целиком | Отдельные компоненты способов оплаты, которые вы размещаете сами |
| Владение UI способов оплаты | Plexy отрисовывает все способы (Card, Apple Pay, Google Pay, ...) | Вы сами выбираете и размещаете каждый компонент |
| Размер бандла | Больше — включает все зарегистрированные способы оплаты | Меньше — tree-shake до нужных вам способов |
| Время на интеграцию | Минуты | Часы |
| Примеры подходящих сценариев | Стандартный одностраничный чекаут, MVP, быстрый запуск | Многошаговые потоки, кастомные раскладки, выборочные способы оплаты |
Начните с Drop-in — это самый быстрый способ выпустить рабочий чекаут. Переходите на Components, когда нужна кастомная раскладка, выборочные способы оплаты или минимальный размер бандла.