Фінанси/Про інтеграцію, імпорт і розширення

Як підключити NovaPay для синхронізації в OneB Finance

#novapay #нова пошта #синхронізація #банк #api ключі #refresh token #сертифікат
OneB CFO
Оновлено 9/6/2026

NovaPay — платіжний сервіс групи «Нова пошта». Після підключення OneB Finance автоматично підтягує рахунки й транзакції NovaPay та щодня оновлює баланс — без ручного імпорту виписок.

Що потрібно перед початком

  • бізнес-акаунт NovaPay і доступ до його вебкабінету

  • права на розділ налаштувань API в кабінеті

Найважливіше: ключі одноразові

NovaPay видає пару «refresh token + сертифікат», яка діє один раз. Щойно хтось підключився з нею, сервіс видає нову пару, а стара стає недійсною — без жодного попередження.

Тому:

  • генеруйте ключі безпосередньо перед підключенням і проходьте майстер за один раз

  • не перевіряйте ключі в інших програмах чи сервісах перед підключенням — будь-яка така перевірка їх «спалить»

  • якщо підключення обірвалося на пів дорозі — не вводьте ту саму пару повторно, а згенеруйте нову

Крок 1. Згенеруйте API-ключі в кабінеті NovaPay

У бізнес-кабінеті NovaPay відкрийте Система → Налаштування → API і згенеруйте ключі. Вам знадобляться три речі:

  • логін — ваш логін у NovaPay

  • refresh token — довгий рядок символів

  • публічний сертифікат — текст, що починається з -----BEGIN RSA PUBLIC KEY-----

Крок 2. Додайте NovaPay у OneB Finance

Відкрийте Налаштування → Синхронізація → Додати банк, оберіть країну Україна, а зі списку провайдерів — NovaPay.

1.00

Заповніть форму:

  • Опис — як підключення називатиметься у вашому списку банків

  • Дата початку синхронізації — з якого дня підтягнути історію (доступно до 365 останніх днів)

  • Логін, Refresh token, Публічний сертифікат — вставте значення з кабінету. Іконка праворуч у полі вставляє текст просто з буфера обміну, щоб нічого не загубилося при копіюванні.

Натисніть «Підключити» — система перевірить ключі й авторизується в NovaPay. Після успішної перевірки одразу натисніть «Створити», не закриваючи майстер: саме цей крок зберігає підключення. Якщо зупинитися між «Підключити» і «Створити», ключі вже будуть використані, і для нової спроби доведеться генерувати нову пару.

Якщо система пише, що ключі не підходять

Повідомлення про відхилені ключі означає, що ця пара вже була використана — навіть якщо ви цього не помітили (наприклад, попередня спроба обірвалася або ключі десь перевірялися). Згенеруйте в кабінеті NovaPay нову пару і повторіть підключення одразу, без проміжних перевірок.

Що станеться після підключення

  • OneB Finance підтягне рахунки NovaPay і транзакції з обраної дати

  • нові платежі й баланс оновлюватимуться автоматично

  • транзакції з'являться в розділі «Платежі» поряд з іншими вашими банками