created Miscellaneous APIs (#34)

Author: myckhel

readme.md

@@ -391,7 +391,18 @@ Verification::validateAccount($params);
 Verification::resolveCardBIN($bin, $params);
 ```
 
-### Miscellaneous **TODO**
+### Miscellaneous
+```php
+use Myckhel\Paystack\Support\Miscellaneous;
+
+Miscellaneous::listBanks($params);
+
+Miscellaneous::listProviders($params);
+
+Miscellaneous::listCountries($params);
+
+Miscellaneous::listStates($params);
+```
 
 ### Using WebHook route
 Laravel paystack provides you a predefined endpoint that listens to and validates incoming paystack's webhook events.

src/Http/Controllers/MiscellaneousController.php

@@ -0,0 +1,15 @@
+<?php
+
+namespace Myckhel\Paystack\Http\Controllers;
+
+use Myckhel\Paystack\Support\Miscellaneous;
+
+class MiscellaneousController extends Controller
+{
+  function __call($method, $args)
+  {
+    return $args
+      ? Miscellaneous::$method($args[0], request()->all())
+      : Miscellaneous::$method(request()->all());
+  }
+}

src/Support/Miscellaneous.php

@@ -0,0 +1,55 @@
+<?php
+
+namespace Myckhel\Paystack\Support;
+
+use Myckhel\Paystack\Traits\Request;
+
+/**
+ * The Miscellaneous API are supporting APIs that
+ * can be used to provide more details to other APIs
+ *
+ */
+class Miscellaneous
+{
+  use Request;
+
+  /**
+   * Get a list of all supported banks and their properties
+   *
+   * @return \Illuminate\Http\Response
+   */
+  static function listBanks($params = [])
+  {
+    return self::get("/bank", $params);
+  }
+
+  /**
+   * Get a list of all providers for Dedicated Virtual Account
+   *
+   * @return \Illuminate\Http\Response
+   */
+  static function listProviders($params = [])
+  {
+    return self::get("/banks", $params);
+  }
+
+  /**
+   * Gets a list of Countries that Paystack currently supports
+   *
+   * @return \Illuminate\Http\Response
+   */
+  static function listCountries($params = [])
+  {
+    return self::get("/country", $params);
+  }
+
+  /**
+   * Get a list of states for a country for address verification.
+   *
+   * @return \Illuminate\Http\Response
+   */
+  static function listStates($params = [])
+  {
+    return self::get("/address_verification/states", $params);
+  }
+}

src/routes.php

@@ -12,6 +12,7 @@
 use Myckhel\Paystack\Traits\PaystackConfig;
 use Myckhel\Paystack\Http\Controllers\HookController;
 use Myckhel\Paystack\Http\Controllers\InvoiceController;
+use Myckhel\Paystack\Http\Controllers\MiscellaneousController;
 use Myckhel\Paystack\Http\Controllers\PageController;
 use Myckhel\Paystack\Http\Controllers\PlanController;
 use Myckhel\Paystack\Http\Controllers\ProductController;
@@ -169,6 +170,11 @@
     'get,bank/resolve'        => 'verification,resolve',
     'post,bank/validate'      => 'verification,validateAccount',
     'get,decision/bin/{bin}'  => 'verification,resolveCardBIN',
+    // miscellaneous
+    'get,bank'        => 'miscellaneous,listBanks',
+    'get,banks'       => 'miscellaneous,listProviders',
+    'get,country'     => 'miscellaneous,listCountries',
+    'get,address_verification/states'     => 'miscellaneous,listStates',
   ];
 
   $controls = [
@@ -194,6 +200,7 @@
     'dispute'         => DisputeController::class,
     'refund'          => RefundController::class,
     'verification'    => VerificationController::class,
+    'miscellaneous'   => MiscellaneousController::class,
   ];
 
   collect($routes)->map(function ($route, $index) use ($controls) {