Merge pull request #198 from mewebstudio/181-vakif-katilim-entegrasyonu

181 vakif katilim entegrasyonu
mewebstudio · Apr 23, 2024 · fa5db28 · fa5db28
2 parents 37261e1 + 7e470e5
commit fa5db28
Show file tree

Hide file tree

Showing 60 changed files with 5,283 additions and 203 deletions.
diff --git a/README.md b/README.md
diff --git a/config/pos_production.php b/config/pos_production.php
@@ -157,5 +157,14 @@
                 'query_api'   => 'https://boa.kuveytturk.com.tr/BOA.Integration.WCFService/BOA.Integration.VirtualPos/VirtualPosService.svc?wsdl',
             ],
         ],
+        'vakif-katilim' => [
+            'name'              => 'Vakıf Katılım',
+            'class'             => Mews\Pos\Gateways\VakifKatilimPos::class,
+            'gateway_endpoints' => [
+                'payment_api'     => 'https://boa.vakifkatilim.com.tr/VirtualPOS.Gateway/Home',
+                'gateway_3d'      => 'https://boa.vakifkatilim.com.tr/VirtualPOS.Gateway/Home/ThreeDModelPayGate',
+                'gateway_3d_host' => 'https://boa.vakifkatilim.com.tr/VirtualPOS.Gateway/CommonPaymentPage/CommonPaymentPage',
+            ],
+        ],
     ],
 ];
diff --git a/config/pos_test.php b/config/pos_test.php
@@ -105,5 +105,14 @@
                 'query_api'   => 'https://boatest.kuveytturk.com.tr/BOA.Integration.WCFService/BOA.Integration.VirtualPos/VirtualPosService.svc?wsdl',
             ],
         ],
+        'vakif-katilim' => [
+            'name'              => 'Vakıf Katılım',
+            'class'             => Mews\Pos\Gateways\VakifKatilimPos::class,
+            'gateway_endpoints' => [
+                'payment_api'     => 'https://boa.vakifkatilim.com.tr/VirtualPOS.Gateway/Home',
+                'gateway_3d'      => 'https://boa.vakifkatilim.com.tr/VirtualPOS.Gateway/Home/ThreeDModelPayGate',
+                'gateway_3d_host' => 'https://boa.vakifkatilim.com.tr/VirtualPOS.Gateway/CommonPaymentPage/CommonPaymentPage',
+            ],
+        ],
     ],
 ];
diff --git a/docs/CANCEL-EXAMPLE.md b/docs/CANCEL-EXAMPLE.md
@@ -59,6 +59,11 @@ function createCancelOrder(string $gatewayClass, array $lastResponse, string $ip
         $cancelOrder['auth_code']       = $lastResponse['auth_code'];
         $cancelOrder['transaction_id']  = $lastResponse['transaction_id'];
         $cancelOrder['amount']          = $lastResponse['amount'];
+    } elseif (\Mews\Pos\Gateways\VakifKatilimPos::class === $gatewayClass) {
+        $cancelOrder['remote_order_id']  = $lastResponse['remote_order_id']; // banka tarafındaki order id
+        $cancelOrder['amount']           = $lastResponse['amount'];
+        // on otorizasyon islemin iptali icin PosInterface::TX_TYPE_PAY_PRE_AUTH saglanmasi gerekiyor
+        $cancelOrder['transaction_type'] = $lastResponse['transaction_type'] ?? PosInterface::TX_TYPE_PAY_AUTH;
     } elseif (\Mews\Pos\Gateways\PayFlexV4Pos::class === $gatewayClass || \Mews\Pos\Gateways\PayFlexCPV4Pos::class === $gatewayClass) {
         // çalışmazsa $lastResponse['all']['ReferenceTransactionId']; ile denenmesi gerekiyor.
         $cancelOrder['transaction_id'] = $lastResponse['transaction_id'];

diff --git a/docs/HISTORY-EXAMPLE.md b/docs/HISTORY-EXAMPLE.md
@@ -52,6 +52,14 @@ function createHistoryOrder(string $gatewayClass, array $extraData): array
             // odeme tarihi
             'transaction_date'  => $extraData['transaction_date'] ?? new \DateTimeImmutable(),
         ];
