From 7541a0d429635310883d47f218ff89a11349fd2a Mon Sep 17 00:00:00 2001
From: myckhel <myckhel1@hotmail.com>
Date: Sat, 21 May 2022 01:45:38 +0100
Subject: [PATCH] created `Recipient` APIs

---
 readme.md                                    | 18 ++++-
 src/Http/Controllers/RecipientController.php | 15 ++++
 src/Support/Recipient.php                    | 77 ++++++++++++++++++++
 src/routes.php                               |  9 +++
 4 files changed, 118 insertions(+), 1 deletion(-)
 create mode 100644 src/Http/Controllers/RecipientController.php
 create mode 100644 src/Support/Recipient.php

diff --git a/readme.md b/readme.md
index d5c396c..d64d260 100644
--- a/readme.md
+++ b/readme.md
@@ -247,7 +247,23 @@ Settlement::list($params);
 Settlement::transactions($settlement, $params);
 ```
 
-### Transfer Recipients **TODO**
+### Transfer Recipients
+```php
+use Myckhel\Paystack\Support\Recipient;
+
+Recipient::create($params);
+
+Recipient::bulkCreate($params);
+
+Recipient::list($params);
+
+Recipient::fetch($recipient, $params);
+
+Recipient::update($recipient, $params);
+
+Recipient::remove($recipient, $params);
+```
+
 ### Transfers **TODO**
 ### Transfers Control **TODO**
 ### Bulk Charges **TODO**
diff --git a/src/Http/Controllers/RecipientController.php b/src/Http/Controllers/RecipientController.php
new file mode 100644
index 0000000..eaf2714
--- /dev/null
+++ b/src/Http/Controllers/RecipientController.php
@@ -0,0 +1,15 @@
+<?php
+
+namespace Myckhel\Paystack\Http\Controllers;
+
+use Myckhel\Paystack\Support\Recipient;
+
+class RecipientController extends Controller
+{
+  function __call($method, $args)
+  {
+    return $args
+      ? Recipient::$method($args[0], request()->all())
+      : Recipient::$method(request()->all());
+  }
+}
diff --git a/src/Support/Recipient.php b/src/Support/Recipient.php
new file mode 100644
index 0000000..56b3406
--- /dev/null
+++ b/src/Support/Recipient.php
@@ -0,0 +1,77 @@
+<?php
+
+namespace Myckhel\Paystack\Support;
+
+use Myckhel\Paystack\Traits\Request;
+
+/**
+ * The Transfer Recipients API allows you create
+ * and manage beneficiaries that you send money to
+ *
+ */
+class Recipient
+{
+  use Request;
+
+  /**
+   * Creates a new recipient. A duplicate account number
+   * will lead to the retrieval of the existing record.
+   *
+   * @return \Illuminate\Http\Response
+   */
+  static function create($params = [])
+  {
+    return self::post("/transferrecipient", $params);
+  }
+
+  /**
+   * Create multiple transfer recipients in batches.
+   * A duplicate account number will lead to the retrieval of the existing record.
+   *
+   * @return \Illuminate\Http\Response
+   */
+  static function bulkCreate($params = [])
+  {
+    return self::post("/transferrecipient", $params);
+  }
+
+  /**
+   * List transfer recipients available on your integration.
+   *
+   * @return \Illuminate\Http\Response
+   */
+  static function list($params = [])
+  {
+    return self::get("/transferrecipient", $params);
+  }
+
+  /**
+   * Get details of a transfer recipients on your integration.
+   *
+   * @return \Illuminate\Http\Response
+   */
+  static function fetch($recipient, $params = [])
+  {
+    return self::get("/transferrecipient/$recipient", $params);
+  }
+
+  /**
+   * Update a transfer recipients details on your integration
+   *
+   * @return \Illuminate\Http\Response
+   */
+  static function update($recipient, $params = [])
+  {
+    return self::put("/transferrecipient/$recipient", $params);
+  }
+
+  /**
+   * Deletes a transfer recipient (sets the transfer recipient to inactive)
+   *
+   * @return \Illuminate\Http\Response
+   */
+  static function remove($recipient, $params = [])
+  {
+    return self::delete("/transferrecipient/$recipient", $params);
+  }
+}
diff --git a/src/routes.php b/src/routes.php
index b051ada..f06807e 100644
--- a/src/routes.php
+++ b/src/routes.php
@@ -11,6 +11,7 @@
 use Myckhel\Paystack\Http\Controllers\PageController;
 use Myckhel\Paystack\Http\Controllers\PlanController;
 use Myckhel\Paystack\Http\Controllers\ProductController;
+use Myckhel\Paystack\Http\Controllers\RecipientController;
 use Myckhel\Paystack\Http\Controllers\SettlementController;
 use Myckhel\Paystack\Http\Controllers\SubAccountController;
 use Myckhel\Paystack\Http\Controllers\SplitController;
@@ -104,6 +105,13 @@
     // settlements
     'get,settlement'    => 'settlement,list',
     'get,settlement/{settlement}/transactions'    => 'settlement,transactions',
+    // transferrecipients
+    'post,transferrecipient'                 => 'transferrecipt,create',
+    'post,transferrecipient/bulk'            => 'transferrecipt,bulkCreate',
+    'get,transferrecipient'                  => 'transferrecipt,list',
+    'get,transferrecipient/{transferrecipient}'     => 'transferrecipt,fetch',
+    'put,transferrecipient/{transferrecipient}'     => 'transferrecipt,update',
+    'delete,transferrecipient/{transferrecipient}'  => 'transferrecipt,remove',
   ];
 
   $controls = [
@@ -120,6 +128,7 @@
     'page'            => PageController::class,
     'invoice'         => InvoiceController::class,
     'settlement'      => SettlementController::class,
+    'transferrecipt'  => RecipientController::class,
   ];
 
   collect($routes)->map(function ($route, $index) use ($controls) {