Download the PHP package kommandhub/paystack without Composer
On this page you can find all versions of the php package kommandhub/paystack. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package paystack
Paystack PHP Library
A framework-agnostic PHP library for integrating Paystack payments using SOLID principles and PSR standards. It provides a clean, object-oriented interface to the Paystack API and works in any PHP environment.
Table of Contents
- Requirements
- Installation
- Quick Start
- Initialization
- Using Guzzle and Nyholm PSR-7
- Bringing Your Own HTTP Client
- Response Structure
- Error Handling
- Resources
- Transactions
- Customers
- Transfers
- Subscriptions
- Plans
- Splits
- Subaccounts
- Refunds
- Verification
- Settlements
- Miscellaneous
- Webhook Handling
- Testing
- Development (Docker)
- Code Quality
- Contributing
- License
Requirements
- PHP 8.1 or higher
- A PSR-18 HTTP client (e.g.
guzzlehttp/guzzle,symfony/http-client) - PSR-17 HTTP factory (e.g.
nyholm/psr7,guzzlehttp/psr7)
Installation
If you don't already have a PSR-18 client and PSR-17 factory, install popular ones:
Quick Start
Initialization
Using Guzzle and Nyholm PSR-7
Bringing Your Own HTTP Client
Implement Kommandhub\Paystack\Contracts\HttpClientInterface to wrap any HTTP layer you prefer, then pass it directly:
Response Structure
Every resource method returns an associative array that mirrors the Paystack API JSON response:
Always check $response['status'] before consuming $response['data'].
Error Handling
All resource methods throw Kommandhub\Paystack\Exceptions\PaystackException on HTTP or API errors. Wrap calls in a try/catch block:
Resources
Transactions
Handle payment initialization, verification, and retrieval.
Customers
Manage your customer database.
Transfers
Send money to customers or vendors.
Subscriptions
Manage recurring payments.
Plans
Create and manage payment plans for subscriptions.
Splits
Split payments between multiple subaccounts.
Subaccounts
Manage subaccounts for split payments and marketplace settlements.
Refunds
Process full or partial refunds for transactions.
Verification
Verify customer account and card information.
Settlements
Retrieve settlement reports and their associated transactions.
Miscellaneous
Access supporting reference data from the Paystack API.
Webhook Handling
Paystack sends webhook events to your endpoint for asynchronous notifications. Always validate the signature before processing:
Tip: Respond with HTTP
200as quickly as possible and process webhook payloads asynchronously (e.g. via a queue) to avoid timeouts.
Testing
Development (Docker)
This project includes a Docker environment for easy development.
Requirements
- Docker
- Docker Compose
Getting Started
| Command | Description |
|---|---|
make build |
Build and start the container |
make shell |
Open a shell inside container |
make test |
Run the test suite |
make lint |
Run static analysis (PHPStan) |
make format |
Fix code style (PHP CS Fixer) |
make down |
Stop and remove containers |
Or use docker-compose directly:
Code Quality
| Tool | Command | Purpose |
|---|---|---|
| PHPStan | composer lint |
Static analysis |
| PHP CS Fixer | composer format |
Code style enforcement |
Please ensure both pass before submitting a pull request.
Contributing
Please see CONTRIBUTING for details.
License
The MIT License (MIT). Please see the License File for more information.
All versions of paystack with dependencies
psr/http-client Version ^1.0
psr/http-factory Version ^1.0
psr/http-message Version ^1.0 || ^2.0