PHPackages hrc/nectapay - 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. [Payment Processing](/categories/payments) 4. / 5. hrc/nectapay ActiveLibrary[Payment Processing](/categories/payments) hrc/nectapay ============ Framework-agnostic PHP package for NectaPay virtual account provisioning, webhook handling, and payment processing. v2.0.1(1mo ago)04↓66.7%MITPHPPHP ^8.2 Since Apr 16Pushed 1mo agoCompare [ Source](https://github.com/HaimanResourcesConsulting/nectapay)[ Packagist](https://packagist.org/packages/hrc/nectapay)[ RSS](/packages/hrc-nectapay/feed)WikiDiscussions main Synced 1w ago READMEChangelog (1)Dependencies (1)Versions (4)Used By (0) NectaPay PHP SDK by [HRC](https://haimanresources.com) ====================================================== [](#nectapay-php-sdk-by-hrc) A framework-agnostic PHP package by [Haiman Resources Consulting](https://haimanresources.com) for NectaPay virtual account provisioning, webhook handling, and payment processing. Works with Laravel, Symfony, CodeIgniter, native PHP, and any PHP framework.. Installation ------------ [](#installation) ``` composer require hrc/nectapay ``` ### For standalone / native PHP (with Guzzle) [](#for-standalone--native-php-with-guzzle) ``` composer require hrc/nectapay guzzlehttp/guzzle ``` ### For Laravel [](#for-laravel) Laravel auto-discovers the service provider. Then publish config and migrations: ``` php artisan vendor:publish --tag=nectapay-config php artisan vendor:publish --tag=nectapay-migrations php artisan migrate ``` Configuration ------------- [](#configuration) ### Environment Variables [](#environment-variables) ``` NECTAPAY_BASE_URL=https://demo.nectapay.com/api/ NECTAPAY_API_KEY=your-api-key NECTAPAY_MERCHANT_ID=your-merchant-id NECTAPAY_WEBHOOK_SECRET=your-webhook-secret NECTAPAY_SYSTEM_FEE=200 NECTAPAY_ACCOUNT_PREFIX=MYAPP ``` --- Usage: Any PHP Framework / Native PHP ------------------------------------- [](#usage-any-php-framework--native-php) The core `NectaPayClient` is completely framework-agnostic. It depends only on simple interfaces you can implement with any HTTP client, cache, or logger. ### Quick Start [](#quick-start) ``` use HRC\NectaPay\Config; use HRC\NectaPay\NectaPayClient; use HRC\NectaPay\Http\GuzzleHttpClient; use HRC\NectaPay\Cache\InMemoryCache; // 1. Create config $config = new Config( baseUrl: 'https://demo.nectapay.com/api', apiKey: 'your-api-key', merchantId: 'your-merchant-id', webhookSecret: 'your-webhook-secret', systemFee: 200, accountPrefix: 'MYAPP', ); // Or from an array: // $config = Config::fromArray($configArray); // 2. Create client $client = new NectaPayClient( config: $config, httpClient: new GuzzleHttpClient(), cache: new InMemoryCache(), // logger: $anyPsr3Logger, // optional PSR-3 logger ); // 3. Use it // Initiate a dynamic virtual account for a single transaction $transfer = $client->initiateTransfer(1200.00, 'tx_unique_123', 'Order #123'); // Returns: account_number, bank_name, expires_in_minutes, etc. $account = $client->createStaticAccount('John Doe - MYAPP', 'myapp_owner_123'); $result = $client->verifyTransaction('TXN_123456'); $isValid = $client->validateWebhookHash($webhookPayload); ``` ### Custom HTTP Client [](#custom-http-client) Implement `HttpClientInterface` to use any HTTP library (cURL, Symfony HttpClient, etc.): ``` use HRC\NectaPay\Contracts\HttpClientInterface; class MyHttpClient implements HttpClientInterface { public function get(string $url, array $headers = []): array { // Your HTTP GET implementation return ['status' => 200, 'body' => $decodedJson]; } public function post(string $url, array $data = [], array $headers = []): array { // Your HTTP POST implementation return ['status' => 200, 'body' => $decodedJson]; } } ``` ### Custom Cache [](#custom-cache) Implement `CacheInterface` to use Redis, Memcached, file cache, or any backend: ``` use HRC\NectaPay\Contracts\CacheInterface; class RedisCacheAdapter implements CacheInterface { public function get(string $key): ?string { /* ... */ } public function set(string $key, string $value, int $ttlSeconds): void { /* ... */ } public function forget(string $key): void { /* ... */ } } ``` ### Webhook Validation (Any Framework) [](#webhook-validation-any-framework) ``` // In your webhook endpoint handler: $payload = json_decode(file_get_contents('php://input'), true); if ($client->validateWebhookHash($payload)) { // Process the payment... $data = $payload['data'] ?? $payload; $accountNumber = $data['AccountNumber']; $amountPaid = (float) $data['AmountPaid']; $transactionId = $data['TransactionId']; } ``` ### Payment Handler (Generic) [](#payment-handler-generic) Implement `PaymentHandlerInterface` for framework-agnostic payment processing: ``` use HRC\NectaPay\Contracts\PaymentHandlerInterface; class MyPaymentHandler implements PaymentHandlerInterface { public function handlePayment(string $ownerId, float $amount, array $metadata): mixed { // Record payment in your database, generate receipt, etc. return $paymentRecord; } } ``` --- Usage: Laravel -------------- [](#usage-laravel) Laravel users get auto-wired services, Eloquent models, queued jobs, Facade, and artisan commands out of the box. ### Laravel Configuration [](#laravel-configuration) Add to your `.env`: ``` NECTAPAY_BASE_URL=https://demo.nectapay.com/api/ NECTAPAY_API_KEY=your-api-key NECTAPAY_MERCHANT_ID=your-merchant-id NECTAPAY_WEBHOOK_SECRET=your-webhook-secret NECTAPAY_SYSTEM_FEE=200 NECTAPAY_ACCOUNT_PREFIX=MYAPP NECTAPAY_OWNER_MODEL=App\Models\Student NECTAPAY_OWNER_ID_ATTRIBUTE=student_id ``` ### Owner Model Requirements [](#owner-model-requirements) The owner model (student, customer, user, etc.) must have: - A UUID primary key (`id`) - A `name` accessor or attribute - Optionally, a unique identifier attribute (configured via `NECTAPAY_OWNER_ID_ATTRIBUTE`) - A `virtualAccount` relationship (add this to your model): ``` public function virtualAccount() { return $this->hasOne(\HRC\NectaPay\Laravel\Models\VirtualAccount::class, 'owner_id'); } ``` ### Webhook CSRF Exemption [](#webhook-csrf-exemption) Exclude the webhook path from CSRF verification in your `bootstrap/app.php`: ``` ->withMiddleware(function (Middleware $middleware) { $middleware->validateCsrfTokens(except: [ 'webhook/nectapay', ]); }) ``` ### Laravel Payment Handler [](#laravel-payment-handler) Implement the Laravel-specific `PaymentHandler` contract: ``` use HRC\NectaPay\Laravel\Contracts\PaymentHandler; use Illuminate\Database\Eloquent\Model; class MyPaymentHandler implements PaymentHandler { public function handleWebhookPayment(Model $owner, float $amount, array $metadata): ?Model { // Record payment, allocate to invoices, generate receipt, etc. return $payment; } } ``` Set it in your `.env`: ``` NECTAPAY_PAYMENT_HANDLER=App\Services\MyPaymentHandler ``` ### Provision a Single Account (Laravel) [](#provision-a-single-account-laravel) ``` use HRC\NectaPay\Laravel\Facades\NectaPay; $account = NectaPay::createStaticAccount($owner); ``` ### Dispatch Async Job (Laravel) [](#dispatch-async-job-laravel) ``` use HRC\NectaPay\Laravel\Jobs\CreateVirtualAccountJob; CreateVirtualAccountJob::dispatch($owner); ``` ### Artisan Command [](#artisan-command) ``` # Provision for a specific owner php artisan nectapay:provision-accounts --owner=000100500 # Batch provision all active owners without accounts php artisan nectapay:provision-accounts # Dry run php artisan nectapay:provision-accounts --dry-run ``` ### Initiate a Dynamic Transfer (Laravel) [](#initiate-a-dynamic-transfer-laravel) ``` $transfer = NectaPay::initiateTransfer(1200.00, 'tx_unique_123', 'Order #123'); // $transfer['account_number'] — temporary account to pay into // $transfer['bank_name'] — bank name // $transfer['expires_in_minutes'] — time before the account expires ``` ### Verify a Transaction (Laravel) [](#verify-a-transaction-laravel) ``` $result = NectaPay::verifyTransaction($transactionId); ``` --- Architecture ------------ [](#architecture) The package is split into a **framework-agnostic core** and **framework-specific adapters**: ``` src/ ├── Config.php ← Configuration value object ├── NectaPayClient.php ← Core API client (no framework deps) ├── Contracts/ │ ├── HttpClientInterface.php ← HTTP abstraction │ ├── CacheInterface.php ← Cache abstraction │ ├── PaymentHandlerInterface.php ← Generic payment handler │ └── OwnerInterface.php ← Owner model contract ├── DTOs/ │ ├── VirtualAccountData.php ← Virtual account data transfer object │ └── WebhookResult.php ← Webhook processing result ├── Http/ │ └── GuzzleHttpClient.php ← Guzzle HTTP implementation ├── Cache/ │ └── InMemoryCache.php ← Simple in-memory cache ├── Exceptions/ │ └── NectaPayException.php ← Framework-agnostic exceptions └── Laravel/ ← Laravel-specific adapter ├── NectaPayServiceProvider.php ├── NectaPayService.php ← Eloquent-aware service wrapper ├── Facades/NectaPay.php ├── Contracts/PaymentHandler.php ├── Models/ │ ├── VirtualAccount.php │ └── WebhookLog.php ├── Console/ProvisionVirtualAccountsCommand.php ├── Http/ │ ├── LaravelHttpClient.php │ └── Controllers/NectaPayWebhookController.php ├── Jobs/CreateVirtualAccountJob.php ├── Cache/LaravelCacheAdapter.php └── Exceptions/WebhookEarlyExitException.php ``` ### Core Dependencies [](#core-dependencies) InterfacePurposeBundled Implementations`HttpClientInterface`HTTP requests`GuzzleHttpClient`, `LaravelHttpClient``CacheInterface`Auth token caching`InMemoryCache`, `LaravelCacheAdapter``PSR-3 LoggerInterface`Logging (optional)Any PSR-3 logger ### Health Score 39 — LowBetter than 84% of packages Maintenance89 Actively maintained with recent releases Popularity5 Limited adoption so far Community6 Small or concentrated contributor base Maturity48 Maturing project, gaining track record 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. ### Release Activity Cadence Every ~0 days Total 2 Last Release 54d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/8198431?v=4)[\_\_hemmy](/maintainers/haiman4real)[@haiman4real](https://github.com/haiman4real) --- Top Contributors [![haiman4real](https://avatars.githubusercontent.com/u/8198431?v=4)](https://github.com/haiman4real "haiman4real (9 commits)") ### Embed Badge ![Health badge](/badges/hrc-nectapay/health.svg) ``` [![Health](https://phpackages.com/badges/hrc-nectapay/health.svg)](https://phpackages.com/packages/hrc-nectapay) ``` ### Alternatives [symfony/cache Provides extended PSR-6, PSR-16 (and tags) implementations 4.2k365.0M3.1k](/packages/symfony-cache)[matomo/matomo Matomo is the leading Free/Libre open analytics platform 21.6k38.2k](/packages/matomo-matomo)[tempest/framework The PHP framework that gets out of your way. 2.2k31.1k11](/packages/tempest-framework)[recurly/recurly-client The PHP client library for the Recurly API 1746.5M8](/packages/recurly-recurly-client)[api-platform/metadata API Resource-oriented metadata attributes and factories 244.5M180](/packages/api-platform-metadata)[vipps/module-payment Vipps MobilePay Payment Module for Magento 2 1097.3k](/packages/vipps-module-payment) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)