A Laravel package to make single and bulk transfers with Paystack.
PHP 8.2+ and Composer are required.
Compatible with Laravel 9, 10, 11.
-
Install the package via composer:
composer require codejutsu1/laravel-paystack-transfer
-
Optional
you can publish the config file via this command:php artisan paystack-transfer:install
A configuration file named
paystack-transfer.php
will be placed in theconfig
folder of your laravel application:<?php // config for Codejutsu1/LaravelPaystackTransfer return [ /** * Public Key From Paystack Dashboard * */ 'public_key' => env('PAYSTACK_PUBLIC_KEY'), /** * Secret Key From Paystack Dashboard * */ 'secret_key' => getenv('PAYSTACK_SECRET_KEY'), ];
Open your .env
file and add your public and secret API keys.
PAYSTACK_PUBLIC_KEY=
PAYSTACK_SECRET_KEY=
- Transfer Recipient
- Banks
- Transfers
- Single Transfers
- Finalize a Transfer (When OTP is enabled for single Transfers)
- Bulk Transfers
- List Transfers
- Fetch a Transfer
- Verify a Transfer
- To make a transfer, either single or in bulk using this package, you need to provide an array of four parameters:
- amount - Amount to be sent.
- reference (Transfer Reference) - A unique identifier which will be used to track your transactions. This package provides a helper function,
generateTransferReference()
, which returns a UUID you can use as a unique reference. - recipient (Transfer Recipient) - A transfer recipient is a beneficiary that you can send money to. To create a transfer recipient, you need to collect their details first.
- reason - Reason for the transfer.
- currency - (Optional)
NGN
by default but you can specify your currency.
<?php
$transfers = [
"amount": "37800",
"reference": "your-unique-reference",
"recipient": "RCP_t0ya41mp35flk40",
"reason": "Holiday Flexing"
];
- Each request returns a response as an object containing:
- status (boolean)
- message (string)
- data (array)
- meta (array)
To create a single transfer recipient:
<?php
$data = [
"type" => "nuban", //Recipient type, either nuban, ghipps, mobile_money or bass
"name" => "Daniel Dunu", //Recipient name
"account_number" => "01000000010", // Recipient Account Number
"bank_code" => "058", // Recipient bank code
"currency" => "NGN", // Recipient Currency
];
try{
$response = PaystackTransfer::createTransferRecipient($data);
}catch(\Exception $e){
return redirect()->back()->withMessage($e->getMessage());
}
if($response->status){
// Your code Logic
}
Important
Store the recipient_code in your database alongside the recipient. For more information, visit Paystack Create Transfer Recipient.
You can create multiple transfer recipient no matter the number of batches. To create multiple transfer recipient:
<?php
$data = [
[
"type" => "nuban", //Recipient type, either nuban, ghipps, mobile_money or bass
"name" => "Daniel Dunu", //Recipient name
"account_number" => "01000000010", // Recipient Account Number
"bank_code" => "058", // Recipient bank code
"currency" => "NGN", // Recipient Currency
],
[
"type" => "ghipps", //Recipient type, either nuban, ghipps, mobile_money or bass
"name" => "John Doe", //Recipient name
"account_number" => "02000000020", // Recipient Account Number
"bank_code" => "018", // Recipient bank code
"currency" => "NGN", // Recipient Currency
],
];
try{
$response = PaystackTransfer::bulkTransferRecipient($data);
}catch(\Exception $e){
return redirect()->back()->withMessage($e->getMessage());
}
if($response->status){
// Your code Logic
}
Note
For more information, visit Paystack Bulk Create Transfer Recipient
To list all transfer recipients:
<?php
try{
$response = PaystackTransfer::listTransferRecipients();
}catch(\Exception $e){
return redirect()->back()->withMessage($e->getMessage());
}
if($response->status){
// Eg of code logic
$transferRecipients = collect($response->data);
return $transferRecipients;
}
You can also provide query parameters as an array:
<?php
$queryParameters = [
"perPage" => 30, //Integer(optional), Records per page.
"page" => 2, //Integer(optional), exact page to retrieve.
"from" => "2016-09-24T00:00:05.000Z", //dateTime(optional), Timestamp to start listing transfer recipient.
"to" => "2016-09-24T00:00:05.000Z", //dateTime(optional), Timestamp to stop listing transfer recipient
];
try{
$response = PaystackTransfer::listTransferRecipients($queryParameters);
}catch(\Exception $e){
return redirect()->back()->withMessage($e->getMessage());
}
return $response;
Note
For more information, visit Paystack List Transfer Recipients.
To fetch a transfer recipient, you need to provide the id or recipient code of the recipient:
<?php
try{
$response = PaystackTransfer::fetchTransferRecipient("RCP_2x5j67tnnw1t98k");
}catch(\Exception $e){
return redirect()->back()->withMessage($e->getMessage());
}
if($response->status){
// Your code logic here
}
Note
For more information, visit Paystack Fetch Transfer Recipient.
To update a transfer recipient details, you need to provide the id or recipient code of the recipient alongside the details to be updated (name and/or email):
<?php
$data = [
'email' => 'danieldunu001@gmail.com'
];
try{
$response = transfer()->updateTransferRecipient("RCP_2x5j67tnnw1t98k", $data);
}catch(\Exception $e){
return redirect()->back()->withMessage($e->getMessage());
}
if($response->status){
// Your code logic here
}
Note
For more information, visit Paystack Update Transfer Recipient.
To delete a transfer recipient, you need to provide the id or recipient code of the recipient:
<?php
try{
$response = transfer()->deleteTransferRecipient("RCP_2x5j67tnnw1t98k");
}catch(\Exception $e){
return redirect()->back()->withMessage($e->getMessage());
}
if($response->status){
// Your code logic here
}
Note
For more information, visit Paystack Delete Transfer Recipient.
To get lists of banks in Nigeria:
<?php
try{
$response = transfer()->getBanks();
}catch(\Exception $e){
return redirect()->back()->withMessage($e->getMessage());
}
if($response->status){
$banks = collect($response->data); // To a collection.
// Your logic
}
You can also provide query parameters as an array:
<?php
$queryParameters = [
"country" => "ghana", //String(Optional), nigeria or ghana, default is nigeria
"perPage" => 50, //Integer(optional), Records per page.
//Other query parameters in the documentation.
];
try{
$response = transfer()->getBanks($queryParameters);
}catch(\Exception $e){
return redirect()->back()->withMessage($e->getMessage());
}
return $response;
Note
For more information, visit Paystack List Banks API.
To get a bank code, you need to provide the bank name from the get bank API:
<?php
try{
$code = transfer()->getBankCode("United Bank For Africa");
}catch(\Exception $e){
return redirect()->back()->withMessage($e->getMessage());
}
return $code;
To confirm the account belongs to the right customer, you need to provide the account number and the bank code of the customer as both strings:
<?php
try{
$response = PaystackTransfer::verifyAccountNumber(accountNumber:"2134288420", bankCode:"022");
}catch(\Exception $e){
return redirect()->back()->withMessage($e->getMessage());
}
if($response->status){
//Your logic
}
Note
For more information, visit Paystack Resolve Account.
To make a single transfers, you need these provide four parameters as an array:
- reason
- amount
- reference
- recipient
The currency
is NGN
by default. You can override the default currency by adding it to the array. For the source
, we took care of that by merging the array with a value of balance
.
<?php
$parameters = [
"reason": "Savings",
"amount": 300000, //NGN3000, converted to kobo.
"reference": "your-unique-reference",
"recipient": "RCP_1a25w1h3n0xctjg"
];
try{
$response = PaystackTransfer::singleTransfer($parameters);
}catch(\Exception $e){
return redirect()->back()->withMessage($e->getMessage());
}
if($response->status){
//Your code logic
}
Note
For more information, visit Paystack Single Transfers.
After making a single transfer with OTP enabled
, you will have to finalized your transfer by providing the OTP
and the transfer code
as both strings:
<?php
try{
$response = transfer()->finalizeTransfer(transfer_code:"TRF_vsyqdmlzble3uii", otp: "930322");
}catch(\Exception $e){
return redirect()->back()->withMessage($e->getMessage());
}
if($response->status){
//Your logic
}
Note
For more information, visit Paystack Finalize Transfers.
To send money to multiple recipients, you need to make request in batches
. A batch
is an array of arrays containing the transfer parameters. A batch
should not contain more than 100 arrays
.
<?php
$transfers = [
[
"amount"=> 20000,
"reference"=> "588YtfftReF355894J",
"reason"=> "Why not?",
"recipient"=> "RCP_2tn9clt23s7qr28",
],
[
"amount"=> 30000,
"reference"=> "YunoTReF35e0r4J",
"reason"=> "Because I can",
"recipient"=> "RCP_1a25w1h3n0xctjg",
],
[
"amount"=> 40000,
"reference"=> generateTransferReference(),
"reason"=> "Go buy your mama a house",
"recipient"=> "RCP_aps2aibr69caua7",
]
];
try{
$response = PaystackTransfer::bulkTransfer($transfers);
}catch(\Exception $e){
return redirect()->back()->withMessage($e->getMessage());
}
if($response->status){
//Your logic
}
If the batch should contain more than 100 arrays, it should be broken down into batches, each containing 100 arrays and each batch should be sent every 5 seconds
.
But you don't have to worry about that, just pass the batch (even if its contains more than 100 arrays) as a parameter in the batchTransfer
method. This package will proceed to break it down into batches, each containing not more than 100 arrays and will make a request every 5 seconds.
Note
It will return an array of response instead of an object for each request being made.
<?php
$transfers = [
[
"amount"=> 20000,
"reference"=> "588YtfftReF355894J",
"reason"=> "Why not?",
"recipient"=> "RCP_2tn9clt23s7qr28",
],
[
"amount"=> 30000,
"reference"=> "YunoTReF35e0r4J",
"reason"=> "Because I can",
"recipient"=> "RCP_1a25w1h3n0xctjg",
],
[
"amount"=> 40000,
"reference"=> generateTransferReference(),
"reason"=> "Go buy your mama a house",
"recipient"=> "RCP_aps2aibr69caua7",
],
//.... > 97 more arrays
];
try{
$response = PaystackTransfer::batchTransfer($transfers);
}catch(\Exception $e){
return redirect()->back()->withMessage($e->getMessage());
}
if($response->status){
//Your logic
}
Note
You need to set up webhooks to keep track of your transfers. For more information, visit Paystack Bulk Transfers.
Paystack gives you the option to get the list of all your transfers:
<?php
try{
$response = PaystackTransfer::listTransfers();
}catch(\Exception $e){
return redirect()->back()->withMessage($e->getMessage());
}
if($response->status){
//Your logic
}
You can also provide query parameters as an array:
$queryParameters = [
"perPage" => 30, //Integer(optional), Records per page.
"page" => 2, //Integer(optional), exact page to retrieve.
"customer" => "12121", //String(optional), filter by id.
"from" => "2016-09-24T00:00:05.000Z", //dateTime(optional), Timestamp to start listing transfer recipient.
"to" => "2016-09-24T00:00:05.000Z", //dateTime(optional), Timestamp to stop listing transfer recipient
];
try{
$response = PaystackTransfer::listTransfers($queryParameters);
}catch(\Exception $e){
return redirect()->back()->withMessage($e->getMessage());
}
return $response;
Note
For more information, visit Paystack List Transfers.
Get details of a transfer. You need to provide transfer id.
<?php
try{
$response = PaystackTransfer::fetchTransfer("14938");
}catch(\Exception $e){
return redirect()->back()->withMessage($e->getMessage());
}
if($response->status){
//Your logic
}
Note
For more information, visit Paystack Fetch Transfers.
Verify the status of a transfer. You need to provide transfer reference.
try{
$response = PaystackTransfer::verifyTransfer("your_reference");
}catch(\Exception $e){
return redirect()->back()->withMessage($e->getMessage());
}
if($response->status){
//Your code logic
}
Note
For more information, visit Paystack Verify Transfers.
composer test
Please see CHANGELOG for more information on what has changed recently.
Feel free to submit Issues (for bugs or suggestions) and Pull Requests(to the dev branch).
If you discover a security vulnerability within this package, please send an email to Daniel Dunu at danieldunu001@gmail.com. All security vulnerabilities will be promptly addressed..
- Write test for integrating third party APIs.
- If your business is a
registered business
, test the transfer feature with your test API Keys and give feedbacks.
The MIT License (MIT). Please see License File for more information.