NovaPay Україна
Картки, Apple/Google Pay, застосунок NovaPay. Офіційна документація: https://novapay.readme.io/reference. Комісія шлюзу: 1,8 % (тариф NovaPay).
Доступи
Заявка на novapay.ua → менеджер → кабінет NovaPay Business: merchant_id; RSA-ключі генеруються в адмінці Acquiring3. Публічний ключ NovaPay для перевірки постбеків — у розділі Authentication.
- Змінні середовища
NOVAPAY_MERCHANT_IDNOVAPAY_PRIVATE_KEY (PEM)NOVAPAY_PUBLIC_KEY (PEM NovaPay)NOVAPAY_API_BASE- Вебхук
POST /webhooks/novapay; заголовокx-sign-v2= base64(RSA-SHA256(тіло)) ключем NovaPay. Запити Містка підписуютьсяx-signключем мерчанта.
Що викликає Місток
| Запит | Поля / сенс |
|---|---|
POST /v1/session | merchant_id, client_phone, client_email, callback_url, success_url, fail_url, metadata → session id |
POST /v1/payment | session_id, amount (грн), external_id, use_hold, products[] → url hosted-сторінки |
POST /v1/get-status | статус сесії |
POST /v1/void · /v1/complete-hold · /v1/expire | повернення всієї сесії · списання холду · анулювання |
Статуси
created → created · processing/holded → processing/hold · paid → success · voided → reversed · failed/blocked → failure · expired → expired.
Модель Містка: created → processing → (hold →) success | failure | expired | reversed. Замовлення в Shopify отримує оплату лише на success і лише після звірки суми й валюти з нашим записом.
Пісочниця
https://api-qecom.novapay.ua, тестовий merchant 2 з опублікованими ключами, тестові картки на сторінці Test data.
Обмеження
- тільки UAH
- повернення — лише повне (void усієї сесії)
- «Оплата частинами» NovaPay не має merchant-API: розстрочка видається покупцю всередині застосунку NovaPay; магазин її не інтегрує
Не підтверджено живим прогоном
Реалізовано за офіційними доками та SDK; перший прогін на тестових ключах обов’язковий.
- семантика hold_confirmed / to_be_paid
- обмеження довжини полів