cardCharge3ds & purchaseOffline

mysiar-org · May 21, 2022 · a1fe2d8 · a1fe2d8
2 parents a855df2 + 14e7dba
commit a1fe2d8
Show file tree

Hide file tree

Showing 61 changed files with 1,470 additions and 116 deletions.
diff --git a/README.md b/README.md
@@ -13,17 +13,19 @@
 
 ## API endpoints implemented
 
-| API endpoint                     | Gateway method   |
-|:---------------------------------|:-----------------|
-| /api/v1/testAccess               | testAccess       |
-| /api/v1/payment/methods          | methods          |
-| /api/v1/transaction/register     | purchase         |
-| /api/v1/transaction/verify       | completePurchase |
-| /api/v1/transaction/refund       | refund           |
-| /api/v1/transaction/by/sessionId | purchaseInfo     |
-| /api/v1/card/info                | cardInfo         |
-| /api/v1/card/pay                 | cardPay          |
-| /api/v1/card/charge              | cardCharge       |
+| API endpoint                        | Gateway method   |
+|:------------------------------------|:-----------------|
+| /api/v1/testAccess                  | testAccess       |
+| /api/v1/payment/methods             | methods          |
+| /api/v1/transaction/register        | purchase         |
+| /api/v1/transaction/verify          | completePurchase |
+| /api/v1/transaction/refund          | refund           |
+| /api/v1/transaction/by/sessionId    | purchaseInfo     |
+| /api/v1/card/info                   | cardInfo         |
+| /api/v1/card/pay                    | cardPay          |
+| /api/v1/card/charge                 | cardCharge       |
+| /api/v1/card/chargeWith3ds          | cardCharge3ds    |
+| /api/v1/transaction/registerOffline | purchaseOffline  |
 
 ## Install
 
@@ -39,7 +41,7 @@ The following gateways are provided by this package:
 
 * Przelewy24
 
-Reference official documentation https://developers.przelewy24.pl/index.php
+Reference official documentation https://developers.przelewy24.pl/index.php?en
 
 ## Example
 

diff --git a/ecs.php b/ecs.php
@@ -22,6 +22,7 @@
         ]]);
 
     $ecsConfig->import(SetList::SPACES);
+    $ecsConfig->import(SetList::STRICT);
     $ecsConfig->import(SetList::ARRAY);
     $ecsConfig->import(SetList::DOCBLOCK);
     $ecsConfig->import(SetList::PSR_12);

diff --git a/src/Gateway.php b/src/Gateway.php
@@ -12,6 +12,7 @@
 use Omnipay\Przelewy24\Message\CompletePurchaseRequest;
 use Omnipay\Przelewy24\Message\MethodsRequest;
 use Omnipay\Przelewy24\Message\PurchaseInfoRequest;
+use Omnipay\Przelewy24\Message\PurchaseOfflineRequest;
 use Omnipay\Przelewy24\Message\PurchaseRequest;
 use Omnipay\Przelewy24\Message\RefundsRequest;
 use Omnipay\Przelewy24\Message\TestAccessRequest;
@@ -130,6 +131,7 @@ public function methods(string $lang = 'en'): MethodsRequest
 
     /**
      * @param string[] $options
+     *
      * @return AbstractRequest|PurchaseRequest
      */
     public function purchase(array $options = []): PurchaseRequest
@@ -139,6 +141,7 @@ public function purchase(array $options = []): PurchaseRequest
 
     /**
      * @param string[] $options
+     *
      * @return AbstractRequest|CompletePurchaseRequest
      */
     public function completePurchase(array $options = []): CompletePurchaseRequest
@@ -168,6 +171,7 @@ public function cardInfo(string $transactionId): CardInfoRequest
 
     /**
      * @param string[] $options
+     *
      * @return AbstractRequest|RefundsRequest
      */
     public function refund(array $options = []): RefundsRequest
@@ -177,6 +181,7 @@ public function refund(array $options = []): RefundsRequest
 
     /**
      * @param string[] $options
+     *
      * @return AbstractRequest|CardPayRequest
      */
     public function cardPay(array $options): CardPayRequest
@@ -186,10 +191,21 @@ public function cardPay(array $options): CardPayRequest
 
     /**
      * @param string[] $options
+     *
      * @return AbstractRequest|CardChargeRequest
      */
     public function cardCharge(array $options): CardChargeRequest
     {
         return $this->createRequest(CardChargeRequest::class, $options);
     }
+
+    /**
+     * @param string[] $options
+     *
+     * @return AbstractRequest|PurchaseOfflineRequest
+     */
+    public function purchaseOffline(array $options): PurchaseOfflineRequest
+    {
+        return $this->createRequest(PurchaseOfflineRequest::class, $options);
+    }
 }
