Інтеграція ПУМБ «Платіть частинами» для сайту: підключаємо розстрочку в інтернет-магазині (кейс 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 отримав прийом оплати частинами ПУМБ на сайті, автоматичний контроль статусів заявок та безпечну видачу товару лише після надходження коштів. Розстрочка ПУМБ стала частиною платіжних методів магазину.
Бажаєте підключити ПУМБ до свого сайту?
Напишіть нам – обговоримо підключення «Платіть частинами» від ПУМБ до вашого інтернет-магазину.