update

- added GatewayApi Facade
- added setCallbackUrl method

README.md

@@ -27,11 +27,24 @@ GATEWAY_SENDER="Milky Way"
 
 On the fly
 ```
-(new GatewayApi())
-    ->setSenderName('Elon Musk')
+GatewayApi::setSenderName('Elon Musk')
     ->sendSimpleSMS('test message', [+380987654321])
 ```
 
 By default, the sender's name is the name of the app
 
 Up to 11 alphanumeric characters or 15 digits
+
+### Callback Url
+
+[Official Docs](https://gatewayapi.com/docs/apis/rest/#http-callback)
+
+You can easily specify the callback url:
+
+On the fly
+```
+GatewayApi::setCallbackUrl('https://test-dev.com/callbacks/sms')
+    ->sendSimpleSMS('test message', [+380987654321])
+```
+
+By default, the callback url is null

composer.json

@@ -26,7 +26,10 @@
         "laravel": {
             "providers": [
                 "Loafer\\GatewayApi\\GatewayApiServiceProvider"
-            ]
+            ],
+            "aliases": {
+                "GatewayApi": "Loafer\\GatewayApi\\Facades\\GatewayApi"
+            }
         }
     }
-}
+}

src/Facades/GatewayApi.php

@@ -0,0 +1,13 @@
+<?php
+
+namespace Loafer\GatewayApi\Facades;
+
+use Illuminate\Support\Facades\Facade;
+
+class GatewayApi extends Facade
+{
+    protected static function getFacadeAccessor()
+    {
+        return 'gatewayapi';
+    }
+}

src/GatewayApi.php

@@ -15,6 +15,7 @@ class GatewayApi
     private $client;
 
     private $sender_name;
+    private $callback_url = null;
 
     public function __construct()
     {
@@ -49,6 +50,17 @@ public function setSenderName(string $name)
         return $this;
     }
 
+    public function setCallbackUrl(string $url)
+    {
+        if (!filter_var($url, FILTER_VALIDATE_URL)) {
+            throw new InvalidArgumentException('The callback URL is invalid, ' . $url);
+        };
+
+        $this->callback_url = $url;
+
+        return $this;
+    }
+
     public function sendSimpleSMS(string $message, array $recipients)
     {
         $body = [
@@ -57,6 +69,10 @@ public function sendSimpleSMS(string $message, array $recipients)
             'sender' => $this->sender_name
         ];
 
+        if ($this->callback_url) {
+            $body['callback_url'] = $this->callback_url;
+        }
+
         foreach ($recipients as $recipient) {
             $body['recipients'][] = ['msisdn' => $recipient];
         }

src/GatewayApiServiceProvider.php

@@ -13,7 +13,9 @@ class GatewayApiServiceProvider extends ServiceProvider
      */
     public function register()
     {
-        //
+        $this->app->bind('gatewayapi', function ($app) {
+            return new GatewayApi();
+        });
     }
 
     /**