diff --git a/src/Message/AbstractRequest.php b/src/Message/AbstractRequest.php
@@ -9,6 +9,8 @@
 
 abstract class AbstractRequest extends BaseAbstractRequest
 {
+    protected const SIGN_ALGO = 'sha384';
+
     protected $liveEndpoint = 'https://secure.przelewy24.pl/api/v1/';
 
     protected $testEndpoint = 'https://sandbox.przelewy24.pl/api/v1/';
@@ -17,8 +19,6 @@ abstract class AbstractRequest extends BaseAbstractRequest
 
     protected $testRedirectEndpoint = 'https://sandbox.przelewy24.pl/';
 
-    protected const SIGN_ALGO = 'sha384';
-
     public function getMerchantId()
     {
         return $this->getParameter('merchantId');
@@ -111,6 +111,7 @@ protected function sendRequest(string $method, string $endpoint, $data): Respons
 
     /**
      * @param mixed $value
+     *
      * @throws
      */
     protected function internalAmountValue($value = null): int

diff --git a/src/Message/AbstractResponse.php b/src/Message/AbstractResponse.php
@@ -24,26 +24,42 @@ public function getCode(): int
             return (int) $this->data['code'];
         }
 
+        if (
+            ! isset($this->data['code'])
+            && isset($this->data['responseCode'])
+            && 0 !== (int) $this->data['responseCode']
+        ) {
+            return (int) $this->data['responseCode'];
+        }
+
         return Response::HTTP_OK;
     }
 
     /**
-     * @return array|string|null
+     * @return null|array|string
      */
     public function getMessage()
     {
         if (isset($this->data['error'])) {
             return $this->data['error'];
         }
 
+        if (
+            Response::HTTP_NOT_FOUND === $this->getCode()
+            && isset($this->data['data'])
+            && ! is_array($this->data['data'])
+            ) {
+            return $this->data['data'];
+        }
+
         return '';
     }
 
     public function isSuccessful(): bool
     {
         $code = $this->getCode();
 
-        return in_array($code, [Response::HTTP_CREATED, Response::HTTP_OK]);
+        return in_array($code, [Response::HTTP_CREATED, Response::HTTP_OK], true);
     }
 
     protected function getAmountFromInternal(int $amount): string
@@ -53,6 +69,7 @@ protected function getAmountFromInternal(int $amount): string
 
     /**
      * @param string[] $data
+     *
      * @return string[]
      */
     protected function replaceInfoKeys(array $data, string $oldKey, string $newKey): array

diff --git a/src/Message/CardCharge3dsRequest.php b/src/Message/CardCharge3dsRequest.php
@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Omnipay\Przelewy24\Message;
+
+class CardCharge3dsRequest extends AbstractRequest
+{
+    public function getData(): array
+    {
+        $this->validate('token');
+
+        return [
+            'token' => $this->getToken(),
+        ];
+    }
+
+    public function sendData($data): CardCharge3dsResponse
+    {
+        $httpResponse = $this->sendRequest('POST', 'card/chargeWith3ds', $data);
+
+        $responseData = json_decode($httpResponse->getBody()->getContents(), true);
+
+        return $this->response = new CardCharge3dsResponse($this, $responseData);
+    }
+}
diff --git a/src/Message/CardCharge3dsResponse.php b/src/Message/CardCharge3dsResponse.php
@@ -0,0 +1,30 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Omnipay\Przelewy24\Message;
+
+use Omnipay\Common\Message\RequestInterface;
+
+class CardCharge3dsResponse extends AbstractResponse
+{
+    /**
+     * @var null|string
+     */
+    private $transactionId = null;
+
+    public function __construct(RequestInterface $request, $data)
+    {
+        parent::__construct($request, $data);
+        if (isset($data['data'])) {
+            if (isset($data['data']['orderId'])) {
+                $this->transactionId = (string) $data['data']['orderId'];
+            }
+        }
+    }
+
+    public function getTransactionId(): ?string
+    {
+        return $this->transactionId;
+    }
+}
diff --git a/src/Message/CardChargeResponse.php b/src/Message/CardChargeResponse.php
@@ -11,7 +11,7 @@ class CardChargeResponse extends AbstractResponse
     /**
      * @var null|string
      */