+    } elseif (\Mews\Pos\Gateways\VakifKatilimPos::class === $gatewayClass) {
+        $txTime = new \DateTimeImmutable();
+        $order  = [
+            'page'       => 1,
+            'page_size'  => 20,
+            'start_date' => $txTime->modify('-1 day'),
+            'end_date'   => $txTime->modify('+1 day'),
+        ];
     }
 
     return $order;

diff --git a/docs/ORDER-HISTORY-EXAMPLE.md b/docs/ORDER-HISTORY-EXAMPLE.md
@@ -67,6 +67,14 @@ function createOrderHistoryOrder(string $gatewayClass, array $lastResponse): arr
             'currency' => $lastResponse['currency'],
             'ip'       => '127.0.0.1',
         ];
+    } elseif (\Mews\Pos\Gateways\VakifKatilimPos::class === $gatewayClass) {
+        /** @var DateTimeImmutable $txTime */
+        $txTime = $lastResponse['transaction_time'];
+        $order  = [
+            'auth_code'  => $lastResponse['auth_code'],
+            'start_date' => $txTime->modify('-1 day'),
+            'end_date'   => $txTime->modify('+1 day'),
+        ];
     }
 
     return $order;

diff --git a/docs/REFUND-EXAMPLE.md b/docs/REFUND-EXAMPLE.md
@@ -57,6 +57,11 @@ function createRefundOrder(string $gatewayClass, array $lastResponse, string $ip
         $refundOrder['remote_order_id'] = $lastResponse['remote_order_id']; // banka tarafındaki order id
         $refundOrder['auth_code']       = $lastResponse['auth_code'];
         $refundOrder['transaction_id']  = $lastResponse['transaction_id'];
+    } elseif (\Mews\Pos\Gateways\VakifKatilimPos::class === $gatewayClass) {
+        $refundOrder['remote_order_id']  = $lastResponse['remote_order_id']; // banka tarafındaki order id
+        $refundOrder['amount']           = $lastResponse['amount'];
+        // on otorizasyon islemin iadesi icin PosInterface::TX_TYPE_PAY_PRE_AUTH saglanmasi gerekiyor
+        $refundOrder['transaction_type'] = $lastResponse['transaction_type'] ?? PosInterface::TX_TYPE_PAY_AUTH;
     } elseif (\Mews\Pos\Gateways\PayFlexV4Pos::class === $gatewayClass || \Mews\Pos\Gateways\PayFlexCPV4Pos::class === $gatewayClass) {
         // çalışmazsa $lastResponse['all']['ReferenceTransactionId']; ile denenmesi gerekiyor.
         $refundOrder['transaction_id'] = $lastResponse['transaction_id'];

diff --git a/examples/_common-codes/regular/cancel.php b/examples/_common-codes/regular/cancel.php
@@ -25,6 +25,11 @@ function createCancelOrder(string $gatewayClass, array $lastResponse, string $ip
         $cancelOrder['auth_code']       = $lastResponse['auth_code'];
         $cancelOrder['transaction_id']  = $lastResponse['transaction_id'];
         $cancelOrder['amount']          = $lastResponse['amount'];
+    } elseif (\Mews\Pos\Gateways\VakifKatilimPos::class === $gatewayClass) {
+        $cancelOrder['remote_order_id']  = $lastResponse['remote_order_id']; // banka tarafındaki order id
+        $cancelOrder['amount']           = $lastResponse['amount'];
+        // on otorizasyon islemin iptali icin PosInterface::TX_TYPE_PAY_PRE_AUTH saglanmasi gerekiyor
+        $cancelOrder['transaction_type'] = $lastResponse['transaction_type'] ?? PosInterface::TX_TYPE_PAY_AUTH;
     } elseif (\Mews\Pos\Gateways\PayFlexV4Pos::class === $gatewayClass || \Mews\Pos\Gateways\PayFlexCPV4Pos::class === $gatewayClass) {
         // çalışmazsa $lastResponse['all']['ReferenceTransactionId']; ile denenmesi gerekiyor.
         $cancelOrder['transaction_id'] = $lastResponse['transaction_id'];

diff --git a/examples/_common-codes/regular/history.php b/examples/_common-codes/regular/history.php
@@ -17,7 +17,18 @@ function createHistoryOrder(string $gatewayClass, array $extraData): array
     if (PayForPos::class === $gatewayClass) {
         $order = [
             // odeme tarihi
-            'transaction_date'  => $extraData['transaction_date'] ?? new \DateTimeImmutable(),
+            'transaction_date' => $extraData['transaction_date'] ?? new \DateTimeImmutable(),
+        ];
+    } elseif (\Mews\Pos\Gateways\VakifKatilimPos::class === $gatewayClass) {
+        $txTime = new \DateTimeImmutable();
+        $order  = [
+            'page'       => 1,
+            'page_size'  => 20,
+            /**
+             * Tarih aralığı maksimum 90 gün olabilir.
+             */
+            'start_date' => $txTime->modify('-1 day'),
+            'end_date'   => $txTime->modify('+1 day'),
         ];
     }
 

diff --git a/examples/_common-codes/regular/order_history.php b/examples/_common-codes/regular/order_history.php
@@ -39,6 +39,17 @@ function createOrderHistoryOrder(string $gatewayClass, array $lastResponse): arr
             'currency' => $lastResponse['currency'],
             'ip'       => '127.0.0.1',
         ];
+    } elseif (\Mews\Pos\Gateways\VakifKatilimPos::class === $gatewayClass) {
+        /** @var DateTimeImmutable $txTime */
+        $txTime = $lastResponse['transaction_time'];
+        $order  = [
+            'auth_code'  => $lastResponse['auth_code'],
+            /**
+             * Tarih aralığı maksimum 90 gün olabilir.
+             */
+            'start_date' => $txTime->modify('-1 day'),
+            'end_date'   => $txTime->modify('+1 day'),
+        ];
     }
 
     return $order;

