mews/pos v1.6 update

Author: mustapayev

README.md

@@ -14,7 +14,7 @@
 
 ### Minimum Gereksinimler
 - PHP >= 7.4
-- mews/pos ^1.3
+- mews/pos ^1.6
 - laravel 8, 9, 10, 11
 
 ### Kurulum
@@ -275,7 +275,18 @@ class ThreeDSecurePaymentController extends Controller
         $session->set('tx', $transaction);
 
         try {
-            $formData = $this->pos->get3DFormData($order, $this->paymentModel, $transaction, $card);
+            $formData = $this->pos->get3DFormData(
+            $order,
+            $this->paymentModel,
+            $transaction,
+            $card,
+            /**
+            * MODEL_3D_SECURE veya MODEL_3D_PAY ödemelerde kredi kart verileri olmadan
+            * form verisini oluşturmak için true yapabilirsiniz.
+            * Yine de bazı gatewaylerde kartsız form verisi oluşturulamıyor.
+            */
+            false
+            );
         } catch (\Throwable $e) {
             dd($e);
         }
@@ -406,24 +417,28 @@ Route::match(['GET','POST'], '/payment/3d/response', [\App\Http\Controllers\Thre
 
 ```html
 <!--/resources/views/redirect-form.blade.php-->
-<form method="{{ $formData['method'] }}" action="{{ $formData['gateway'] }}"  class="redirect-form" role="form">
-    @foreach($formData['inputs'] as $key => $value)
-    <input type="hidden" name="{{ $key }}" value="{{ $value }}">
-    @endforeach
-    <div class="text-center">Redirecting...</div>
-    <hr>
-    <div class="form-group text-center">
-        <button type="submit" class="btn btn-lg btn-block btn-success">Submit</button>
-    </div>
-
-</form>
-<script>
-   // Formu JS ile otomatik submit ederek kullaniciyi banka gatewayine yonlendiriyoruz.
-   let redirectForm = document.querySelector('form.redirect-form');
-   if (redirectForm) {
-      redirectForm.submit();
-   }
-</script>
+@if(is_string($formData))
+    {!! $formData !!}
+@else
+   <form method="{{ $formData['method'] }}" action="{{ $formData['gateway'] }}"  class="redirect-form" role="form">
+      @foreach($formData['inputs'] as $key => $value)
+      <input type="hidden" name="{{ $key }}" value="{{ $value }}">
+      @endforeach
+      <div class="text-center">Redirecting...</div>
+      <hr>
+      <div class="form-group text-center">
+         <button type="submit" class="btn btn-lg btn-block btn-success">Submit</button>
+      </div>
+   
+   </form>
+   <script>
+      // Formu JS ile otomatik submit ederek kullaniciyi banka gatewayine yonlendiriyoruz.
+      let redirectForm = document.querySelector('form.redirect-form');
+      if (redirectForm) {
+         redirectForm.submit();
+      }
+   </script>
+@endif
 ```
 
 ### Troubleshoots

composer.json

@@ -23,7 +23,7 @@
 		"php": ">=7.4",
 		"illuminate/config": "^8.0|^9.0|^10.0|^11.0|^12.0",
 		"illuminate/support": "^8.0|^9.0|^10.0|^11.0|^12.0",
-		"mews/pos": "^1.3"
+		"mews/pos": "^1.6"
 	},
 	"require-dev": {
 		"orchestra/testbench": "^8.17|^9.0|^10.0|^11.0"

docs/EXAMPLE_CONFIGURATIONS.md

@@ -226,9 +226,8 @@ return [
                 'user_password' => 'XXXXXXXX', // Password: Üye işyeri şifresi
             ],
             'gateway_endpoints' => [
-                'payment_api' => 'https://cptest.vakifbank.com.tr/CommonPayment/api/RegisterTransaction',
-                'gateway_3d'  => 'https://cptest.vakifbank.com.tr/CommonPayment/api/VposTransaction',
-                'query_api'   => 'https://cptest.vakifbank.com.tr/CommonPayment/SecurePayment',
+                'payment_api' => 'https://cptest.vakifbank.com.tr/CommonPayment/api/VposTransaction',
+                'gateway_3d'  => 'https://cptest.vakifbank.com.tr/CommonPayment/api/RegisterTransaction',
             ],
         ],
         'akbankpos'             => [
@@ -259,6 +258,22 @@ return [
                 'gateway_3d_host' => 'https://prepentegrasyon.tosla.com/api/Payment/threeDSecure',
             ],
         ],
+        'parampos'              => [
+            'gateway_class'     => \Mews\Pos\Gateways\ParamPos::class,
+            'credentials'       => [
+                'payment_model' => \Mews\Pos\PosInterface::MODEL_3D_SECURE,
+                'merchant_id'   => '12345', // CLIENT_CODE Terminal ID
+                'user_name'     => 'TestUser', // CLIENT_USERNAME Kullanıcı adı
+                'user_password' => 'TestPassword', // CLIENT_PASSWORD Şifre
+                'enc_key'       => 'kjsdfk-lkjdf-kjshdf-kjhfdsk-jfhshfsdfdsjf', // GUID Üye İşyeri ait anahtarı
+            ],
+            'gateway_endpoints' => [
+                'payment_api'     => 'https://test-dmz.param.com.tr/turkpos.ws/service_turkpos_test.asmx',
+                // API URL for 3D host payment
+                'payment_api_2'   => 'https://test-pos.param.com.tr/to.ws/Service_Odeme.asmx',
+                'gateway_3d_host' => 'https://test-pos.param.com.tr/default.aspx',
+            ],
+        ],
     ],
 ];
 ```

src/Factory/AccountFactory.php

@@ -12,6 +12,7 @@
 use Mews\Pos\Gateways\GarantiPos;
 use Mews\Pos\Gateways\InterPos;
 use Mews\Pos\Gateways\KuveytPos;
+use Mews\Pos\Gateways\ParamPos;
 use Mews\Pos\Gateways\PayFlexCPV4Pos;
 use Mews\Pos\Gateways\PayFlexV4Pos;
 use Mews\Pos\Gateways\PayForPos;
@@ -131,6 +132,14 @@ public static function create(string $gatewayClass, string $name, array $credent
                     $credentials['user_name'],
                     $credentials['enc_key'],
                 );
+            case ParamPos::class:
+                return MewsPosAccountFactory::createParamPosAccount(
+                    $name,
+                    $credentials['merchant_id'],
+                    $credentials['user_name'],
+                    $credentials['user_password'],
+                    $credentials['enc_key'],
+                );
         }
 
         throw new \DomainException(