card details update

Author: Alexey Babak

src/Authorization.php

@@ -16,6 +16,9 @@ class Authorization implements AuthorizationInterface
     private bool $usePaymentPage = true;
     private string $paymentMethod = self::TYPE_CCVISAMC;
 
+    /** @var CardDetailsInterface|null Данные карты */
+    private ?CardDetailsInterface $cardDetails = null;
+
     /**
      * Создать Платёжную Авторизацию
      * @param string $paymentMethodType Метод оплаты (из справочника)
@@ -74,14 +77,33 @@ public function getPaymentMethod(): string
         return $this->paymentMethod;
     }
 
+    /** @inheritDoc */
+    public function getCardDetails(): CardDetailsInterface
+    {
+        return $this->cardDetails;
+    }
+
+    /** @inheritDoc */
+    public function setCardDetails(CardDetailsInterface $cardDetails): Authorization
+    {
+        $this->cardDetails = $cardDetails;
+        return $this;
+    }
+
     /**
      * @return array
      */
     public function arraySerialize(): array
     {
-        return [
+        $resultArray = [
             'usePaymentPage' => ($this->usePaymentPage ? 'YES' : 'NO'),
-            'paymentMethod' => $this->paymentMethod,
+            'paymentMethod'  => $this->paymentMethod,
         ];
+
+        if (!is_null($this->cardDetails)) {
+            $resultArray['cardDetails'] = $this->cardDetails->toArray();
+        }
+
+        return $resultArray;
     }
 }

src/AuthorizationInterface.php

@@ -24,6 +24,19 @@ public function getPaymentMethod(): string;
      */
     public function setUsePaymentPage(bool $isUsed) : self;
 
+    /**
+     * Получить Данные Карты
+     * @return CardDetailsInterface Данные Карты
+     */
+    public function getCardDetails(): CardDetailsInterface;
+
+    /**
+     * Установить Данные Карты
+     * @param CardDetailsInterface $cardDetails
+     * @return Authorization
+     */
+    public function setCardDetails(CardDetailsInterface $cardDetails): Authorization;
+
     /**
      * Получить Использование платёжной страницы
      * @return bool Использование платёжной страницы

src/CardDetails.php

@@ -44,7 +44,7 @@ public function getNumber(): string
     }
 
     /** @inheritDoc */
-    public function setNumber(string $number): CardDetails
+    public function setNumber(string $number): self
     {
         $this->number = $number;
         return $this;
@@ -57,7 +57,7 @@ public function getExpiryMonth(): int
     }
 
     /** @inheritDoc */
-    public function setExpiryMonth(int $expiryMonth): CardDetails
+    public function setExpiryMonth(int $expiryMonth): self
     {
         $this->expiryMonth = $expiryMonth;
         return $this;
@@ -70,8 +70,12 @@ public function getYear(): int
     }
 
     /** @inheritDoc */
-    public function setYear(int $year): CardDetails
+    public function setYear(int $year): self
     {
+        if ( $year< 1900) {
+            throw new PaymentException('Проверьте год выпуска карты');
+        }
+
         $this->year = $year;
         return $this;
     }
@@ -83,7 +87,7 @@ public function getExpiryYear(): int
     }
 
     /** @inheritDoc */
-    public function setExpiryYear(int $expiryYear): CardDetails
+    public function setExpiryYear(int $expiryYear): self
     {
         $this->expiryYear = $expiryYear;
         return $this;
@@ -96,7 +100,7 @@ public function getCvv(): int
     }
 
     /** @inheritDoc */
-    public function setCvv(int $cvv): CardDetails
+    public function setCvv(int $cvv): self
     {
         $this->cvv = $cvv;
         return $this;
@@ -109,7 +113,7 @@ public function getOwner(): string
     }
 
     /** @inheritDoc */
-    public function setOwner(string $owner): CardDetails
+    public function setOwner(string $owner): self
     {
         $this->owner = $owner;
         return $this;
@@ -122,7 +126,7 @@ public function getTimeSpentTypingNumber(): int
     }
 
     /** @inheritDoc */
-    public function setTimeSpentTypingNumber(int $timeSpentTypingNumber): CardDetails
+    public function setTimeSpentTypingNumber(int $timeSpentTypingNumber): self
     {
         $this->timeSpentTypingNumber = $timeSpentTypingNumber;
         return $this;
@@ -135,7 +139,7 @@ public function getTimeSpentTypingOwner(): int
     }
 
     /** @inheritDoc */
-    public function setTimeSpentTypingOwner(int $timeSpentTypingOwner): CardDetails
+    public function setTimeSpentTypingOwner(int $timeSpentTypingOwner): self
     {
         $this->timeSpentTypingOwner = $timeSpentTypingOwner;
         return $this;
@@ -148,7 +152,7 @@ public function getBin(): int
     }
 
     /** @inheritDoc */
-    public function setBin(int $bin): CardDetails
+    public function setBin(int $bin): self
     {
         $this->bin = $bin;
         return $this;
@@ -161,7 +165,7 @@ public function getPan(): string
     }
 
     /** @inheritDoc */
-    public function setPan(string $pan): CardDetails
+    public function setPan(string $pan): self
     {
         $this->pan = $pan;
         return $this;
@@ -174,7 +178,7 @@ public function getType(): string
     }
 
     /** @inheritDoc */
-    public function setType(string $type): CardDetails
+    public function setType(string $type): self
     {
         $this->type = $type;
         return $this;
@@ -187,9 +191,34 @@ public function getCardIssuerBank(): string
     }
 
     /** @inheritDoc */
-    public function setCardIssuerBank(string $cardIssuerBank): CardDetails
+    public function setCardIssuerBank(string $cardIssuerBank): self
     {
         $this->cardIssuerBank = $cardIssuerBank;
         return $this;
     }
-}
+
+    /** @inheritDoc */
+    public function toArray() : array
+    {
+        $resultArray = get_object_vars($this);
+
+        foreach ($resultArray as &$value) {
+            if (is_object($value) && method_exists($value, 'toArray')) {
+
+                $value = $value->toArray();
+
+            } else {
+                if (is_array($value)) {
+                    foreach ($value as &$arrayValue) {
+                        if (is_object($arrayValue) && method_exists($arrayValue, 'toArray')) {
+
+                            $arrayValue = $arrayValue->toArray();
+                        }
+                    }
+                }
+            }
+        }
+
+        return $resultArray;
+    }
+}

src/CardDetailsInterface.php

@@ -148,4 +148,18 @@ public function setCardIssuerBank(string $cardIssuerBank) : self;
      * @return string Банк, выпустивший карту
      */
     public function getCardIssuerBank() : string;
+
+    /**
+     * Получить Год Карты
+     * @return int Год Карты
+     */
+    public function getYear(): int;
+
+    /**
+     *
+     * Установить Год Карты
+     * @param int $year Год Карты
+     * @return $this Детали Карты
+     */
+    public function setYear(int $year): self;
 }