Merge pull request #23 from flowwow/FB-1722

FB-1722 add sbp payment

Author: vatr666

src/Enum/CloudMethodsEnum.php

@@ -43,6 +43,12 @@ class CloudMethodsEnum extends Enum
     /** Отмена оплаты */
     public const PAYMENTS_VOID = 'payments/void';
 
+    /** Генерация платежной ссылки СБП */
+    public const PAYMENTS_SBP_LINK = 'payments/qr/sbp/link';
+
+    /** Генерация QR-кода СБП */
+    public const PAYMENTS_SBP_QR = 'payments/qr/sbp/image';
+
     /** Старт сессии Applepay */
     public const APPLEPAY_STARTSESSION = 'applepay/startsession';
 

src/Library.php

@@ -17,6 +17,8 @@
 use Flowwow\Cloudpayments\Request\PaymentsList;
 use Flowwow\Cloudpayments\Request\PaymentsListV2;
 use Flowwow\Cloudpayments\Request\PaymentsRefund;
+use Flowwow\Cloudpayments\Request\PaymentsSbpLink;
+use Flowwow\Cloudpayments\Request\PaymentsSbpQr;
 use Flowwow\Cloudpayments\Request\PaymentsVoid;
 use Flowwow\Cloudpayments\Request\Post3DS;
 use Flowwow\Cloudpayments\Request\Receipt\CorrectionReceiptData;
@@ -343,6 +345,30 @@ public function paymentsTokensList(?TokenList $data = null): TokenArrayResponse
         return $this->request($method, $data === null ? [] : $data->asArray(), new TokenArrayResponse());
     }
 
+    /**
+     * Создание оплаты СБП по ссылке
+     * @param PaymentsSbpLink $data
+     * @return TransactionResponse
+     */
+    public function paymentsSbpLink(PaymentsSbpLink $data): TransactionResponse
+    {
+        $method = CloudMethodsEnum::PAYMENTS_SBP_LINK;
+
+        return $this->request($method, $data->asArray(), new TransactionResponse());
+    }
+
+    /**
+     * Создание оплаты СБП по QR-коду
+     * @param PaymentsSbpQr $data
+     * @return TransactionResponse
+     */
+    public function paymentsSbpQr(PaymentsSbpQr $data): TransactionResponse
+    {
+        $method = CloudMethodsEnum::PAYMENTS_SBP_QR;
+
+        return $this->request($method, $data->asArray(), new TransactionResponse());
+    }
+
     /**
      * Метод создания подписки на рекуррентные платежи
      * @param SubscriptionCreate $data

src/Request/PaymentsSbp.php

@@ -0,0 +1,48 @@
+<?php
+
+namespace Flowwow\Cloudpayments\Request;
+
+use Flowwow\Cloudpayments\BaseRequest;
+use Flowwow\Cloudpayments\Exceptions\BadTypeException;
+
+/**
+ * Class PaymentsSbp
+ * @see https://developers.cloudpayments.ru/#sbp
+ *
+ */
+abstract class PaymentsSbp extends BaseRequest
+{
+    /**
+     * @var int|float
+     */
+    public         $amount;
+    public string  $currency;
+    public string  $description;
+    public string  $scheme;
+    public ?string $accountId;
+    public ?string $email;
+    public ?string $jsonData;
+    public ?string $invoiceId;
+    public ?string $ipAddress;
+    public ?string $successRedirectUrl;
+    public ?string $failRedirectUrl;
+    public ?int    $ttlMinutes;
+
+    /**
+     * PaymentsSbpLink constructor.
+     * @param $amount
+     * @param string $currency
+     * @param string $description
+     * @throws BadTypeException
+     */
+    public function __construct($amount, string $currency, string $description)
+    {
+        if (!is_numeric($amount)) {
+            throw new BadTypeException('Amount isn\'t numeric');
+        }
+        $this->amount      = $amount;
+        $this->currency    = $currency;
+        $this->description = $description;
+        $this->scheme      = 'charge';
+    }
+}

src/Request/PaymentsSbpLink.php

@@ -0,0 +1,13 @@
+<?php
+
+namespace Flowwow\Cloudpayments\Request;
+
+/**
+ * Class PaymentsSbpLink
+ * @package Flowwow\Cloudpayments\CardPayment
+ * @see https://developers.cloudpayments.ru/#sbp-poluchenie-ssylki-dlya-oplaty
+ *
+ */
+class PaymentsSbpLink extends PaymentsSbp
+{
+}

src/Request/PaymentsSbpQr.php

@@ -0,0 +1,13 @@
+<?php
+
+namespace Flowwow\Cloudpayments\Request;
+
+/**
+ * Class PaymentsSbpQr
+ * @package Flowwow\Cloudpayments\CardPayment
+ * @see https://developers.cloudpayments.ru/#sbp-poluchenie-qr-koda-dlya-oplaty
+ *
+ */
+class PaymentsSbpQr extends PaymentsSbp
+{
+}

src/Response/Models/SbpBankModel.php

@@ -0,0 +1,18 @@
+<?php
+
+namespace Flowwow\Cloudpayments\Response\Models;
+
+/**
+ * Class SbpBankModel
+ * @package Flowwow\Cloudpayments\Response\Models
+ */
+class SbpBankModel extends BaseModel
+{
+    public ?string $bankName            = null;
+    public ?string $logoURL             = null;
+    public ?string $schema              = null;
+    public ?string $currency            = null;
+    public ?string $package_name        = null;
+    public ?string $webClientUrl        = null;
+    public ?bool   $isWebClientActive   = null;
+}

src/Response/Models/TransactionModel.php

@@ -33,6 +33,7 @@ class TransactionModel extends BaseModel
     public ?string $confirmDateIso                        = null;
     public ?string $authCode                              = null;
     public ?bool   $testMode                              = null;
+    public ?bool   $isTest                                = null;
     public ?string $rrn                                   = null;
     public ?int    $originalTransactionId                 = null;
     public ?int    $fallBackScenarioDeclinedTransactionId = null;
@@ -72,6 +73,10 @@ class TransactionModel extends BaseModel
     public ?bool   $masterPass                            = null;
     public ?float  $totalFee                              = null;
     public ?int    $escrowAccumulationId                  = null;
+    public ?string $qrUrl                                 = null;
+    public ?string $qrImage                               = null;
+    /** @var SbpBankModel[]|null  */
+    public ?array  $sbpBankModels                         = null;
 
     /**
      * Получение переведенного кода ошибки

src/Response/TransactionResponse.php

@@ -2,6 +2,7 @@
 
 namespace Flowwow\Cloudpayments\Response;
 
+use Flowwow\Cloudpayments\Response\Models\SbpBankModel;
 use Flowwow\Cloudpayments\Response\Models\TransactionModel;
 use stdClass;
 
@@ -22,6 +23,15 @@ public function fillModel($modelDate)
     {
         $model = new TransactionModel();
         $model->fill($modelDate);
+        if (isset($modelDate->Banks->dictionary) && is_array($modelDate->Banks->dictionary)) {
+            $banks = [];
+            foreach ($modelDate->Banks->dictionary as $bankValue) {
+                $bank    = new SbpBankModel();
+                $bank->fill($bankValue);
+                $banks[] = $bank;
+            }
+            $model->sbpBankModels = $banks;
+        }
 
         $this->model = $model;
     }