Merge branch 'ADD__webhook_example' into 'main'

FIX: Webhook.php

See merge request ypmn-public/php-api-client!21

Author: payuru

example.php

@@ -50,6 +50,7 @@
             case 'qstPrint':
             case 'SOMGetPaymentLink':
             case 'qstList':
+            case 'webhookProcessing':
                 require './src/Examples/start.php';
                 @include './src/Examples/'.$_GET['function'] . '__prepend.php';
                 require './src/Examples/'.$_GET['function'] . '.php';

example_list.php

@@ -202,4 +202,10 @@
         'docLink'  => 'https://ypmn.ru/ru/documentation/#tag/widget-integration',
         'link'  => '',
     ],
+    'webhookProcessing' => [
+        'name' => 'Обработка вебхука',
+        'about' => 'В этом примере показана обработка вебхука IPN',
+        'docLink' => 'https://ypmn.ru/ru/documentation/#tag/webhooks',
+        'link' => '',
+    ]
 ];

src/Examples/webhookProcessing.php

@@ -0,0 +1,76 @@
+<?php
+
+/**
+ * webhookProcessing.php
+ *
+ * На адрес этого файла будет приходить вебхук IPN
+ * Чтобы изменить адрес, отредактируйте параметр URL на странице
+ * https://secure.ypmn.ru/cpanel/ipn_settings.php
+ *
+ */
+
+declare(strict_types=1);
+
+// Подключим файл, в котором заданы параметры мерчанта
+include_once 'start.php';
+
+use Ypmn\Webhook;
+
+// Обрабатываем только POST запросы
+if (empty($_POST)) {
+    die();
+}
+
+// Создадим обработчик вебхука
+$webhookHandler = new Webhook();
+
+// Обработаем вебхук
+try {
+    $webhookHandler->catchJsonRequest();
+
+    $paymentResult = $webhookHandler->getPaymentResult();
+    $orderData = $webhookHandler->getOrderData();
+    $authorization = $webhookHandler->getAuthorization();
+
+
+    // Обозначим путь до папки и запишем вебхук в лог
+    $folder = __DIR__ . "/../../webhooks_log/";
+    $filename = $folder . "ypmn" . date("Y-m-d H:i:s") ."_" . uniqid() . ".log";
+
+    if (!file_exists($folder)) {
+        mkdir($folder, 0777, true);
+    }
+
+    file_put_contents($filename, json_encode([
+        "orderData" => [
+            "orderDate" => $orderData->getOrderDate(),
+            "payuPaymentReference" => $orderData->getPayuPaymentReference(),
+            "merchantPaymentReference" => $orderData->getMerchantPaymentReference(),
+            "status" => $orderData->getStatus(),
+            "currency" => $orderData->getCurrency(),
+            "amount" => $orderData->getAmount() ?? "null",
+            "commission" => $orderData->getCommission() ?? "null",
+            "loyaltyPointsAmount" => $orderData->getLoyaltyPointsAmount() ?? "null",
+            "loyaltyPointsDetails" => $orderData->getLoyaltyPointsDetails() ?? "null",
+        ],
+
+        "paymentResult" => [
+            "cardDetails" => [
+                "bin" => $paymentResult->getCardDetails()->getBin(),
+                "owner" => $paymentResult->getCardDetails()->getOwner(),
+                "pan" => $paymentResult->getCardDetails()->getPan(),
+                "type" => $paymentResult->getCardDetails()->getType(),
+                "cardIssuerBank" => $paymentResult->getCardDetails()->getCardIssuerBank(),
+            ],
+            "paymentMethod" => $paymentResult->getPaymentMethod(),
+            "paymentDate" => $paymentResult->getPaymentDate(),
+            "authCode" => $paymentResult->getAuthCode(),
+            "merchantId" => $paymentResult->getMerchantId(),
+        ],
+    ]));
+
+
+} catch (\Ypmn\PaymentException $e) {
+    // YourLogger::log(...);
+}
+

src/PaymentResult.php

@@ -152,7 +152,7 @@ public function setCardDetails(CardDetailsInterface $cardDetails): self
     }
 
     /** @inheritDoc */
-    public function getCardDetails($cardDetails) : CardDetailsInterface
+    public function getCardDetails() : CardDetailsInterface
     {
         return $this->cardDetails;
     }

src/PaymentResultInterface.php

@@ -110,11 +110,10 @@ public function setInstallmentsNumber(string $installmentsNumber): self;
     public function setCardDetails(CardDetailsInterface $cardDetails): self;
 
     /**
-     * Установить Информацию о Карте
-     * @param $cardDetails
+     * Получить информацию о Карте
      * @return CardDetailsInterface
      */
-    public function getCardDetails($cardDetails) : CardDetailsInterface;
+    public function getCardDetails() : CardDetailsInterface;
 
 
     /**