updated docs with newly added httpClient Wrapper usage

Author: MusahMusah

docs/.vitepress/config.js

@@ -45,6 +45,7 @@ export default {
                     {text: "Banks", link: "/paystack/banks.html"},
                     {text: "Transfers", link: "/paystack/transfers.html"},
                     {text: "Transactions", link: "/paystack/transactions.html"},
+                    {text: "Other Endpoints", link: "/paystack/other-endpoints.html"},
                 ],
             },
 
@@ -63,6 +64,7 @@ export default {
                     {text: "OTPs", link: "/flutterwave/otps.html"},
                     {text: "Charge", link: "/flutterwave/charge.html"},
                     {text: "Preauthorization", link: "/flutterwave/preauthorization.html"},
+                    {text: "Other Endpoints", link: "/flutterwave/other-endpoints.html"},
                 ],
             },
 
@@ -72,6 +74,7 @@ export default {
                 items: [
                     {text: "Setup", link: "/stripe/setup.html"},
                     {text: "Transactions", link: "/stripe/transactions.html"},
+                    {text: "Other Endpoints", link: "/stripe/other-endpoints.html"},
                 ],
             },
 

docs/flutterwave/other-endpoints.md

@@ -0,0 +1,54 @@
+# Making Request to Other Endpoints
+Given that our `Flutterwave` service only provide access to the most common endpoints, you can make request to other endpoints
+we have not added to the service by using the `HttpClientWrapper` class. This class is a wrapper around the `GuzzleHttp\Client`
+class and it provides a simple way to make request to any endpoint. The `HttpClientWrapper` class is available through the 
+`Flutterwave` facade, `flutterwave()` helper or through dependency injection using the `FlutterwaveContract` interface.
+The `HttpClientWrapper` class, is designed to extract some of the configurations from the `Flutterwave` service such as the `secret_key`
+and the `base_url` of the payment gateway. This means you don't have to pass the `secret_key` and the `base_url` when using the
+`HttpClientWrapper` as it will be automatically be extracted from the `Flutterwave` service.
+
+# You can use the `HttpClientWrapper` class in any of the following ways:
+## Using Facade
+```php
+use MusahMusah\LaravelMultipaymentGateways\Facades\Flutterwave;
+
+// Example of making get request 
+$response = Flutterwave::httpClient()->get('/banks/056');
+dd($response);
+
+```
+
+## Using Helper
+```php
+
+ // all payment gateways provided by the package can use the httpClient
+ $response = flutterwave()->httpClient()->get('/banks/056');
+ dd($response);
+
+```
+
+## Using Dependency Injection
+```php
+use MusahMusah\LaravelMultipaymentGateways\Contracts\FlutterwaveContract;
+
+class FlutterwavePaymentController extends Controller
+{
+    public function initiatePayment(Request $request, FlutterwaveContract $flutterwave)
+    {
+        $response = $flutterwave->httpClient()->get('/banks/056');
+        dd($response);
+    }
+}
+
+```
+
+With the above example, you can make request to any `Flutterwave` endpoint you want. This ensures the package is flexible and can be used
+to make request to any endpoint of the payment gateway you are using.
+
+# All HTTP Methods Available
+The `HttpClientWrapper` class provides access to all the HTTP methods available in the `GuzzleHttp\Client` class. The methods are:
+- `get`
+- `post`
+- `put`
+- `patch`
+- `delete`

docs/paystack/other-endpoints.md

