Merge branch 'YP-1933__platezhi-po-svobodnym-rekvizitam' into 'main'

YP-1933__platezhi-po-svobodnym-rekvizitam

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

Author: payuru

src/Details.php

@@ -102,6 +102,29 @@ public function setReceipts($receipts): self
         return $this;
     }
 
+    /**
+     * Получить массив объектов получателей по свободным реквизитам
+     *
+     * @return Receiver[]|null
+     */
+    public function getReceivers(): ?array
+    {
+        return $this->valuesContainer['receivers'] ?? null;
+    }
+
+    /**
+     * Установить получателей для оплаты по свободным реквизитам
+     *
+     * @param Receiver[] $receivers
+     * @return self
+     */
+    public function setReceivers(?array $receivers): self
+    {
+        $this->valuesContainer['receivers'] = $receivers;
+
+        return $this;
+    }
+
 
 
     /**

src/Examples/authorize.php

@@ -144,6 +144,35 @@
             'utm_content'  => @$_REQUEST['utm_content'],  //'Идентификатор конкретного рекламного экземпляра'
         ]));
     }
+    //Пример добавления получателей для оплаты по свободным реквизитам
+    if (!empty(@$_REQUEST['receivers'])) {
+        $details->setReceivers([
+            new \Ypmn\Receiver(
+                'sku123-1',
+                '044525225',
+                '30101810400000000225',
+                '40702810121340952493',
+                'Иванов Иван Иванович',
+                '1234567890',
+                '123456789',
+                'Оплата за товар {{persAcc}} {{period}}',
+                '1234567890',
+                '01/2023'
+            ),
+            new \Ypmn\Receiver(
+                'sku123-2',
+                '044030785',
+                '30101810300000000785',
+                '40702810410849746412',
+                'Петров Петр Петрович',
+                '123456789012',
+                '123456788',
+                'Оплата за услугу {{persAcc}}',
+                '0987654321',
+                '02/2023'
+            ),
+        ]);
+    }
 
     // Новая оплата с токенизацией (необязательно), или оплата токеном
     if (@$_REQUEST['section'] === 'new_payment_and_tokenization') {

src/Examples/authorize_form.php

@@ -113,6 +113,13 @@ class='form-control mb-3 w-100'
                             Сплитование (разделение платежа между получателями)
                         </label>
                     </div>
+
+                    <div class='form-check mb-3'>
+                        <input name='receivers' value='yes' class='form-check-input' type='checkbox' id='receivers'>
+                        <label class='form-check-label' for='receivers'>
+                            Оплата по свободным реквизитам
+                        </label>
+                    </div>
                 </div>
             </div>
 

src/Receiver.php

@@ -0,0 +1,71 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Ypmn;
+
+use DateTimeZone;
+
+class Receiver implements \JsonSerializable
+{
+    private string $sku;
+    private string $bic;
+    private string $correspondentAccount;
+    private string $account;
+    private string $name;
+    private string $inn;
+    private string $kpp;
+    private string $purpose;
+    private string $personalAccount;
+    private string $period;
+
+    public function __construct(
+        string $sku,
+        string $bic,
+        string $correspondentAccount,
+        string $account,
+        string $name,
+        string $inn,
+        string $kpp,
+        string $purpose,
+        string $personalAccount,
+        string $period
+    ) {
+        $this->sku = $sku;
+        $this->bic = $bic;
+        $this->correspondentAccount = $correspondentAccount;
+        $this->account = $account;
+        $this->name = $name;
+        $this->inn = $inn;
+        $this->kpp = $kpp;
+        $this->purpose = $purpose;
+        $this->personalAccount = $personalAccount;
+
+        if (preg_match('~^(0[1-9]|1[0-2])\/\d{4}$~', $period)) {
+            throw new PaymentException('Аргумент period имеет неверный формат');
+        }
+
+        $this->period = $period;
+    }
+
+    public function toArray(): array
+    {
+        return [
+            'sku' => $this->sku,
+            'bic' => $this->bic,
+            'correspondentAccount' => $this->correspondentAccount,
+            'account' => $this->account,
+            'name' => $this->name,
+            'inn' => $this->inn,
+            'kpp' => $this->kpp,
+            'purpose' => $this->purpose,
+            'personalAccount' => $this->personalAccount,
+            'period' => $this->period
+        ];
+    }
+
+    public function jsonSerialize()
+    {
+        return $this->toArray();
+    }
+}