Download the PHP package sashalenz/novapay-api without Composer
On this page you can find all versions of the php package sashalenz/novapay-api. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download sashalenz/novapay-api
More information about sashalenz/novapay-api
Files in sashalenz/novapay-api
Package novapay-api
Short Description NovaPay Business Cabinet API client for Laravel
License MIT
Homepage https://github.com/sashalenz/novapay-api
Informations about the package novapay-api
NovaPay API
Laravel пакет для роботи з NovaPay Business Cabinet API v2.0.
Реалізовано всі 15 методів згідно офіційної документації «API інструкція (березень 2026)».
Встановлення
Опублікуй конфіг:
Конфігурація
Додай у .env:
refresh_token і public_certificate генеруються в особистому кабінеті:
Бізнес-кабінет → Система → Налаштування → API.
Автентифікація
JWT (рекомендований метод)
Метод використовує одноразову ротацію токенів. Кожен виклик повертає новий refresh_token і public_certificate, які треба зберігати для наступного запиту.
⚠️ Після кожного успішного виклику старий
refresh_tokenанульовується. Зберігай нові значення одразу після відповіді.
Інтеграція з Eloquent моделлю
Реалізуй інтерфейс HasNovapayCredentials на моделі, де зберігаються облікові дані:
Використання:
💡
NovapayCredentials::withUpdatedTokens()дозволяє оновити токени immutably, зберігаючи той самийlogin:
Легасі (буде відключено 31.08.2026)
Методи API
Всі методи, окрім Auth, приймають токен через fluent-методи:
Клієнти (підприємства)
GetClientsList — список підприємств
Рахунки
GetAccountsList — список рахунків підприємства
GetAccountRest — баланс рахунку
GetPaymentsList — виписка платежів (XML)
GetAccountExtract — виписка з залишками (XML)
GetAccountTurns — обороти по рахунку
Платежі
CreatePayment — створення платежу
GetRecallPaymentsList — платежі доступні для відкликання
RecallPayment — відкликання платежу
Реєстри (Post-payment / КО)
GetRegister — генерація виписки реєстру
DownloadRegister — отримання посилання на файл
💡 Файл може генеруватись асинхронно. Якщо
status !== 'created'— викликайdownload()повторно через кілька секунд.
Proxy
Всі ApiModel підтримують проксі:
Обробка помилок
Всі методи кидають NovapayApiException при HTTP помилці або невалідній SOAP відповіді.
Логічні помилки (невірний токен, нема доступу) повертаються як успішна HTTP відповідь з result = 'error':
Enums
| Клас | Значення |
|---|---|
AccountStatus |
Active, Closed, OnApproval, Arrested |
DateType |
PaymentDate(0), FromDate(1), CreatedDate(2), UpdatedDate(3) |
RegisterFileExtension |
XLS, CSV |
Тести
Всі тести використовують Http::fake() — реальні запити до NovaPay не виконуються.
Ліцензія
MIT
All versions of novapay-api with dependencies
illuminate/contracts Version ^10.0||^11.0||^12.0||^13.0
spatie/laravel-data Version ^4.11
spatie/laravel-package-tools Version ^1.16