init

.gitignore

@@ -0,0 +1 @@
+/vendor/

.idea/.gitignore

@@ -0,0 +1,21 @@
+# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio, WebStorm and Rider
+# Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839
+
+# User-specific stuff
+**/workspace.xml
+**/tasks.xml
+**/usage.statistics.xml
+**/dictionaries
+**/shelf
+
+# Generated files
+**/contentModel.xml
+
+# Sensitive or high-churn files
+**/dataSources/
+**/dataSources.ids
+**/dataSources.local.xml
+**/sqlDataSources.xml
+**/dynamic.xml
+**/uiDesigner.xml
+**/dbnavigator.xml

.idea/mirfalah-payment.iml

@@ -0,0 +1,45 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="WEB_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$">
+      <sourceFolder url="file://$MODULE_DIR$/spec" isTestSource="true" />
+      <sourceFolder url="file://$MODULE_DIR$/tests" isTestSource="true" />
+      <sourceFolder url="file://$MODULE_DIR$/src" isTestSource="false" packagePrefix="MirfalahTech\Laravel\Payment\" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/composer" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/doctrine/inflector" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/illuminate/contracts" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/illuminate/filesystem" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/illuminate/http" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/illuminate/session" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/illuminate/support" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/nesbot/carbon" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/paragonie/random_compat" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/psr/container" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/psr/event-dispatcher" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/psr/log" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/psr/simple-cache" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/deprecation-contracts" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/error-handler" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/event-dispatcher" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/event-dispatcher-contracts" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/finder" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/http-foundation" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/http-kernel" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/mime" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-ctype" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-intl-idn" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-intl-normalizer" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-mbstring" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-php70" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-php72" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-php73" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-php80" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/translation" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/translation-contracts" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/var-dumper" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/voku/portable-ascii" />
+    </content>
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/mirfalah-payment.iml" filepath="$PROJECT_DIR$/.idea/mirfalah-payment.iml" />
+    </modules>
+  </component>
+</project>

.idea/php.xml

@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="PhpIncludePathManager">
+    <include_path>
+      <path value="$PROJECT_DIR$/vendor/composer" />
+      <path value="$PROJECT_DIR$/vendor/psr/simple-cache" />
+      <path value="$PROJECT_DIR$/vendor/psr/container" />
+      <path value="$PROJECT_DIR$/vendor/nesbot/carbon" />
+      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-php80" />
+      <path value="$PROJECT_DIR$/vendor/illuminate/contracts" />
+      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-mbstring" />
+      <path value="$PROJECT_DIR$/vendor/symfony/translation-contracts" />
+      <path value="$PROJECT_DIR$/vendor/illuminate/support" />
+      <path value="$PROJECT_DIR$/vendor/symfony/translation" />
+      <path value="$PROJECT_DIR$/vendor/doctrine/inflector" />
+      <path value="$PROJECT_DIR$/vendor/voku/portable-ascii" />
+      <path value="$PROJECT_DIR$/vendor/paragonie/random_compat" />
+      <path value="$PROJECT_DIR$/vendor/psr/log" />
+      <path value="$PROJECT_DIR$/vendor/psr/event-dispatcher" />
+      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-php73" />
+      <path value="$PROJECT_DIR$/vendor/symfony/error-handler" />
+      <path value="$PROJECT_DIR$/vendor/symfony/http-foundation" />
+      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-php72" />
+      <path value="$PROJECT_DIR$/vendor/symfony/finder" />
+      <path value="$PROJECT_DIR$/vendor/illuminate/session" />
+      <path value="$PROJECT_DIR$/vendor/symfony/http-kernel" />
+      <path value="$PROJECT_DIR$/vendor/symfony/deprecation-contracts" />
+      <path value="$PROJECT_DIR$/vendor/illuminate/http" />
+      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-ctype" />
+      <path value="$PROJECT_DIR$/vendor/illuminate/filesystem" />
+      <path value="$PROJECT_DIR$/vendor/symfony/var-dumper" />
+      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-intl-normalizer" />
+      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-php70" />
+      <path value="$PROJECT_DIR$/vendor/symfony/mime" />
+      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-intl-idn" />
+      <path value="$PROJECT_DIR$/vendor/symfony/event-dispatcher-contracts" />
+      <path value="$PROJECT_DIR$/vendor/symfony/event-dispatcher" />
+    </include_path>
+  </component>
+  <component name="PhpProjectSharedConfiguration" php_language_level="7.1" />
+</project>

