added timeout of request

Author: waadmawlood

config/zaincash.php

@@ -95,4 +95,13 @@
     */
     'min_amount' => env('ZAINCASH_MIN_AMOUNT', 1000),
 
+    /*
+    |--------------------------------------------------------------------------
+    | timeout Request (in seconds)
+    |--------------------------------------------------------------------------
+    |
+    | Set the timeout for the request to ZainCash's API.
+    | The default value is 10 seconds.
+    */
+    'timeout' => env('ZAINCASH_TIMEOUT', 10),
 ];

readme.md

@@ -68,6 +68,7 @@ update config zaincash in `config/zaincash.php` or from `.env` file
 | prefix_order_id       | string | wa3d_ | Prefix for the order ID. |
 | is_redirect           | bool   | false   | Specify whether or not to redirect to the ZainCash payment page. If false, ZainCash returns a Transaction ID to the backend. If true, redirection after the request. |
 | min_amount            | int    | 1000  | Set the minimum amount for a valid transaction in Iraqi Dinar (IQD). Transactions with amounts less than this value will be considered invalid.  |
+| timeout               | int    | 10    | Set the timeout for the request in seconds. |
 
 
 <br>
@@ -84,6 +85,7 @@ ZAINCASH_IS_REDIRECT=false                     # optional default false
 ZAINCASH_MIN_AMOUNT=1000                       # optional default 1000
 ZAINCASH_TEST_URL=https://test.zaincash.iq/    # optional
 ZAINCASH_LIVE_URL=https://api.zaincash.iq/     # optional
+ZAINCASH_TIMEOUT=10                            # optional
 ```
 
 
@@ -210,6 +212,7 @@ class PaymentController extends Controller
 | processingUrl     |🔴| string-null      | `getProcessingUrl()`                  | `setProcessingUrl($processingUrl)`     | -        |
 | processingOtpUrl  |🔴| string-null      | `getProcessingOtpUrl()`               | `setProcessingOtpUrl($processingOtpUrl)` | -      |
 | cancelUrl         |🔴| string-null      | `getCancelUrl()`                      | `setCancelUrl($cancelUrl)`             | -        |
+| timeout           |🔴| int-null         | `getTimeout()`                        | `setTimeout($timeout)`                 | -        |
 
 ⚠️ `Important` column means that this attribute is constantly used and has no default value. On the contrary, we can change it, but it will take the default value from `config/zaincash.php`.
 

src/BaseZainCash.php

@@ -31,7 +31,8 @@ public function __construct(
         protected $processingOtpUrl = null,
         protected $cancelUrl = null,
         protected $transactionID = null,
-        protected $isReturnArray = false
+        protected $isReturnArray = false,
+        protected $timeout = null
     ) {
         if ($orderId) {
             $this->orderId = $this->getConfig("prefix_order_id") . $orderId;

src/Services/HttpClient.php

@@ -10,10 +10,12 @@ class HttpClient
     /**
      * @return \Psr\Http\Message\ResponseInterface|\Illuminate\Http\Client\Response|array
      */
-    public function httpPost(string $url, array $data = [], array $headers = []): mixed
+    public function httpPost(string $url, array $data = [], array $headers = [], $timeout = 10): mixed
     {
+        set_time_limit($timeout);
+        
         try {
-            $response = Http::timeout(10)->withHeaders($headers)->asForm()->post($url, $data);
+            $response = Http::timeout($timeout)->withHeaders($headers)->asForm()->post($url, $data);
             return $response;
         } catch (RequestException $e) {
             return [

src/Traits/HttpClientRequests.php

@@ -14,8 +14,9 @@ protected function createTransactionHttpClient(string $token)
 
         return app(\Waad\ZainCash\Services\HttpClient::class)
             ->httpPost(
-                $this->getTUrl(),
-                $body
+                url: $this->getTUrl(),
+                data: $body,
+                timeout: $this->getTimeout()
             );
     }
 
@@ -28,8 +29,9 @@ protected function sendRequestCheckTransaction(string $token)
         $body = $this->bodyPostRequestCheckTransaction($token, $this->getMerchantId());
         return app(\Waad\ZainCash\Services\HttpClient::class)
             ->httpPost(
-                $this->getCUrl(),
-                $body
+                url: $this->getCUrl(),
+                data: $body,
+                timeout: $this->getTimeout()
             );
     }
 
@@ -42,12 +44,13 @@ protected function sendRequestProcessingTransaction(string $phonenumber, string
     {
         return app(\Waad\ZainCash\Services\HttpClient::class)
             ->httpPost(
-                $this->getProcessingUrl(),
-                [
+                url: $this->getProcessingUrl(),
+                data: [
                     'id' => $this->getTransactionID(),
                     'phonenumber' => $phonenumber,
                     'pin' => $pin,
-                ]
+                ],
+                timeout: $this->getTimeout()
             );
     }
 
@@ -61,13 +64,14 @@ protected function sendRequestPayTransaction(string $phonenumber, string $pin, s
     {
         return app(\Waad\ZainCash\Services\HttpClient::class)
             ->httpPost(
-                $this->getProcessingOtpUrl(),
-                [
+                url: $this->getProcessingOtpUrl(),
+                data: [
                     'id' => $this->getTransactionID(),
                     'phonenumber' => $phonenumber,
                     'pin' => $pin,
                     'otp' => $otp,
-                ]
+                ],
+                timeout: $this->getTimeout()
             );
     }
 
@@ -78,11 +82,12 @@ protected function sendRequestCancelTransaction()
     {
         return app(\Waad\ZainCash\Services\HttpClient::class)
             ->httpPost(
-                $this->getCancelUrl(),
-                [
+                url: $this->getCancelUrl(),
+                data: [
                     'id' => $this->getTransactionID(),
                     'type' => 'MERCHANT_PAYMENT'
-                ]
+                ],
+                timeout: $this->getTimeout()
             );
     }
 }

src/Traits/Initialable.php

@@ -44,6 +44,11 @@ protected function initial(): void
             $this->setIsRedirect($this->getConfig("is_redirect"));
         }
 
+        // Set the timeout request.
+        if (is_null($this->getTimeout())) {
+            $this->setTimeout($this->getConfig("timeout"));
+        }
+
         // Set the URLs.
         $this->initailUrls();
     }

src/Traits/getSetAttributes.php

@@ -215,4 +215,15 @@ public function setIsReturnArray(bool $isReturnArray = false): self
         $this->isReturnArray = $isReturnArray;
         return $this;
     }
+
+    public function getTimeout(): int|null
+    {
+        return $this->timeout;
+    }
+
+    public function setTimeout(int $timeout): self
+    {
+        $this->timeout = $timeout;
+        return $this;
+    }
 }