PHPackages                             fourier-semperfi/novapay-business-sdk - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. fourier-semperfi/novapay-business-sdk

ActiveLibrary[API Development](/categories/api)

fourier-semperfi/novapay-business-sdk
=====================================

PHP SDK for NovaPay Business SOAP API

00PHP

Since Feb 19Pushed 2mo agoCompare

[ Source](https://github.com/Fourier-SemperFi/NovapayBusinessSDK)[ Packagist](https://packagist.org/packages/fourier-semperfi/novapay-business-sdk)[ RSS](/packages/fourier-semperfi-novapay-business-sdk/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

NovaPay Business SDK
====================

[](#novapay-business-sdk)

PHP SDK for the NovaPay Business SOAP API. No database dependencies — token persistence is the caller's responsibility.

Requirements
------------

[](#requirements)

- PHP 7.4+
- ext-soap
- ext-simplexml

Installation
------------

[](#installation)

```
composer require novapay/business-sdk
```

Quick Start
-----------

[](#quick-start)

```
use src\NovaPayClient;

$client = new NovaPayClient();

// Step 1: Pre-auth (sends OTP)
$preAuth = $client->preAuthenticate('login', 'password');

// Step 2: Confirm OTP
$auth = $client->authenticate($preAuth->tempPrincipal, $preAuth->codeOperationOtp, $otp);

// Persist $auth->principal and $auth->expiration yourself!

// Get data
$clients  = $client->getClients($auth->principal);
$accounts = $client->getAccounts($auth->principal, $clients[0]->id);
$balance  = $client->getBalance($auth->principal, $accounts[0]->id);
$extract  = $client->getExtract($auth->principal, $accounts[0]->id, '01.01.2025', '31.01.2025');
```

API Reference
-------------

[](#api-reference)

### Authentication

[](#authentication)

MethodReturnsDescription`preAuthenticate($login, $pass)``PreAuthResult`Sends OTP to user's phone`authenticate($temp, $code, $otp)``AuthResult`Confirms OTP, returns session token`refreshSession($principal)``AuthResult|null`Extends session lifetime`isSessionValid($principal, $exp)``bool`Static helper to check token validity### Data

[](#data)

MethodReturnsDescription`getClients($principal)``Client[]`List business clients`getAccounts($principal, $clientId)``Account[]`List bank accounts`getBalance($principal, $accountId)``Balance`Single account balance`getBalances($principal, $clientId)``Balance[]`All account balances (with error callback)`getExtract($principal, $acctId, $from, $to)``Extract`Parsed statement`getExtractRaw($principal, $acctId, $from, $to)``string|null`Raw XML for custom parsing### DTO Objects

[](#dto-objects)

**AuthResult** — `->principal`, `->expiration`, `->isValid()`

**Client** — `->id`, `->name`

**Account** — `->id`, `->iban`, `->currency`, `->balance`

**Balance** — `->accountId`, `->confirmed`, `->available`, `->projected`, `->raw`

**Transaction** — `->code`, `->date`, `->amount`, `->currency`, `->purpose`, `->paymentType`, `->debitName`, `->debitIban`, `->debitStateCode`, `->creditName`, `->creditIban`, `->creditStateCode`, `->isIncoming($iban)`, `->isOutgoing($iban)`

**Extract** — `->iban`, `->transactions`, `->incoming()`, `->outgoing()`, `->byCreditEdrpou($code)`, `->byDebitEdrpou($code)`, `->byCodePattern($regex)`

### Custom SOAP Options

[](#custom-soap-options)

```
$client = new NovaPayClient('https://business.novapay.ua/Services/ClientAPIService.svc?wsdl', 'https://business.novapay.ua/Services/ClientAPIService.svc');

// Inject SoapClient for testing
$mock = $this->createMock(SoapClient::class);
$client = NovaPayClient::withSoapClient($mock);
```

File Structure
--------------

[](#file-structure)

```
src/
├── NovaPayClient.php      # Main API client
├── ExtractParser.php       # XML  DTO parser (usable standalone)
└── DTO/
    ├── Account.php
    ├── AuthResult.php
    ├── Balance.php
    ├── Client.php
    ├── Extract.php
    ├── PreAuthResult.php
    └── Transaction.php

```

###  Health Score

19

—

LowBetter than 10% of packages

Maintenance56

Moderate activity, may be stable

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity12

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/1730860c8b32586d7129aa4e452aad7133a1565765c770e6c1ec3d6700169e45?d=identicon)[Fourier-SemperFi](/maintainers/Fourier-SemperFi)

---

Top Contributors

[![Fourier-SemperFi](https://avatars.githubusercontent.com/u/202440418?v=4)](https://github.com/Fourier-SemperFi "Fourier-SemperFi (2 commits)")

### Embed Badge

![Health badge](/badges/fourier-semperfi-novapay-business-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/fourier-semperfi-novapay-business-sdk/health.svg)](https://phpackages.com/packages/fourier-semperfi-novapay-business-sdk)
```

###  Alternatives

[stripe/stripe-php

Stripe PHP Library

4.0k143.3M480](/packages/stripe-stripe-php)[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M272](/packages/twilio-sdk)[facebook/php-business-sdk

PHP SDK for Facebook Business

90821.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

74513.7M114](/packages/meilisearch-meilisearch-php)[google/gax

Google API Core for PHP

265103.1M454](/packages/google-gax)[google/common-protos

Google API Common Protos for PHP

173103.7M50](/packages/google-common-protos)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)