README

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

Requirements

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

Installation

composer require novapay/business-sdk

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

Authentication

Data

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

$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

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