Интеграция ПУМБ «Платите частями» для сайта: подключаем рассрочку в интернет-магазине (кейс Geyzer.UA)
00 / Контекст
О работе
«Платите частями» — это BNPL-рассрочка от АО «Первый украинский международный банк» (ПУМБ): покупатель разбивает стоимость покупки на платежи без переплат. Мы подключили эту интеграцию для интернет-магазина Geyzer.UA — и в этом кейсе разбираем, как работает подключение оплаты частями ПУМБ к сайту: от API и статусов заявок до кабинета для контроля отгрузки.
Что такое «Платите частями» от ПУМБ
ПУМБ платёжное решение «Платите частями» (Buy Now Pay Later, BNPL) позволяет клиенту оформить рассрочку прямо при покупке в интернет-магазине. Покупатель вносит платежи частями, а магазин получает деньги в день продажи. Рассрочка без переплат — для покупателя, при этом срок выбирает сам магазин в момент заявки.
Почему интернет-магазину выгодна оплата частями
- Банк перечисляет магазину полную сумму в день продажи.
- Рассрочка без переплат повышает конверсию и средний чек.
- Срок рассрочки ПУМБ — от 2 до 24 месяцев, магазин выбирает в момент заявки.
- Покупателю не нужно заранее узнавать лимит: магазин отправляет заявку, которая ждёт клиента в приложении ПУМБ.
- Первый платёж клиента происходит через месяц после покупки.
Что было сделано в проекте Geyzer.UA
- Платёжный метод «Платите частями» интегрирован в процесс оформления заказа.
- Реализованы OAuth2-авторизация, создание заявки, получение статуса и подтверждение отгрузки.
- Настроен кабинет заявок в админке магазина (отдельного merchant-кабинета банк не предоставляет).
Три схемы интеграции: активная, пассивная, гибридная
Поддержаны две основные схемы работы с ПУМБ BNPL API и их сочетание. Активная схема (callback) полагается на уведомления банка, пассивная (pull) — на периодическую выгрузку статусов, гибридная комбинирует оба подхода. Это позволяет магазину выбрать подходящий режим работы с заявками.
Как это работает технически
Интеграция строится на REST API банка. Ключевые точки API ПУМБ: POST /sf-credits создаёт заявку, GET /sf-credits/{id} возвращает статус, PATCH /sf-credits/{id} подтверждает отгрузку или отменяет заказ. Авторизация — по протоколу OAuth2 (client_id=EXT_OIC, grant_type=password), поток заявки — flow.type = DIGITAL_SF.
Работа ведётся в двух средах: тестовой (DTS) и боевой (authsrv.pumb.ua / apiext.pumb.ua). Банк присылает callback с параметрами cap_id и state, в ответ ожидается JSON вида \{"success":true,"error":null\}.
Статусы заявок и правила выдачи товара
| Статус | Значение | Действие магазина |
|---|---|---|
| WAITING_CLIENT | заявка ждёт клиента | ждать |
| WAITING_STORE_CONFIRM | банк ждёт подтверждения магазина | подтвердить отгрузку |
| FUNDED | деньги зачислены | выдать товар |
| REJECTED / NO_LIMIT / OVER_LIMIT / CLIENT_NOT_FOUND | продажа невозможна | не отдавать товар |
| PUSH_TIMEOUT / FAIL_OTP / CANCELED_* / CONFIRM_TIME_EXPIRED | заявка не состоялась | новая заявка, товар не отдавать |
Оплата в системе магазина ставится только при статусах WAITING_STORE_CONFIRM и FUNDED.
Как подключить ПУМБ к своему магазину
- Открыть счёт в ПУМБ (оборот до 200 млн грн).
- Подать заявку через интернет-банкинг «ПУМБ Бизнес»: «Продукты и сервисы» → «Другие продукты» → «Платите частями».
- Получить учётные данные для API.
- Выбрать схему интеграции.
- Передать банку URL callback.
Результат и выводы
Интернет-магазин Geyzer.UA получил приём оплаты частями ПУМБ на сайте, автоматический контроль статусов заявок и безопасную выдачу товара только после поступления средств. Рассрочка ПУМБ стала частью платёжных методов магазина.
Хотите подключить ПУМБ к своему сайту?
Напишите нам — обсудим подключение «Платите частями» от ПУМБ к вашему интернет-магазину.