wip

Author: iamgergo

openapi.json

@@ -30,6 +30,11 @@
                 "summary": "Start a transaction",
                 "description": "Start a transaction using the given parameters",
                 "operationId": "start",
+                "headers": {
+                    "Signature": {
+                        "$ref": "#/components/headers/Signature"
+                    }
+                },
                 "requestBody": {
                     "description": "The transaction object you would like to start.",
                     "required": true,
@@ -46,10 +51,7 @@
                         "description": "Success response",
                         "headers": {
                             "Signature": {
-                                "description": "The signature created by the SimplePay back-end.",
-                                "schema": {
-                                    "type": "string"
-                                }
+                                "$ref": "#/components/headers/Signature"
                             }
                         },
                         "content": {
@@ -104,9 +106,24 @@
                     }
                 }
             }
+        },
+        "/finish": {
+            "post": {}
         }
     },
     "components": {
+        "headers": {
+            "Signature": {
+                "description": "The signature created by the SimplePay back-end.",
+                "schema": {
+                    "type": "string",
+                    "example": "3WGqCnWJArhA224xVdUY1fPh91tpd6va6JvBrPNuHK449TZTgsRn3DBu5UBGbcTn"
+                }
+            }
+        },
+        "parameters": {
+
+        },
         "schemas": {
             "Transaction": {
                 "required": [

src/Client.php

@@ -4,14 +4,40 @@
 
 class Client
 {
+    /**
+     * The client version.
+     */
+    public const VERSION = '1.0.0';
+
     /**
      * Create a new SimplePay Client instance.
      */
-    public function __construct(protected string $merchantId, protected string $secretKey)
-    {
+    public function __construct(
+        protected string $merchantId,
+        protected string $secretKey,
+        protected bool $sandbox = false
+    ) {
         // $this->config()->setApiKey('X-API-KEY', $apiKey);
     }
 
+    /**
+     * Sign the given data.
+     */
+    public function sign(string $data): string
+    {
+        return base64_encode(
+            hash_hmac('sha384', $data, $this->secretKey, true)
+        );
+    }
+
+    /**
+     * Validate the signature.
+     */
+    public function validateSignature(string $hash, string $data): bool
+    {
+        return hash_equals($hash, $this->sign($data));
+    }
+
     /**
      * Get the configuration instance.
      */