@@ -0,0 +1,72 @@
+# Making Request to Other Endpoints
+Given that our `Paystack` service only provide access to the most common endpoints, you can make request to other endpoints
+we have not added to the service by using the `HttpClientWrapper` class. This class is a wrapper around the `GuzzleHttp\Client`
+class and it provides a simple way to make request to any endpoint. The `HttpClientWrapper` class is available through the 
+`Paystack` facade, `paystack()` helper or through dependency injection using the `PaystackContract` interface.
+The `HttpClientWrapper` class, is designed to extract some of the configurations from the `Paystack` service such as the `secret_key`
+and the `base_url` of the payment gateway. This means you don't have to pass the `secret_key` and the `base_url` when using the
+`HttpClientWrapper` as it will be automatically be extracted from the `Paystack` service.
+
+# You can use the `HttpClientWrapper` class in any of the following ways:
+## Using Facade
+```php
+use MusahMusah\LaravelMultipaymentGateways\Facades\Paystack;
+
+// Example of making http post request
+ $fields = [
+    "email" => "customer@email.com",
+     "first_name" => "Zero",
+     "last_name" => "Sum",
+    "phone" => "+2348123456789"
+ ];
+ 
+$response = Paystack::httpClient()->post('customer', $fields);
+
+```
+
+## Using Helper
+```php
+// Example of making http post request
+  $fields = [
+    "email" => "customer@email.com",
+     "first_name" => "Zero",
+     "last_name" => "Sum",
+    "phone" => "+2348123456789"
+ ];
+
+ $response = paystack()->httpClient()->post('customer', $fields);
+
+```
+
+## Using Dependency Injection
+```php
+use MusahMusah\LaravelMultipaymentGateways\Contracts\PaystackContract;
+
+class PaystackPaymentController extends Controller
+{
+    public function initiatePayment(Request $request, PaystackContract $paystack)
+    {
+        // Example of making http post request
+        $fields = [
+            "email" => "customer@email.com",
+             "first_name" => "Zero",
+             "last_name" => "Sum",
+            "phone" => "+2348123456789"
+        ];
+
+        $response = $paystack->httpClient()->post('customer', $fields);
+    }
+}
+
+```
+
+With the above example, you can make request to any `Paystack` endpoint you want. This ensures the package is flexible and can be used
+to make request to any endpoint of the payment gateway you are using.
+
+# All HTTP Methods Available
+The `HttpClientWrapper` class provides access to all the HTTP methods available in the `GuzzleHttp\Client` class. The methods are:
+- `get`
+- `post`
+- `put`
+- `patch`
+- `delete`

docs/stripe/other-endpoints.md

@@ -0,0 +1,54 @@
+# Making Request to Other Endpoints
+Given that our `Stripe` service only provide access to the most common endpoints, you can make request to other endpoints
+we have not added to the service by using the `HttpClientWrapper` class. This class is a wrapper around the `GuzzleHttp\Client`
+class and it provides a simple way to make request to any endpoint. The `HttpClientWrapper` class is available through the 
+`Stripe` facade, `stripe()` helper or through dependency injection using the `StripeContract` interface.
+The `HttpClientWrapper` class, is designed to extract some of the configurations from the `Stripe` service such as the `secret_key`
+and the `base_url` of the payment gateway. This means you don't have to pass the `secret_key` and the `base_url` when using the
+`HttpClientWrapper` as it will be automatically be extracted from the `Stripe` service.
+
+# You can use the `HttpClientWrapper` class in any of the following ways:
+## Using Facade
+```php
+use MusahMusah\LaravelMultipaymentGateways\Facades\Stripe;
+
+// Example of making get request 
+$response = Stripe::httpClient()->get('v1/customers/cus_4QFOF3xrvBT2nU');
+dd($response);
+
+```
+
+## Using Helper
+```php
+
+ // all payment gateways provided by the package can use the httpClient
+ $response = stripe()->httpClient()->get('v1/customers/cus_4QFOF3xrvBT2nU');
+ dd($response);
+
+```
+
+## Using Dependency Injection
+```php
+use MusahMusah\LaravelMultipaymentGateways\Contracts\StripeContract;
+
+class StripePaymentController extends Controller
+{
+    public function initiatePayment(Request $request, StripeContract $stripe)
+    {
+        $response = $stripe->httpClient()->get('v1/customers/cus_4QFOF3xrvBT2nU');
+        dd($response);
+    }
+}
+
+```
+
+With the above example, you can make request to any `Stripe` endpoint you want. This ensures the package is flexible and can be used
+to make request to any endpoint of the payment gateway you are using.
+
+# All HTTP Methods Available
+The `HttpClientWrapper` class provides access to all the HTTP methods available in the `GuzzleHttp\Client` class. The methods are:
+- `get`
+- `post`
+- `put`
+- `patch`
+- `delete`