diff --git a/examples/_common-codes/regular/refund.php b/examples/_common-codes/regular/refund.php
@@ -24,6 +24,11 @@ function createRefundOrder(string $gatewayClass, array $lastResponse, string $ip
         $refundOrder['remote_order_id'] = $lastResponse['remote_order_id']; // banka tarafındaki order id
         $refundOrder['auth_code']       = $lastResponse['auth_code'];
         $refundOrder['transaction_id']  = $lastResponse['transaction_id'];
+    } elseif (\Mews\Pos\Gateways\VakifKatilimPos::class === $gatewayClass) {
+        $refundOrder['remote_order_id']  = $lastResponse['remote_order_id']; // banka tarafındaki order id
+        $refundOrder['amount']           = $lastResponse['amount'];
+        // on otorizasyon islemin iadesi icin PosInterface::TX_TYPE_PAY_PRE_AUTH saglanmasi gerekiyor
+        $refundOrder['transaction_type'] = $lastResponse['transaction_type'] ?? PosInterface::TX_TYPE_PAY_AUTH;
     } elseif (\Mews\Pos\Gateways\PayFlexV4Pos::class === $gatewayClass || \Mews\Pos\Gateways\PayFlexCPV4Pos::class === $gatewayClass) {
         // çalışmazsa $lastResponse['all']['ReferenceTransactionId']; ile denenmesi gerekiyor.
         $refundOrder['transaction_id'] = $lastResponse['transaction_id'];

diff --git a/examples/_templates/_header.php b/examples/_templates/_header.php
@@ -38,6 +38,7 @@
                 <li> <a href="<?= $hostUrl ?>/posnet-ykb/index.php">PosNet (YKB)</a></li>
                 <li> <a href="<?= $hostUrl ?>/posnet-v1/index.php">PosNetV1 (Albaraka)</a></li>
                 <li> <a href="<?= $hostUrl ?>/kuveytpos/index.php">KuveytPOS</a></li>
+                <li> <a href="<?= $hostUrl ?>/vakif-katilim/index.php">VakifKatilimPos</a></li>
             </ul>
         </nav>
     </div>

diff --git a/examples/vakif-katilim/3d-host/_config.php b/examples/vakif-katilim/3d-host/_config.php
@@ -0,0 +1,22 @@
+<?php
+
+use Mews\Pos\PosInterface;
+
+require '../_payment_config.php';
+
+$baseUrl = $bankTestsUrl.'/3d-host/';
+//account bilgileri kendi account bilgilerinizle degistiriniz
+$account = \Mews\Pos\Factory\AccountFactory::createKuveytPosAccount(
+    'vakif-katilim',
+    '1',
+    'APIUSER',
+    '11111',
+    'kdsnsksl',
+);
+
+$pos = getGateway($account, $eventDispatcher);
+
+$transaction = PosInterface::TX_TYPE_PAY_AUTH;
+
+$templateTitle = '3D Host Model Payment';
+$paymentModel = PosInterface::MODEL_3D_HOST;
diff --git a/examples/vakif-katilim/3d-host/index.php b/examples/vakif-katilim/3d-host/index.php
@@ -0,0 +1,3 @@
+<?php
+
+require '../../_common-codes/3d-host/index.php';
diff --git a/examples/vakif-katilim/3d-host/response.php b/examples/vakif-katilim/3d-host/response.php
@@ -0,0 +1,3 @@
+<?php
+
+require '../../_templates/_payment_secure_response.php';
diff --git a/examples/vakif-katilim/3d/_config.php b/examples/vakif-katilim/3d/_config.php
@@ -0,0 +1,22 @@
+<?php
+
+use Mews\Pos\PosInterface;
+
+require '../_payment_config.php';
+
+$baseUrl = $bankTestsUrl.'/3d/';
+//account bilgileri kendi account bilgilerinizle degistiriniz
+$account = \Mews\Pos\Factory\AccountFactory::createKuveytPosAccount(
+    'vakif-katilim',
+    '1',
+    'APIUSER',
+    '11111',
+    'kdsnsksl',
+);
+
+$pos = getGateway($account, $eventDispatcher);
+
+$transaction = $session->get('tx', PosInterface::TX_TYPE_PAY_AUTH);
+
+$templateTitle = '3D Model Payment';
+$paymentModel = \Mews\Pos\PosInterface::MODEL_3D_SECURE;
diff --git a/examples/vakif-katilim/3d/form.php b/examples/vakif-katilim/3d/form.php
@@ -0,0 +1,3 @@
+<?php
+
+require '../../_common-codes/3d/form.php';
diff --git a/examples/vakif-katilim/3d/index.php b/examples/vakif-katilim/3d/index.php
@@ -0,0 +1,3 @@
+<?php
+
+require '../../_common-codes/3d/index.php';
diff --git a/examples/vakif-katilim/3d/response.php b/examples/vakif-katilim/3d/response.php
@@ -0,0 +1,3 @@
+<?php
+
+require '../../_templates/_payment_secure_response.php';
diff --git a/examples/vakif-katilim/_payment_config.php b/examples/vakif-katilim/_payment_config.php
@@ -0,0 +1,19 @@
+<?php
+
+use Mews\Pos\Entity\Card\CreditCardInterface;
+
+require __DIR__.'/../_main_config.php';
+
+$bankTestsUrl = $hostUrl.'/vakif-katilim';
+$posClass     = \Mews\Pos\Gateways\VakifKatilimPos::class;
+
+$testCards = [
+    'visa1' => [
+        'number' => '4155650100416111',
+        'year'   => '25',
+        'month'  => '1',
+        'cvv'    => '123',
+        'name'   => 'John Doe',
+        'type'   => CreditCardInterface::CARD_TYPE_VISA,
+    ],
+];
diff --git a/examples/vakif-katilim/index.php b/examples/vakif-katilim/index.php
@@ -0,0 +1,6 @@
+<?php
+
+$templateTitle = 'Vakif Katilim POS';
+require './_payment_config.php';
+require '../_templates/_header.php';
+require '../_templates/_footer.php';
diff --git a/examples/vakif-katilim/regular/_config.php b/examples/vakif-katilim/regular/_config.php
@@ -0,0 +1,20 @@
+<?php
+
+use Mews\Pos\PosInterface;
+
+require '../_payment_config.php';
+
+$baseUrl = $bankTestsUrl.'/regular/';
+
+$account = \Mews\Pos\Factory\AccountFactory::createKuveytPosAccount(
+    'vakif-katilim',
+    '1',
+    'APIUSER',
+    '11111',
+    'kdsnsksl',
+);
+
+$pos = getGateway($account, $eventDispatcher);
+
+$templateTitle = 'Regular Payment';
+$paymentModel = PosInterface::MODEL_NON_SECURE;
diff --git a/examples/vakif-katilim/regular/cancel.php b/examples/vakif-katilim/regular/cancel.php
@@ -0,0 +1,3 @@
+<?php
+
+require '../../_common-codes/regular/cancel.php';
diff --git a/examples/vakif-katilim/regular/form.php b/examples/vakif-katilim/regular/form.php
@@ -0,0 +1,3 @@
+<?php
+
+require '../../_common-codes/regular/form.php';
diff --git a/examples/vakif-katilim/regular/history.php b/examples/vakif-katilim/regular/history.php
@@ -0,0 +1,3 @@
+<?php
+
+require '../../_common-codes/regular/history.php';
diff --git a/examples/vakif-katilim/regular/index.php b/examples/vakif-katilim/regular/index.php
@@ -0,0 +1,3 @@
+<?php
+
+require '../../_common-codes/3d/index.php';
diff --git a/examples/vakif-katilim/regular/order_history.php b/examples/vakif-katilim/regular/order_history.php
@@ -0,0 +1,3 @@
+<?php
+
+require '../../_common-codes/regular/order_history.php';
diff --git a/examples/vakif-katilim/regular/refund.php b/examples/vakif-katilim/regular/refund.php
@@ -0,0 +1,3 @@
+<?php
+
+require '../../_common-codes/regular/refund.php';
diff --git a/examples/vakif-katilim/regular/status.php b/examples/vakif-katilim/regular/status.php
@@ -0,0 +1,3 @@
+<?php
+
+require '../../_common-codes/regular/status.php';
diff --git a/src/Crypt/AbstractCrypt.php b/src/Crypt/AbstractCrypt.php
@@ -69,7 +69,7 @@ public function hashFromParams(string $storeKey, array $data, string $hashParams
      *
      * @return string
      */
-    protected function hashString(string $str): string
+    public function hashString(string $str): string
     {
         return \base64_encode(\hash(static::HASH_ALGORITHM, $str, true));
     }

diff --git a/src/Crypt/CryptInterface.php b/src/Crypt/CryptInterface.php
@@ -9,6 +9,13 @@
 
 interface CryptInterface
 {
+    /**
+     * @param string $str
+     *
+     * @return string
+     */
+    public function hashString(string $str): string;
+
     /**
      * check hash of 3D secure response
      *

diff --git a/src/Crypt/GarantiPosCrypt.php b/src/Crypt/GarantiPosCrypt.php
@@ -86,7 +86,7 @@ public function createHash(AbstractPosAccount $posAccount, array $requestData):
      *
      * @return string
      */
-    protected function hashString(string $str): string
+    public function hashString(string $str): string
     {
         return $this->hashStringUpperCase($str, self::HASH_ALGORITHM);
     }

diff --git a/src/Crypt/KuveytPosCrypt.php b/src/Crypt/KuveytPosCrypt.php
@@ -56,8 +56,9 @@ public function createHash(AbstractPosAccount $posAccount, array $requestData):
 
         $hashData = [
             $posAccount->getClientId(),
-            $requestData['MerchantOrderId'],
-            $requestData['Amount'],
+            // non-payment request may not have MerchantOrderId and Amount fields
+            $requestData['MerchantOrderId'] ?? '',
+            $requestData['Amount'] ?? '',
             $posAccount->getUsername(),
             $hashedPassword,
         ];
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		<?php

		require '../../_common-codes/3d-host/index.php';
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		<?php

		require '../../_templates/_payment_secure_response.php';
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		<?php

		require '../../_common-codes/3d/form.php';
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		<?php

		require '../../_common-codes/3d/index.php';
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		<?php

		require '../../_common-codes/regular/cancel.php';
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		<?php

		require '../../_common-codes/regular/form.php';
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		<?php

		require '../../_common-codes/regular/history.php';
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		<?php

		require '../../_common-codes/regular/order_history.php';
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		<?php

		require '../../_common-codes/regular/refund.php';
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		<?php

		require '../../_common-codes/regular/status.php';