From 1afa57b5fe4db164b77fb35e198f4b7601a55d00 Mon Sep 17 00:00:00 2001
From: myckhel <myckhel1@hotmail.com>
Date: Fri, 20 May 2022 21:29:19 +0100
Subject: [PATCH] added `Invoice` APIs

---
 readme.md                                  |  24 ++++-
 src/Http/Controllers/InvoiceController.php |  15 +++
 src/Support/Invoice.php                    | 105 +++++++++++++++++++++
 src/routes.php                             |  12 +++
 4 files changed, 155 insertions(+), 1 deletion(-)
 create mode 100644 src/Http/Controllers/InvoiceController.php
 create mode 100644 src/Support/Invoice.php

diff --git a/readme.md b/readme.md
index 1c5398d..1f6b432 100644
--- a/readme.md
+++ b/readme.md
@@ -215,7 +215,29 @@ Page::checkSlug($slug, $params);
 Page::addProduct($page, $params);
 ```
 
-### Invoices **TODO**
+### Invoices
+```php
+use Myckhel\Paystack\Support\Invoice;
+
+Invoice::create($params);
+
+Invoice::list($params);
+
+Invoice::fetch($invoice, $params);
+
+Invoice::update($invoice, $params);
+
+Invoice::verify($code, $params);
+
+Invoice::notify($code, $params);
+
+Invoice::totals($params);
+
+Invoice::finalize($code, $params);
+
+Invoice::archive($code, $params);
+```
+
 ### Settlements **TODO**
 ### Transfer Recipients **TODO**
 ### Transfers **TODO**
diff --git a/src/Http/Controllers/InvoiceController.php b/src/Http/Controllers/InvoiceController.php
new file mode 100644
index 0000000..7715f7f
--- /dev/null
+++ b/src/Http/Controllers/InvoiceController.php
@@ -0,0 +1,15 @@
+<?php
+
+namespace Myckhel\Paystack\Http\Controllers;
+
+use Myckhel\Paystack\Support\Invoice;
+
+class InvoiceController extends Controller
+{
+  function __call($method, $args)
+  {
+    return $args
+      ? Invoice::$method($args[0], request()->all())
+      : Invoice::$method(request()->all());
+  }
+}
diff --git a/src/Support/Invoice.php b/src/Support/Invoice.php
new file mode 100644
index 0000000..007adb4
--- /dev/null
+++ b/src/Support/Invoice.php
@@ -0,0 +1,105 @@
+<?php
+
+namespace Myckhel\Paystack\Support;
+
+use Myckhel\Paystack\Traits\Request;
+
+/**
+ * The Invoices API allows you issue out and manage payment requests
+ *
+ */
+class Invoice
+{
+  use Request;
+
+  /**
+   * Create a invoice on your integration
+   *
+   * @return \Illuminate\Http\Response
+   */
+  static function create($params = [])
+  {
+    return self::post("/paymentrequest", $params);
+  }
+
+  /**
+   * List invoices available on your integration.
+   *
+   * @return \Illuminate\Http\Response
+   */
+  static function list($params = [])
+  {
+    return self::get("/paymentrequest", $params);
+  }
+
+  /**
+   * Get details of a invoice on your integration.
+   *
+   * @return \Illuminate\Http\Response
+   */
+  static function fetch($invoice, $params = [])
+  {
+    return self::get("/paymentrequest/$invoice", $params);
+  }
+
+  /**
+   * Update a invoice details on your integration
+   *
+   * @return \Illuminate\Http\Response
+   */
+  static function update($invoice, $params = [])
+  {
+    return self::put("/paymentrequest/$invoice", $params);
+  }
+
+  /**
+   * Verify details of an invoice on your integration.
+   *
+   * @return \Illuminate\Http\Response
+   */
+  static function verify($code, $params = [])
+  {
+    return self::get("/paymentrequest/verify/$code", $params);
+  }
+
+  /**
+   * Send notification of an invoice to your customers
+   *
+   * @return \Illuminate\Http\Response
+   */
+  static function notify($code, $params = [])
+  {
+    return self::post("/paymentrequest/notify/$code", $params);
+  }
+
+  /**
+   * Get invoice metrics for dashboard
+   *
+   * @return \Illuminate\Http\Response
+   */
+  static function totals($params = [])
+  {
+    return self::get("/paymentrequest/totals", $params);
+  }
+
+  /**
+   * Get invoice metrics for dashboard
+   *
+   * @return \Illuminate\Http\Response
+   */
+  static function finalize($code, $params = [])
+  {
+    return self::post("/paymentrequest/finalize/$code", $params);
+  }
+
+  /**
+   * Used to archive an invoice. Invoice will no longer
+   * be fetched on list or returned on verify.
+   *
+   * @return \Illuminate\Http\Response
+   */
+  static function archive($code, $params = [])
+  {
+    return self::post("/paymentrequest/archive/$code", $params);
+  }
+}
diff --git a/src/routes.php b/src/routes.php
index 7c1e627..aba4959 100644
--- a/src/routes.php
+++ b/src/routes.php
@@ -7,6 +7,7 @@
 use Myckhel\Paystack\Http\Controllers\TransactionController;
 use Myckhel\Paystack\Traits\PaystackConfig;
 use Myckhel\Paystack\Http\Controllers\HookController;
+use Myckhel\Paystack\Http\Controllers\InvoiceController;
 use Myckhel\Paystack\Http\Controllers\PageController;
 use Myckhel\Paystack\Http\Controllers\PlanController;
 use Myckhel\Paystack\Http\Controllers\ProductController;
@@ -89,6 +90,16 @@
     'put,page/{page}'           => 'page,update',
     'get,page/check_slug_availability/{slug}' => 'page,checkSlug',
     'post,page/{page}/product'  => 'page,addProduct',
+    // invoices
+    'post,paymentrequest'                 => 'invoice,create',
+    'get,paymentrequest'                  => 'invoice,list',
+    'get,paymentrequest/{invoice}'        => 'invoice,fetch',
+    'put,paymentrequest/{invoice}'        => 'invoice,update',
+    'get,paymentrequest/verify/{invoice_code}'    => 'invoice,verify',
+    'post,paymentrequest/notify/{invoice_code}'   => 'invoice,notify',
+    'get,paymentrequest/totals'   => 'invoice,totals',
+    'post,paymentrequest/finalize/{invoice_code}' => 'invoice,finalize',
+    'post,paymentrequest/archive/{invoice_code}'  => 'invoice,archive',
   ];
 
   $controls = [
@@ -103,6 +114,7 @@
     'subscription'    => SubscriptionController::class,
     'product'         => ProductController::class,
     'page'            => PageController::class,
+    'invoice'         => InvoiceController::class,
   ];
 
   collect($routes)->map(function ($route, $index) use ($controls) {