Added additional data into dispatched events

README.md

@@ -257,26 +257,7 @@ $pos = \Mews\Pos\Factory\PosFactory::createPosGateway(
 
 ## Genel Kultur
 
-### NonSecure, 3D Secure, 3DPay ve 3DHost ödeme modeller arasındaki farklar
-
-- **3DSecure** - Bankaya göre farklı isimler verilebilir, örn. 3D Full.
-  Gateway'den (3D şifre girdiginiz sayfadan) döndükten sonra ödemeyi tamamlamak
-  için
-  banka gateway'ne 1 istek daha (_provizyon_ isteği) gönderir.
-  Bu isteği göndermeden ödeme **tamamlanmaz**.
-- **3DPay** - Bankaya göre farklı isimler verilebilir, örn. 3D Half.
-  Gateway'den (3D şifre girdiginiz sayfadan) döndükten sonra ödeme bitmiş
-  sayılır.
-  3DSecure ödemede yapıldığı gibi ekstra provizyon istek gönderilmez.
-- **3DHost** - Kredi kart girişi için kullanıcı bankanın sayfasına yönledirilir,
-  kredi kart bilgileri girdikten sonra bankanın 3D gateway sayfasına
-  yönlendirilir,
-  ordan da websitenize geri yönlendirilir. Yönlendirme sonucunda ödeme
-  tamanlanmış olur.
-- **NonSecure** - Ödeme işlemi kullanıcı 3D onay işlemi yapmadan gerçekleşir.
-- **NonSecure, 3DSecure ve 3DPay** - Ödemede kredi kart bilgisi websiteniz
-  tarafından alınır.
-  **3DHost** ödemede ise banka websayfasından alınır.
+Ödeme modelleri hakkında bilgi edinmek istiyorsanız [bu makaleyi](https://medium.com/p/fa5cd016999c) inceleyebilirsiniz.
 
 ### Otorizasyon, Ön Otorizasyon, Ön Provizyon Kapama İşlemler arasındaki farklar
 

docs/PRE-AUTH-POST-EXAMPLE.md

@@ -236,8 +236,8 @@ $order = createPostPayOrder(
 /** @var \Symfony\Component\EventDispatcher\EventDispatcher $eventDispatcher */
 $eventDispatcher->addListener(
     \Mews\Pos\Event\RequestDataPreparedEvent::class,
-    function (\Mews\Pos\Event\RequestDataPreparedEvent $event) use ($gatewayClass, $preAuthAmount, $postAuthAmount) {
-        if (\Mews\Pos\Gateways\EstPos::class === $gatewayClass || \Mews\Pos\Gateways\EstV3Pos::class === $gatewayClass) {
+    function (\Mews\Pos\Event\RequestDataPreparedEvent $event) use ($preAuthAmount, $postAuthAmount) {
+        if (\Mews\Pos\Gateways\EstPos::class === $event->getGatewayClass() || \Mews\Pos\Gateways\EstV3Pos::class === $event->getGatewayClass()) {
             // ($preAuthAmount < $postAuthAmount) durumda API isteğe ekstra değerler eklenmesi gerekiyor.
             if ($preAuthAmount < $postAuthAmount) {
                 $requestData                    = $event->getRequestData();

docs/THREED-PAYMENT-EXAMPLE.md

@@ -150,8 +150,8 @@ try {
      * Bu Event'i dinleyerek 3D formun hash verisi hesaplanmadan önce formun input array içireğini güncelleyebilirsiniz.
      * Eğer ekleyeceğiniz veri hash hesaplamada kullanılmıyorsa Form verisi oluştuktan sonra da güncelleyebilirsiniz.
      */
-    $eventDispatcher->addListener(Before3DFormHashCalculatedEvent::class, function (Before3DFormHashCalculatedEvent $event) use ($pos): void {
-        if (get_class($pos) === \Mews\Pos\Gateways\EstPos::class || get_class($pos) === \Mews\Pos\Gateways\EstV3Pos::class) {
+    $eventDispatcher->addListener(Before3DFormHashCalculatedEvent::class, function (Before3DFormHashCalculatedEvent $event): void {
+        if ($event->getGatewayClass() === \Mews\Pos\Gateways\EstPos::class || $event->getGatewayClass() === \Mews\Pos\Gateways\EstV3Pos::class) {
             /**
              * Örnek 1: İşbank İmece Kart ile ödeme yaparken aşağıdaki verilerin eklenmesi gerekiyor:
                 $supportedPaymentModels = [
@@ -179,8 +179,8 @@ try {
     // KuveytVos TDV2.0.0 icin ozel biri durum
     $eventDispatcher->addListener(
         RequestDataPreparedEvent::class,
-        function (RequestDataPreparedEvent $requestDataPreparedEvent) use ($pos): void {
-            if (get_class($pos) !== \Mews\Pos\Gateways\KuveytPos::class) {
+        function (RequestDataPreparedEvent $requestDataPreparedEvent): void {
+            if ($event->getGatewayClass() !== \Mews\Pos\Gateways\KuveytPos::class) {
                 return;
             }
             // KuveytPos TDV2.0.0 icin zorunlu eklenmesi gereken ekstra alanlar:

examples/_common-codes/3d/form.php

@@ -69,8 +69,8 @@
 // KuveytVos TDV2.0.0 icin ozel biri durum
 $eventDispatcher->addListener(
     RequestDataPreparedEvent::class,
-    function (RequestDataPreparedEvent $requestDataPreparedEvent) use ($pos): void {
-        if (get_class($pos) !== \Mews\Pos\Gateways\KuveytPos::class) {
+    function (RequestDataPreparedEvent $requestDataPreparedEvent): void {
+        if ($requestDataPreparedEvent->getGatewayClass() !== \Mews\Pos\Gateways\KuveytPos::class) {
             return;
         }
         // KuveytPos TDV2.0.0 icin zorunlu eklenmesi gereken ekstra alanlar:
@@ -135,8 +135,8 @@ function (RequestDataPreparedEvent $requestDataPreparedEvent) use ($pos): void {
      * Bu Event'i dinleyerek 3D formun hash verisi hesaplanmadan önce formun input array içireğini güncelleyebilirsiniz.
      * Eger ekleyeceginiz veri hash hesaplamada kullanilmiyorsa form verisi olusturduktan sonra da ekleyebilirsiniz.
      */
-    $eventDispatcher->addListener(Before3DFormHashCalculatedEvent::class, function (Before3DFormHashCalculatedEvent $event) use ($pos): void {
-        if (get_class($pos) === \Mews\Pos\Gateways\EstPos::class || get_class($pos) === \Mews\Pos\Gateways\EstV3Pos::class) {
+    $eventDispatcher->addListener(Before3DFormHashCalculatedEvent::class, function (Before3DFormHashCalculatedEvent $event): void {
+        if ($event->getGatewayClass() === \Mews\Pos\Gateways\EstPos::class || $event->getGatewayClass() === \Mews\Pos\Gateways\EstV3Pos::class) {
             //Örnek 1: İşbank İmece Kart ile ödeme yaparken aşağıdaki verilerin eklenmesi gerekiyor:
 //                $supportedPaymentModels = [
 //                    \Mews\Pos\PosInterface::MODEL_3D_PAY,
@@ -150,7 +150,7 @@ function (RequestDataPreparedEvent $requestDataPreparedEvent) use ($pos): void {
 //                    $event->setFormInputs($formInputs);
 //                }
         }
-        if (get_class($pos) === \Mews\Pos\Gateways\EstV3Pos::class) {
+        if ($event->getGatewayClass() === \Mews\Pos\Gateways\EstV3Pos::class) {
 //                // Örnek 2: callbackUrl eklenmesi
 //                $formInputs                = $event->getFormInputs();
 //                $formInputs['callbackUrl'] = $formInputs['failUrl'];

examples/_common-codes/regular/post-auth.php

@@ -46,8 +46,8 @@ function createPostPayOrder(string $gatewayClass, array $lastResponse, string $i
 /** @var \Symfony\Component\EventDispatcher\EventDispatcher $eventDispatcher */
 $eventDispatcher->addListener(
     \Mews\Pos\Event\RequestDataPreparedEvent::class,
-    function (\Mews\Pos\Event\RequestDataPreparedEvent $event) use ($gatewayClass, $preAuthAmount, $postAuthAmount) {
-        if (\Mews\Pos\Gateways\EstPos::class === $gatewayClass || \Mews\Pos\Gateways\EstV3Pos::class === $gatewayClass) {
+    function (\Mews\Pos\Event\RequestDataPreparedEvent $event) use ($preAuthAmount, $postAuthAmount) {
+        if (\Mews\Pos\Gateways\EstPos::class === $event->getGatewayClass() || \Mews\Pos\Gateways\EstV3Pos::class === $event->getGatewayClass()) {
             if ($preAuthAmount < $postAuthAmount) {
                 $requestData                    = $event->getRequestData();
                 $requestData['Extra']['PREAMT'] = $preAuthAmount;

examples/_templates/_finish_non_secure_payment.php

@@ -22,7 +22,7 @@
 // OZEL DURUMLAR ICIN KODLAR START
 // ============================================================================================
 /** @var \Symfony\Component\EventDispatcher\EventDispatcher $eventDispatcher */
-$eventDispatcher->addListener(RequestDataPreparedEvent::class, function (RequestDataPreparedEvent $event) use ($pos) {
+$eventDispatcher->addListener(RequestDataPreparedEvent::class, function (RequestDataPreparedEvent $event) {
 //         Burda istek banka API'na gonderilmeden once gonderilecek veriyi degistirebilirsiniz.
 //         Ornek:
 //         $data = $event->getRequestData();
@@ -38,13 +38,13 @@
      * 5: Ekstre Erteleme
      * 6: Özel Vade Farkı
      */
-    if ($pos instanceof \Mews\Pos\Gateways\PosNetV1Pos) {
+    if ($event->getGatewayClass() instanceof \Mews\Pos\Gateways\PosNetV1Pos) {
         // Albaraka PosNet KOICode ekleme
         // $data            = $event->getRequestData();
         // $data['KOICode'] = '1';
         // $event->setRequestData($data);
     }
-    if ($pos instanceof \Mews\Pos\Gateways\PosNet) {
+    if ($event->getGatewayClass() instanceof \Mews\Pos\Gateways\PosNet) {
         // Yapikredi PosNet KOICode ekleme
         // $data            = $event->getRequestData();
         // $data['sale']['koiCode'] = '1';

examples/_templates/_payment_secure_response.php

@@ -36,7 +36,7 @@
 // OZEL DURUMLAR ICIN KODLAR START
 // ============================================================================================
 /** @var \Symfony\Component\EventDispatcher\EventDispatcher $eventDispatcher */
-$eventDispatcher->addListener(RequestDataPreparedEvent::class, function (RequestDataPreparedEvent $event) use ($pos) {
+$eventDispatcher->addListener(RequestDataPreparedEvent::class, function (RequestDataPreparedEvent $event) {
 //         Burda istek banka API'na gonderilmeden once gonderilecek veriyi degistirebilirsiniz.
 //         Ornek:
 //         $data = $event->getRequestData();
@@ -56,7 +56,7 @@
      * 5: Ekstre Erteleme
      * 6: Özel Vade Farkı
      */
-    if ($pos instanceof \Mews\Pos\Gateways\PosNetV1Pos && $event->getTxType() === PosInterface::TX_TYPE_PAY_AUTH) {
+    if ($event->getGatewayClass() instanceof \Mews\Pos\Gateways\PosNetV1Pos && $event->getTxType() === PosInterface::TX_TYPE_PAY_AUTH) {
         // Albaraka PosNet KOICode ekleme
         // $data            = $event->getRequestData();
         // $data['KOICode'] = '1';

src/DataMapper/RequestDataMapper/AkbankPosRequestDataMapper.php

@@ -11,6 +11,7 @@
 use Mews\Pos\Entity\Card\CreditCardInterface;
 use Mews\Pos\Event\Before3DFormHashCalculatedEvent;
 use Mews\Pos\Exceptions\NotImplementedException;
+use Mews\Pos\Gateways\AkbankPos;
 use Mews\Pos\PosInterface;
 
 /**
@@ -394,7 +395,8 @@ public function create3DFormData(AbstractPosAccount $posAccount, array $order, s
             $data['inputs'],
             $posAccount->getBank(),
             $txType,
-            $paymentModel
+            $paymentModel,
+            AkbankPos::class
         );
         $this->eventDispatcher->dispatch($event);
         $data['inputs'] = $event->getFormInputs();

src/DataMapper/RequestDataMapper/EstPosRequestDataMapper.php

@@ -10,6 +10,7 @@
 use Mews\Pos\Event\Before3DFormHashCalculatedEvent;
 use Mews\Pos\Exceptions\NotImplementedException;
 use Mews\Pos\Exceptions\UnsupportedTransactionTypeException;
+use Mews\Pos\Gateways\EstPos;
 use Mews\Pos\PosInterface;
 
 /**
@@ -243,7 +244,13 @@ public function create3DFormData(AbstractPosAccount $posAccount, array $order, s
 
         $data = $this->create3DFormDataCommon($posAccount, $preparedOrder, $paymentModel, $txType, $gatewayURL, $creditCard);
 
-        $event = new Before3DFormHashCalculatedEvent($data['inputs'], $posAccount->getBank(), $txType, $paymentModel);
+        $event = new Before3DFormHashCalculatedEvent(
+            $data['inputs'],
+            $posAccount->getBank(),
+            $txType,
+            $paymentModel,
+            EstPos::class
+        );
         $this->eventDispatcher->dispatch($event);
         $data['inputs'] = $event->getFormInputs();
 

src/DataMapper/RequestDataMapper/EstV3PosRequestDataMapper.php

@@ -7,6 +7,7 @@
 use Mews\Pos\Entity\Account\AbstractPosAccount;
 use Mews\Pos\Entity\Card\CreditCardInterface;
 use Mews\Pos\Event\Before3DFormHashCalculatedEvent;
+use Mews\Pos\Gateways\EstV3Pos;
 
 /**
  * Creates request data for EstPos Gateway requests that supports v3 Hash algorithm
@@ -27,7 +28,13 @@ public function create3DFormData(AbstractPosAccount $posAccount, array $order, s
 
         $data['inputs']['hashAlgorithm'] = 'ver3';
 
-        $event = new Before3DFormHashCalculatedEvent($data['inputs'], $posAccount->getBank(), $txType, $paymentModel);
+        $event = new Before3DFormHashCalculatedEvent(
+            $data['inputs'],
+            $posAccount->getBank(),
+            $txType,
+            $paymentModel,
+            EstV3Pos::class
+        );
         $this->eventDispatcher->dispatch($event);
         $data['inputs'] = $event->getFormInputs();
 

src/DataMapper/RequestDataMapper/GarantiPosRequestDataMapper.php

@@ -12,6 +12,7 @@
 use Mews\Pos\Entity\Card\CreditCardInterface;
 use Mews\Pos\Event\Before3DFormHashCalculatedEvent;
 use Mews\Pos\Exceptions\NotImplementedException;
+use Mews\Pos\Gateways\GarantiPos;
 use Mews\Pos\PosInterface;
 
 /**
@@ -359,7 +360,13 @@ public function create3DFormData(AbstractPosAccount $posAccount, array $order, s
             $inputs['cardcvv2']            = $creditCard->getCvv();
         }
 
-        $event = new Before3DFormHashCalculatedEvent($inputs, $posAccount->getBank(), $txType, $paymentModel);
+        $event = new Before3DFormHashCalculatedEvent(
+            $inputs,
+            $posAccount->getBank(),
+            $txType,
+            $paymentModel,
+            GarantiPos::class
+        );
         $this->eventDispatcher->dispatch($event);
         $inputs = $event->getFormInputs();
 

src/DataMapper/RequestDataMapper/InterPosRequestDataMapper.php

@@ -9,6 +9,7 @@
 use Mews\Pos\Entity\Card\CreditCardInterface;
 use Mews\Pos\Event\Before3DFormHashCalculatedEvent;
 use Mews\Pos\Exceptions\NotImplementedException;
+use Mews\Pos\Gateways\InterPos;
 use Mews\Pos\PosInterface;
 
 /**
@@ -228,7 +229,13 @@ public function create3DFormData(AbstractPosAccount $posAccount, array $order, s
             $inputs['Cvv2']     = $creditCard->getCvv();
         }
 
-        $event = new Before3DFormHashCalculatedEvent($inputs, $posAccount->getBank(), $txType, $paymentModel);
+        $event = new Before3DFormHashCalculatedEvent(
+            $inputs,
+            $posAccount->getBank(),
+            $txType,
+            $paymentModel,
+            InterPos::class
+        );
         $this->eventDispatcher->dispatch($event);
         $inputs = $event->getFormInputs();
 

src/DataMapper/RequestDataMapper/PayForPosRequestDataMapper.php

@@ -8,6 +8,7 @@
 use Mews\Pos\Entity\Account\AbstractPosAccount;
 use Mews\Pos\Entity\Card\CreditCardInterface;
 use Mews\Pos\Event\Before3DFormHashCalculatedEvent;
+use Mews\Pos\Gateways\PayForPos;
 use Mews\Pos\PosInterface;
 
 /**
@@ -237,7 +238,13 @@ public function create3DFormData(AbstractPosAccount $posAccount, array $order, s
             $inputs['Cvv2']           = $creditCard->getCvv();
         }
 
-        $event = new Before3DFormHashCalculatedEvent($inputs, $posAccount->getBank(), $txType, $paymentModel);
+        $event = new Before3DFormHashCalculatedEvent(
+            $inputs,
+            $posAccount->getBank(),
+            $txType,
+            $paymentModel,
+            PayForPos::class
+        );
         $this->eventDispatcher->dispatch($event);
         $inputs = $event->getFormInputs();
 

src/DataMapper/RequestDataMapper/PosNetV1PosRequestDataMapper.php

@@ -12,6 +12,7 @@
 use Mews\Pos\Event\Before3DFormHashCalculatedEvent;
 use Mews\Pos\Exceptions\NotImplementedException;
 use Mews\Pos\Exceptions\UnsupportedTransactionTypeException;
+use Mews\Pos\Gateways\PosNetV1Pos;
 use Mews\Pos\PosInterface;
 
 /**
@@ -386,7 +387,13 @@ public function create3DFormData(AbstractPosAccount $posAccount, array $order, s
 
         $inputs += $cardData;
 
-        $event = new Before3DFormHashCalculatedEvent($inputs, $posAccount->getBank(), $txType, $paymentModel);
+        $event = new Before3DFormHashCalculatedEvent(
+            $inputs,
+            $posAccount->getBank(),
+            $txType,
+            $paymentModel,
+            PosNetV1Pos::class
+        );
         $this->eventDispatcher->dispatch($event);
         $inputs = $event->getFormInputs();
 

src/DataMapper/ResponseDataMapper/PosNetResponseDataMapper.php

@@ -107,6 +107,7 @@ public function map3DPaymentData(array $raw3DAuthResponseData, ?array $rawPaymen
             $defaultResponse['proc_return_code'] = $procReturnCode;
             $defaultResponse['error_code']       = $raw3DAuthResponseData['respCode'];
             $defaultResponse['error_message']    = $raw3DAuthResponseData['respText'];
+            $defaultResponse['3d_all']           = $raw3DAuthResponseData;
 
             return $defaultResponse;
         }

src/Event/Before3DFormHashCalculatedEvent.php

@@ -25,21 +25,32 @@ class Before3DFormHashCalculatedEvent
     /** @var PosInterface::MODEL_3D_* */
     private string $paymentModel;
 
+    /** @var class-string<PosInterface> */
+    private string $gatewayClass;
+
     /**
      * @phpstan-param PosInterface::TX_TYPE_PAY_* $txType
      * @phpstan-param PosInterface::MODEL_3D_*    $paymentModel
+     * @phpstan-param class-string<PosInterface>  $gatewayClass
      *
      * @param array<string, string> $formInputs
      * @param string                $bank
      * @param string                $txType
      * @param string                $paymentModel
+     * @param string                $gatewayClass
      */
-    public function __construct(array $formInputs, string $bank, string $txType, string $paymentModel)
-    {
+    public function __construct(
+        array $formInputs,
+        string $bank,
+        string $txType,
+        string $paymentModel,
+        string $gatewayClass
+    ) {
         $this->formInputs   = $formInputs;
         $this->bank         = $bank;
         $this->txType       = $txType;
         $this->paymentModel = $paymentModel;
+        $this->gatewayClass = $gatewayClass;
     }
 
     /**
@@ -85,4 +96,12 @@ public function setFormInputs(array $formInputs): self
 
         return $this;
     }
+
+    /**
+     * @return class-string<PosInterface>
+     */
+    public function getGatewayClass(): string
+    {
+        return $this->gatewayClass;
+    }
 }