.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="$PROJECT_DIR$" vcs="Git" />
+  </component>
+</project>

README.md

@@ -0,0 +1,3 @@
+# mirfalah/laravel-payment
+
+This library is not complete yet, this is just placeholder

composer.json

@@ -0,0 +1,29 @@
+{
+    "name": "mirfalah/laravel-payment",
+    "description": "Laravel payment service provider",
+    "type": "library",
+    "require": {
+        "php": ">=7.1",
+        "illuminate/support": ">=5.0 <8.0",
+        "illuminate/http": ">=5.0 <8.0"
+    },
+    "license": "Mirfalah-Tech",
+    "authors": [
+        {
+            "name": "Lim Eng Shun",
+            "email": "engshun@mirfalah.my"
+        }
+    ],
+    "autoload": {
+        "psr-4": {
+            "MirfalahTech\\Laravel\\Payment\\": "src/"
+        }
+    },
+    "extra": {
+        "laravel": {
+            "providers": [
+                "MirfalahTech\\Laravel\\Payment\\PaymentServiceProvider"
+            ]
+        }
+    }
+}

config/payment.php

@@ -0,0 +1,7 @@
+<?php
+
+return [
+    'default' => env('PAYMENT_GATEWAY'),
+
+    'gateway' => [],
+];

src/Contracts/PayableEntity.php

@@ -0,0 +1,66 @@
+<?php
+
+
+namespace MirfalahTech\Laravel\Payment\Contracts;
+
+
+interface PayableEntity
+{
+    /**
+     * A unique id which represent the order.
+     *
+     * @return string
+     */
+    public function getBillId(): string;
+
+    /**
+     * Decimal number without any currency symbol, payment gateway need to convert
+     * if different standard is used.
+     *
+     * @return string
+     */
+    public function getBillAmount(): string;
+
+    /**
+     * Get buyer's name.
+     * @return string
+     */
+    public function getBillName(): string;
+
+    /**
+     * Get buyer's email.
+     *
+     * @return string
+     */
+    public function getBillEmail(): string;
+
+    /**
+     * Get buyer's phone number.
+     *
+     * @return string
+     */
+    public function getBillPhoneNumber(): string;
+
+    /**
+     * Get description for payment.
+     *
+     * @return string
+     */
+    public function getBillDescription(): string;
+
+    /**
+     * Get ISO 4214 currency code, payment gateway driver need to
+     * convert if different standard is used.
+     *
+     * @return string
+     */
+    public function getBillCurrency(): string;
+
+    /**
+     * Get ISO 3166 country code, payment gateway driver need to
+     * convert if different standard is used.
+     *
+     * @return string
+     */
+    public function getBillCountry(): string;
+}

src/Contracts/PaymentFactory.php

@@ -0,0 +1,10 @@
+<?php
+
+
+namespace MirfalahTech\Laravel\Payment\Contracts;
+
+
+interface PaymentFactory
+{
+    public function via(string $gateway = null): PaymentGatewayDriver;
+}

src/Contracts/PaymentGatewayDriver.php

@@ -0,0 +1,17 @@
+<?php
+
+
+namespace MirfalahTech\Laravel\Payment\Contracts;
+
+
+use Illuminate\Http\Request;
+use Symfony\Component\HttpFoundation\Response;
+
+interface PaymentGatewayDriver
+{
+    public function createPaymentURL(PayableEntity $payable, array $options = []): string;
+
+    public function verifyGatewayReturn(Request $request): bool;
+
+    public function verifyGatewayCallback(Request $request, Response &$response = null): bool;
+}

