mews/pos v1.7 update: added gateway_configs configuration

Author: nuryagdym

config/laravel-pos.php

@@ -50,12 +50,17 @@
                 'mbr_id'               => null,
             ],
             'gateway_endpoints' => [ // Required
-                 'payment_api'     => null, // Required
-                 'gateway_3d'      => null, // Required
-                 'gateway_3d_host' => null,
-                 'query_api'       => null,
+                'payment_api'     => null, // Required
+                'gateway_3d'      => null, // Required
+                'gateway_3d_host' => null,
+                'query_api'       => null,
+            ],
+            'gateway_configs' => [ // optional
+                'test_mode' => false, // default: false
+                // Hash kontrolü kütühaneden dolayı başarısız sonuçlanıyorsa bu ayarla devre dışı bırakılabilir.
+                // Ancak hash kontrolünün devre dışı bırakılması güvenlik açığı oluşturabilir.
+                'disable_3d_hash_check' => false, // default: false
             ],
-            'test_mode'         => false,
         ],
     ],
 ];

docs/EXAMPLE_CONFIGURATIONS.md

@@ -61,7 +61,12 @@ return [
                  'gateway_3d_host' => null,
                  'query_api'       => null,
             ],
-            'test_mode'         => false,
+            'gateway_configs' => [ // optional
+                'test_mode' => false, // default: false
+                // Hash kontrolü kütühaneden dolayı başarısız sonuçlanıyorsa bu ayarla devre dışı bırakılabilir.
+                // Ancak hash kontrolünün devre dışı bırakılması güvenlik açığı oluşturabilir.
+                'disable_3d_hash_check' => false, // default: false
+            ],
         ],
     ],
 ];
@@ -87,7 +92,6 @@ return [
         'estpos_payten'         => [
             'gateway_class'     => \Mews\Pos\Gateways\EstV3Pos::class,
             'lang'              => \Mews\Pos\PosInterface::LANG_TR, // optional
-            'test_mode'         => true, // optional
             'credentials'       => [
                 'payment_model' => \Mews\Pos\PosInterface::MODEL_3D_SECURE,
                 'merchant_id'   => '700XXXXXXX',
@@ -145,6 +149,26 @@ return [
                 'gateway_3d_host' => 'https://vpostest.qnbfinansbank.com/Gateway/3DHost.aspx',
             ],
         ],
+        'payfor_ziraat_katilim'     => [
+            'gateway_class'     => \Mews\Pos\Gateways\PayForPos::class,
+            'credentials'       => [
+                'payment_model' => \Mews\Pos\PosInterface::MODEL_3D_SECURE,
+                'merchant_id'   => '08530000XXXXXXXX', // Üye İşyeri Numarası.
+                'user_name'     => 'ZIRAAT_KATILIM_API_XXXXXXXX', // UserCode: Otorizasyon sistemi kullanıcı kodu.
+                'user_password' => 'XXXXXXXX', // Otorizasyon sistemi kullanıcı şifresi.
+                'enc_key'       => 'XXXXXXXX', // MerchantPass: 3D Secure şifresidir.
+                'mbr_id'        => \Mews\Pos\Entity\Account\PayForAccount::MBR_ID_ZIRAAT_KATILIM, // (Kurum Kodu)
+            ],
+            'gateway_configs'   => [
+                // Ziraat Katilim için hash kontrolü çalışmıyor. O yüzden devre dışı bırakıyoruz.
+                'disable_3d_hash_check' => true,
+            ],
+            'gateway_endpoints' => [
+                'payment_api'     => 'https://payfortestziraatkatilim.cordisnetwork.com/Mpi/XMLGate.aspx',
+                'gateway_3d'      => 'https://payfortestziraatkatilim.cordisnetwork.com/Mpi/Default.aspx',
+                'gateway_3d_host' => 'https://payfortestziraatkatilim.cordisnetwork.com/Mpi/3DHost.aspx',
+            ],
+        ],
         'garanti'               => [
             'gateway_class'     => \Mews\Pos\Gateways\GarantiPos::class,
             'credentials'       => [
@@ -161,6 +185,9 @@ return [
                 'payment_api' => 'https://sanalposprovtest.garantibbva.com.tr/VPServlet',
                 'gateway_3d'  => 'https://sanalposprovtest.garantibbva.com.tr/servlet/gt3dengine',
             ],
+            'gateway_configs' => [ // optional
+                'test_mode' => true, // test ortamı için true
+            ],
         ],
         'interpos_denizbank'    => [
             'gateway_class'     => \Mews\Pos\Gateways\InterPos::class,
@@ -186,6 +213,10 @@ return [
                 'user_name'     => 'apiXXXXXXXX', // UserName: https://kurumsal.kuveytturk.com.tr adresine login olarak kullanıcı işlemleri sayfasında APİ rolünde kullanıcı oluşturulmalıdır.
                 'enc_key'       => 'ApiXXXXXXXX', // Password: Oluşturulan APİ kullanıcısının şifre bilgisidir.
             ],
+            'gateway_configs' => [
+                // Testlerinizi SSL olmayan ortamda yapıyorsanız true yapmanız gerekir.
+                'test_mode' => true,
+            ],
             'gateway_endpoints' => [
                 'payment_api' => 'https://boatest.kuveytturk.com.tr/boa.virtualpos.services/Home',
                 'gateway_3d'  => 'https://boatest.kuveytturk.com.tr/boa.virtualpos.services/Home/ThreeDModelPayGate',

src/Factory/GatewayFactory.php

@@ -51,7 +51,10 @@ public static function create(
 
         /** @var PosInterface $gateway */
         $gateway = new $gatewayClass(
-            ['gateway_endpoints' => $options['gateway_endpoints']],
+            [
+                'gateway_endpoints' => $options['gateway_endpoints'],
+                'gateway_configs' => $options['gateway_configs'] ?? [],
+            ],
             $account,
             $requestDataMapper,
             $responseDataMapper,
@@ -61,7 +64,9 @@ public static function create(
             $logger,
         );
 
-        $gateway->setTestMode($options['test_mode'] ?? false);
+        if (!isset($options['gateway_configs']['test_mode']) && isset($options['test_mode'])) {
+            $gateway->setTestMode($options['test_mode']);
+        }
 
         return $gateway;
     }