-    private $transactionId = null;
+    private $transactionId;
 
     public function __construct(RequestInterface $request, $data)
     {

diff --git a/src/Message/CardInfoResponse.php b/src/Message/CardInfoResponse.php
@@ -31,6 +31,7 @@ public function getInfo(): array
 
     /**
      * @param string[] $data
+     *
      * @return string[]
      */
     private function formatInfo(array $data): array
@@ -39,8 +40,7 @@ private function formatInfo(array $data): array
 
         // replace keys
         $formatted = $this->replaceInfoKeys($formatted, 'cardType', 'brand');
-        $formatted = $this->replaceInfoKeys($formatted, 'cardDate', 'expiry');
 
-        return $formatted;
+        return $this->replaceInfoKeys($formatted, 'cardDate', 'expiry');
     }
 }
diff --git a/src/Message/CardPayResponse.php b/src/Message/CardPayResponse.php
@@ -12,12 +12,12 @@ class CardPayResponse extends AbstractResponse
     /**
      * @var null|string
      */
-    private $transactionId = null;
+    private $transactionId;
 
     /**
      * @var null
      */
-    private $redirectUrl = null;
+    private $redirectUrl;
 
     public function __construct(RequestInterface $request, $data)
     {

diff --git a/src/Message/MethodsRequest.php b/src/Message/MethodsRequest.php
@@ -29,7 +29,8 @@ public function getData(): array
 
     /**
      * @param string[] $data
-     * @return ResponseInterface|MethodsResponse
+     *
+     * @return MethodsResponse|ResponseInterface
      */
     public function sendData($data): ResponseInterface
     {

diff --git a/src/Message/PurchaseInfoResponse.php b/src/Message/PurchaseInfoResponse.php
@@ -32,7 +32,7 @@ public function getInfo(): array
 
     public function getCode(): int
     {
-        if (isset($this->data['responseCode']) && isset($this->data['error']) && strlen($this->data['error']) > 0) {
+        if (isset($this->data['responseCode'], $this->data['error']) && strlen($this->data['error']) > 0) {
             return Response::HTTP_NOT_FOUND;
         }
 
@@ -45,6 +45,7 @@ public function getCode(): int
 
     /**
      * @param string[] $data
+     *
      * @return string[]
      */
     private function formatInfo(array $data): array
@@ -61,8 +62,7 @@ private function formatInfo(array $data): array
         $formatted = $this->replaceInfoKeys($formatted, 'clientName', 'name');
         $formatted = $this->replaceInfoKeys($formatted, 'clientAddress', 'address');
         $formatted = $this->replaceInfoKeys($formatted, 'clientCity', 'city');
-        $formatted = $this->replaceInfoKeys($formatted, 'clientPostcode', 'postcode');
 
-        return $formatted;
+        return $this->replaceInfoKeys($formatted, 'clientPostcode', 'postcode');
     }
 }
diff --git a/src/Message/PurchaseOfflineRequest.php b/src/Message/PurchaseOfflineRequest.php
@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Omnipay\Przelewy24\Message;
+
+class PurchaseOfflineRequest extends AbstractRequest
+{
+    public function getData(): array
+    {
+        $this->validate('token');
+
+        return [
+            'token' => $this->getToken(),
+        ];
+    }
+
+    public function sendData($data): PurchaseOfflineResponse
+    {
+        $httpResponse = $this->sendRequest('POST', 'transaction/registerOffline', $data);
+
+        $responseData = json_decode($httpResponse->getBody()->getContents(), true);
+
+        return $this->response = new PurchaseOfflineResponse($this, $responseData);
+    }
+}
diff --git a/src/Message/PurchaseOfflineResponse.php b/src/Message/PurchaseOfflineResponse.php
@@ -0,0 +1,30 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Omnipay\Przelewy24\Message;
+
+use Omnipay\Common\Message\RequestInterface;
+
+class PurchaseOfflineResponse extends AbstractResponse
+{
+    /**
+     * @var string[]
+     */
+    private $info = [];
+
+    public function __construct(RequestInterface $request, $data)
+    {
+        parent::__construct($request, $data);
+
+        if (isset($this->data['data'])) {
+            $this->info = $this->data['data'];
+            $this->info = $this->replaceInfoKeys($this->info, 'orderId', 'transactionId');
+        }
+    }
+
+    public function getInfo(): array
+    {
+        return $this->info;
+    }
+}
diff --git a/src/Message/PurchaseRequest.php b/src/Message/PurchaseRequest.php
@@ -214,7 +214,7 @@ public function getData()
         ];
 
         return array_filter($data, function ($val) {
-            return ! is_null($val);
+            return null !== $val;
         });
     }
-Original file line number
+Diff line change
@@ Expand Up / @@ -214,7 +214,7 @@ public function getData() @@
             ];
             return array_filter($data, function ($val) {
-                return ! is_null($val);
+                return null !== $val;
             });
         }
@@ Expand Down @@