src/Facade/Payment.php

@@ -0,0 +1,28 @@
+<?php
+
+
+namespace MirfalahTech\Laravel\Payment\Facade;
+
+
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Facade;
+use MirfalahTech\Laravel\Payment\Contracts\PayableEntity;
+use MirfalahTech\Laravel\Payment\Contracts\PaymentGatewayDriver;
+use Symfony\Component\HttpFoundation\Response;
+
+/**
+ * Class Payment
+ * @package MirfalahTech\Laravel\Payment\Facade
+ *
+ * @method static PaymentGatewayDriver via(string $gateway = null)
+ * @method static string createPaymentURL(PayableEntity $payable, array $options = [])
+ * @method static bool verifyGatewayReturn(Request $request)
+ * @method static bool verifyGatewayCallback(Request $request, Response &$response = null)
+ */
+class Payment extends Facade
+{
+    protected static function getFacadeAccessor()
+    {
+        return 'payment';
+    }
+}

src/Manager/PaymentManager.php

@@ -0,0 +1,46 @@
+<?php
+
+
+namespace MirfalahTech\Laravel\Payment\Manager;
+
+
+use Illuminate\Contracts\Container\Container;
+use Illuminate\Http\Request;
+use Illuminate\Support\Manager;
+use MirfalahTech\Laravel\Payment\Contracts\PayableEntity;
+use MirfalahTech\Laravel\Payment\Contracts\PaymentFactory;
+use MirfalahTech\Laravel\Payment\Contracts\PaymentGatewayDriver;
+use Symfony\Component\HttpFoundation\Response;
+
+/**
+ * Class PaymentManager
+ * @package MirfalahTech\Laravel\Payment\Manager
+ *
+ * @method PaymentGatewayDriver driver($driver = null)
+ * @method string createPaymentURL(PayableEntity $payable, array $options = [])
+ * @method bool verifyGatewayReturn(Request $request)
+ * @method bool verifyGatewayCallback(Request $request, Response &$response = null)
+ */
+class PaymentManager extends Manager implements PaymentFactory
+{
+    /**
+     * @var string
+     */
+    protected $defaultGateway;
+
+    public function __construct(Container $container, string $defaultGateway)
+    {
+        parent::__construct($container);
+        $this->defaultGateway = $defaultGateway;
+    }
+
+    public function via(string $gateway = null): PaymentGatewayDriver
+    {
+        return $this->driver($gateway);
+    }
+
+    public function getDefaultDriver()
+    {
+        return $this->defaultGateway;
+    }
+}

src/PaymentServiceProvider.php

@@ -0,0 +1,37 @@
+<?php
+
+
+namespace MirfalahTech\Laravel\Payment;
+
+
+use Illuminate\Contracts\Config\Repository;
+use Illuminate\Contracts\Foundation\Application;
+use Illuminate\Support\ServiceProvider;
+use MirfalahTech\Laravel\Payment\Manager\PaymentManager;
+
+class PaymentServiceProvider extends ServiceProvider
+{
+    public function boot()
+    {
+        $config_path = realpath(__DIR__ . '/../config/payment.php');
+
+        /** @var Repository $config */
+        $config = $this->app->make('config');
+
+        /** @noinspection PhpIncludeInspection */
+        $config->set('payment', array_merge(
+            require $config_path,
+            $config->get('payment')
+        ));
+
+        $this->app->singleton('payment', function (Application $app) use ($config) {
+            return new PaymentManager($app, $config->get('payment.default'));
+        });
+
+        $this->app->alias('payment', PaymentManager::class);
+
+        $this->publishes([
+            $config_path => $this->app->configPath('payment.php')
+        ], 'config');
+    }
+}