Download the PHP package monnify/monnify-laravel without Composer
On this page you can find all versions of the php package monnify/monnify-laravel. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download monnify/monnify-laravel
More information about monnify/monnify-laravel
Files in monnify/monnify-laravel
Package monnify-laravel
Short Description A Laravel Monnify Package
License MIT
Homepage https://github.com/fredneutron/monnify-laravel
Informations about the package monnify-laravel
Laravel Monnify Package Documentation
A Laravel package to effortlessly integrate the Monnify payment gateway API into your Laravel projects.
Installation
Install via Composer:
Publish the configuration file:
Add environment variables (.env
):
Quick Start
Here's how to quickly initialize a payment transaction:
This package throws exceptions for various error cases. Hence, wrapping your API calls in try-catch blocks.
Available Services
This package provides the following services:
- Transaction Service: Manage payments, authorizations, and statuses.
- Customer Reserved Account Service: Create/manage virtual accounts.
- Invoice Service: Generate and manage invoices.
- Disbursement Service: Manage single and bulk fund transfers.
- Wallet Service: Manage wallet creation, balances, and transactions.
- Verification Service: Perform account, BVN, NIN verifications.
- Sub Account Service: Create/manage sub-accounts for split payments.
- Refund Service: Handle payment refunds.
- Settlement Service: Settlement transaction handling.
- Limit Profile Service: Manage transaction limits.
- Pay Code Service: Generate and manage pay codes.
- Direct Debit Service: Manage direct debit mandates.
- Recurring Payment Service: Automate recurring payments.
- Helper Service: Utility functions (fetch banks, etc).
Detailed Usage
Transaction Service
The Transaction Service handles all payment-related operations.
All Available Methods
Transaction Initialization
Required fields: amount
, customerName
, customerEmail
, paymentReference
, currencyCode
, contractCode
, redirectUrl
.
Optional fields: paymentMethods
, incomeSplitConfig
.
Pay with Bank Transfer
Initializes a bank transfer payment.
Required Parameters:
Charge Card
Process a card payment.
Required Parameters:
Authorize with OTP
Required Parameters:
Authorize 3D secure card
Required Parameters:
Get Transaction Status
Parameters:
$transactionReference
(string): The transaction reference to check
Get Status by Reference
Check transaction status using different reference types.
Parameters:
$reference
(string): The reference number$referenceType
(string): Either 'transaction' or 'payment' (default: 'transaction')
Customer Reserved Account Service
Manages reserved account operations.
All Available Methods
Create General Account
Creates a new reserved general account.
Required Parameters:
Optional Parameters:
Create Invoice Account
Creates a new reserved invoice account.
Required Parameters:
Optional Parameters:
Get Account Details
Get the full reserved account detail.
Parameters:
$accountReference
(string): The reference of the main account
Add Linked Accounts
Add additional accounts to a reserved account.
Parameters:
$accountReference
(string): The reference of the main account$data
(array): Linked accounts configuration
Deallocate Account
Parameters:
$accountReference
(string): The reference of the main account
Update the BVN for a reserved account.
Parameters:
$accountReference
(string): Account reference$bvn
(string): Bank Verification Number
Update the KYC Info for a reserved account.
Parameters:
$accountReference
(string): Account reference$data
(array): KYC info (BVN, NIN or both)
Allowed Payment Source
Parameters:
$accountReference
(string): Account reference$data
(array): payment source setttings
Update Split Config for a reserved account.
Parameters:
$accountReference
(string): Account reference$data
(array): split configs
Get Account Transactions
Parameters:
$accountReference
(string): Account reference$parameters
(array): Optional parameters
Invoice Service
Manage invoice creation and operations.
All Available Methods
Create a new Invoice
Required Parameters:
Get Invoice Details
Retrieve details of a specific invoice.
Parameters:
$invoiceReference
(string): The invoice reference to retrieve
Retrieve all invoices.
Cancel an existing invoice.
Parameters:
$invoiceReference
(string): The invoice reference to cancel
Attach a reserved account to an existing invoice.
Required Parameters:
Optional Parameters:
Disbursement Service
Handles money transfers and disbursements.
All Available Methods
Single Transfer
Process a single money transfer.
Required Parameters:
Optional Parameters:
$async
(boolean): Whether to process transfer asynchronously (default: false)
Bulk Transfer
Process multiple transfers at once.
Required Parameters:
Authorize a transfer with OTP.
Required Parameters:
Check Transfer Status
Get Transaction
Other Operations
Parameters:
$accountNumber
(string): Wallet account Number$reference
(string): transaction reference$type
(string): type of transaction (single
orbulk
)$pageSize
(integer): Number of records per page (default: 10)$pageNumber
(integer): Page number (default: 0)
Wallet Service
Manages wallet operations.
All Available Methods
Create Wallet
Required Parameters:
Get Wallet Details
Parameters:
$customerEmail
(string): Customer's email address$pageSize
(integer): Number of records per page (default: 10)$pageNumber
(integer): Page number (default: 0)
Check Wallet Balance
Parameters:
$accountNumber
(string): Wallet account number
Get Wallet transactions
Parameters:
$accountNumber
(string): Wallet account number$pageSize
(integer): Number of records per page (default: 10)$pageNumber
(integer): Page number (default: 0)
Verification Service
All Available Methods
Verify Bank Account
Required Parameters:
$accountNumber
(string): Account number to verify$bankCode
(string): Bank code
Verify BVN Information
Required Parameters:
Match BVN with Bank Account
Required Parameters:
$bvn
(string): BVN to match$bankCode
(string): Bank code$accountNumber
(string): Account number
Verify NIN
Sub Account Service
Manages sub-accounts for split payments.
All Available Methods
Create Sub Account
Creates a new sub-account for split payments.
Required Parameters:
Get All Sub Accounts
Retrieves all sub-accounts associated with your contract.
Update Sub Account
Updates an existing sub-account's details.
Required Parameters:
Delete Sub Account
Removes a sub-account from your contract.
Required Parameters:
$subAccountCode
(string): The unique code of the sub-account to delete
Refund Service
All Available Methods
Initialize Refund
Creates a new refund request.
Required Parameters:
Get Refund Status
Check the status of a specific refund.
Parameters:
$refundReference
(string): Refund reference to check
Get All Refunds
Retrieves all refunds with pagination.
Optional Parameters:
$pageSize
(integer): Number of records per page (default: 10)$pageNumber
(integer): Page number (default: 0)
Settlement Service
Manages settlement information and transactions.
All Available Methods
Get Settlement Transactions
Retrieves transactions for a specific settlement.
Required Parameters:
$settlementReference
(string): Settlement reference to query
Optional Parameters:
Get Settlement by Transaction
Retrieves settlement details for a specific transaction.
Required Parameters:
$transactionReference
(string): Transaction reference to query
Limit Profile Service
Manages transaction limits.
All Available Methods
Get All Limit Profiles
Create Limit Profile
Required Parameters:
Update Limit Profile
Parameters:
$limitProfileCode
(string): Profile code to update$data
(array): New limit settings (same structure as create)
Reserve Account with Limit
Creates a reserved account with specific limits.
Required Parameters:
Update Reserved Account with Limit Profile
Pay Code Service
Manages payment codes.
All Available Methods
Create Pay Code
Required Parameters:
Get Pay Code Details
Retrieve the full detail of a payment code
Get Pay Code Details with Pay Code Unmasked
Retrieve the full detail of a payment code Unmasked
Get Pay Code History
Retrieves history of payment codes.
Parameters:
Delete a payment code
Direct Debit Service
Manages direct debit mandates.
All Available Methods
Create Mandate
Required Parameters:
Optional Parameters:
Get Mandate Details
Get full detail of a mandate payment.
Required Parameters:
$mandateReference
(string): Mandate reference
Debit Mandate
Executes a debit on an existing mandate.
Required Parameters:
Get Mandate Status
Checks the status of a mandate payment.
Required Parameters:
$paymentReference
(string): Payment reference to check
Cancel Mandate Payment
Required Parameters:
$mandateCode
(string): Mandate code
Recurring Payment Service
All Available Methods
Charge Card Token
Required Parameters:
Optional Parameters:
Other / Helper Service
Provides utility functions.
All Available Methods
Error Handling
Wrap API calls in try-catch blocks to handle exceptions efficiently:
Testing
Run package tests with:
Contributing
- Fork repository
- Create feature/fix branch
- Submit Pull Request
Credits
License
This package is licensed under the MIT License.
Support
For any support or security issues, please contact [email protected].
All versions of monnify-laravel with dependencies
guzzlehttp/guzzle Version ^7.0
illuminate/support Version ^8.0|^9.0|^10.0|^11.0|^12.0
illuminate/validation Version ^8.0|^9.0|^10.0|^11.0|^12.0