wip

drpshtiwan · drpshtiwan · commit a2c87e9d3bf0 · 2025-02-10T21:00:13.000+03:00
diff --git a/.gitignore b/.gitignore
@@ -0,0 +1,14 @@
+.idea
+.php_cs
+.php_cs.cache
+.phpunit.result.cache
+build
+composer.lock
+coverage
+phpunit.xml
+phpstan.neon
+testbench.yaml
+vendor
+node_modules
+.php-cs-fixer.cache
+.DS_Store
diff --git a/LICENSE b/LICENSE
@@ -0,0 +1,12 @@
+MIT License
+
+Copyright (c) 2025
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+[Full License Text...]
diff --git a/composer.json b/composer.json
@@ -0,0 +1,24 @@
+{
+  "name": "thejano/zaincash-laravel",
+  "description": "A Laravel SDK for integrating with ZainCash payment gateway",
+  "type": "library",
+  "require": {
+    "php": ">=8.1",
+    "illuminate/support": "^8.0|^9.0|^10.0|^11.0",
+    "firebase/php-jwt": "^6.0",
+    "guzzlehttp/guzzle": "^7.0"
+  },
+  "autoload": {
+    "psr-4": {
+      "TheJano\\ZainCash\\": "src/"
+    }
+  },
+  "extra": {
+    "laravel": {
+      "providers": [
+        "TheJano\\ZainCash\\Providers\\ZainCashPaymentServiceProvider"
+      ]
+    }
+  },
+  "minimum-stability": "stable"
+}
diff --git a/config/zaincash.php b/config/zaincash.php
@@ -0,0 +1,13 @@
+<?php
+return [
+    'msisdn' => env('ZAINCASH_MSISDN', '9647835077893'),
+    'merchant_id' => env('ZAINCASH_MERCHANT_ID', '5ffacf6612b5777c6d44266f'),
+    'secret' => env('ZAINCASH_SECRET', '$2y$10$hBbAZo2GfSSvyqAyV2SaqOfYewgYpfR1O19gIh4SqyGWdmySZYPuS'),
+    'environment' => env('ZAINCASH_ENVIRONMENT', 'staging'),
+    'staging_url' => env('ZAINCASH_STAGING_URL', 'https://test.zaincash.iq'),
+    'production_url' => env('ZAINCASH_PRODUCTION_URL', 'https://api.zaincash.iq'),
+    'language' => env('ZAINCASH_LANGUAGE', 'ar'),
+    'prefix_order_id' => env('ZAINCASH_PREFIX_ORDER_ID', 'myshop_'),
+    'should_redirect' => env('ZAINCASH_SHOULD_REDIRECT', true),
+    'redirect_url' => env('ZAINCASH_REDIRECT_URL', 'https://yourwebsite.com/payment/callback'),
+];
diff --git a/editorconfig.txt b/editorconfig.txt
@@ -0,0 +1,15 @@
+root = true
+
+[*]
+charset = utf-8
+indent_size = 4
+indent_style = space
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.{yml,yaml}]
+indent_size = 2
diff --git a/gitattributes.txt b/gitattributes.txt
@@ -0,0 +1,19 @@
+# Path-based git attributes
+# https://www.kernel.org/pub/software/scm/git/docs/gitattributes.html
+
+# Ignore all test and documentation with "export-ignore".
+/.github            export-ignore
+/.gitattributes     export-ignore
+/.gitignore         export-ignore
+/phpunit.xml.dist   export-ignore
+/art                export-ignore
+/docs               export-ignore
+/tests              export-ignore
+/.editorconfig      export-ignore
+/.php_cs.dist.php   export-ignore
+/psalm.xml          export-ignore
+/psalm.xml.dist     export-ignore
+/testbench.yaml     export-ignore
+/UPGRADING.md       export-ignore
+/phpstan.neon.dist  export-ignore
+/phpstan-baseline.neon  export-ignore
diff --git a/src/Contracts/PaymentGateway.php b/src/Contracts/PaymentGateway.php
@@ -0,0 +1,8 @@
+<?php
+namespace TheJano\ZainCash\Contracts;
+
+interface PaymentGateway {
+    public function initiatePayment(string $orderId, float $amount, string $serviceType, ?string $redirectUrl = null): array;
+    public function verifyPayment(string $token): ?array;
+    public function checkTransaction(string $transactionId): array;
+}
diff --git a/src/Facades/ZainCashPayment.php b/src/Facades/ZainCashPayment.php
@@ -0,0 +1,10 @@
+<?php
+namespace TheJano\ZainCash\Facades;
+
+use Illuminate\Support\Facades\Facade;
+
+class ZainCashPayment extends Facade {
+    protected static function getFacadeAccessor() {
+        return 'zaincashPayment';
+    }
+}
diff --git a/src/Http/HttpClient.php b/src/Http/HttpClient.php
@@ -0,0 +1,6 @@
+<?php
+namespace TheJano\ZainCash\Http;
+
+interface HttpClient {
+    public function post(string $url, array $data): array;
+}
diff --git a/src/Http/LaravelHttpClient.php b/src/Http/LaravelHttpClient.php
@@ -0,0 +1,15 @@
+<?php
+namespace TheJano\ZainCash\Http;
+
+use Illuminate\Support\Facades\Http;
+use Exception;
+
+class LaravelHttpClient implements HttpClient {
+    public function post(string $url, array $data): array {
+        $response = Http::asForm()->post($url, $data);
+        if ($response->failed()) {
+            throw new Exception('Request failed: ' . $response->body());
+        }
+        return $response->json();
+    }
+}
diff --git a/src/Providers/ZainCashPaymentServiceProvider.php b/src/Providers/ZainCashPaymentServiceProvider.php
@@ -0,0 +1,22 @@
+<?php
+namespace TheJano\ZainCash\Providers;
+
+use Illuminate\Support\ServiceProvider;
+use TheJano\ZainCash\Services\ZainCashPayment;
+use TheJano\ZainCash\Http\LaravelHttpClient;
+
+class ZainCashPaymentServiceProvider extends ServiceProvider {
+    public function boot() {
+        $this->publishes([
+            __DIR__ . '/../../config/zaincash.php' => config_path('zaincash.php'),
+        ], 'config');
+    }
+
+    public function register() {
+        $this->mergeConfigFrom(__DIR__ . '/../../config/zaincash.php', 'zaincash');
+
+        $this->app->singleton('zaincashPayment', function ($app) {
+            return ZainCashPayment::make();
+        });
+    }
+}
diff --git a/src/Services/ZainCashPayment.php b/src/Services/ZainCashPayment.php
@@ -0,0 +1,111 @@
+<?php
+
+namespace TheJano\ZainCash\Services;
+
+use TheJano\ZainCash\Contracts\PaymentGateway;
+use TheJano\ZainCash\Http\HttpClient;
+use Firebase\JWT\JWT;
+use Firebase\JWT\Key;
+use Exception;
+use TheJano\ZainCash\Http\LaravelHttpClient;
+
+class ZainCashPayment implements PaymentGateway
+{
+    private HttpClient $httpClient;
+    private string $secret;
+    private string $merchantId;
+    private string $msisdn;
+    private string $language;
+    private string $environment;
+    private string $baseUrl;
+    private bool $shouldRedirect;
+    private string $redirectUrl;
+    private string $prefixOrderId;
+    private static ?ZainCashPayment $instance = null;
+
+    public function __construct(HttpClient $httpClient)
+    {
+        $config = config('zaincash');
+        $this->secret = $config['secret'];
+        $this->merchantId = $config['merchant_id'];
+        $this->msisdn = $config['msisdn'];
+        $this->language = $config['language'];
+        $this->environment = $config['environment'];
+        $this->baseUrl = $this->environment === 'production' ? $config['production_url'] : $config['staging_url'];
+        $this->shouldRedirect = $config['should_redirect'];
+        $this->redirectUrl = $config['redirect_url'];
+        $this->prefixOrderId = $config['prefix_order_id'];
+        $this->httpClient = $httpClient;
+    }
+
+    public static function make(): ZainCashPayment
+    {
+        if (self::$instance === null) {
+            self::$instance = new self(new LaravelHttpClient());
+        }
+        return self::$instance;
+    }
+
+    public function initiatePayment(string $orderId, float $amount, string $serviceType, ?string $redirectUrl = null): array
+    {
+        $data = [
+            'amount' => $amount,
+            'serviceType' => $serviceType,
+            'orderId' => $this->prefixOrderId . $orderId,
+        ];
+
+        if ($this->shouldRedirect) {
+            $data['redirectUrl'] = $redirectUrl ?? $this->redirectUrl;
+        }
+
+        $token = $this->generateToken($data);
+
+        return $this->httpClient->post("{$this->baseUrl}/transaction/init", [
+            'token' => $token,
+            'merchantId' => $this->merchantId,
+            'lang' => $this->language,
+        ]);
+    }
+
+    public function verifyPayment(string $token): ?array
+    {
+        try {
+            return (array)JWT::decode($token, new Key($this->secret, 'HS256'));
+        } catch (Exception $e) {
+            return null;
+        }
+    }
+
+    public function checkTransaction(string $transactionId): array
+    {
+        $token = $this->generateToken(['id' => $transactionId, 'msisdn' => $this->msisdn]);
+
+        return $this->httpClient->post("{$this->baseUrl}/transaction/get", [
+            'token' => $token,
+            'merchantId' => $this->merchantId,
+        ]);
+    }
+
+    public function getPaymentUrl(string $transactionId): string
+    {
+        return "{$this->baseUrl}/transaction/pay?id={$transactionId}";
+    }
+
+    private function generateToken(array $data): string
+    {
+        $data['msisdn'] = $this->msisdn;
+        $data['iat'] = time();
+        $data['exp'] = time() + 60 * 60 * 4;
+
+        return JWT::encode($data, $this->secret, 'HS256');
+    }
+
+    public static function decodeToken(string $token, string $secret): ?array
+    {
+        try {
+            return (array)JWT::decode($token, new Key($secret, 'HS256'));
+        } catch (Exception $e) {
+            return null;
+        }
+    }
+}
