Merge pull request #2 from SimPaypl/feat/blik-level-0

feat: add BLIK Level 0 support

Author: PatryQHyper

README.md

@@ -264,6 +264,53 @@ Public parameters:
 - `suffix` (string or null)
 - `updatedAt` (Carbon instance or null)
 
+### Make BLIK Level 0 transaction
+```php
+// at first generate payment
+
+// only required fields are shown
+$payment = SimPay::payment()->generate()
+    ->amount(15.00)
+    ->customer(
+        new \SimPay\Laravel\Dto\Payment\CustomerData(
+            email: 'Email',
+            ip: 'IP address',
+            countryCode: 'PL', // for BLIK it must be PL
+        )
+    )
+    ->antifraud(
+        new \SimPay\Laravel\Dto\Payment\AntiFraudData(
+            userAgent: 'UserAgent (REQUIRED)',
+        )
+    )
+    ->currency('PLN')
+    ->directChannel('blik-level0') // it must be set to blik-level0
+    ->make();
+
+// Now make Level 0 call
+try {
+    $success = SimPay::payment()->blikLevel0()
+    ->ticket('111222') // BLIK code
+    ->ticketType(\SimPay\Laravel\Enums\Payment\BlikLevel0TicketType::T6) // for now, only T6 codes are supported
+    ->transaction($payment) // you may pass full TransactionGenerateResponse or just transactionId
+    ->make();
+}
+catch(\SimPay\Laravel\Exceptions\BlikLevel0\InvalidBlikTicketException $exception) {
+    // notify user that BLIK ticket is not valid
+}
+catch(\SimPay\Laravel\Exceptions\SimPayException $exception) {
+    // other error
+}
+```
+If ticket has been accepted, $success will be true.
+
+**WARNING**: This does not mean that transaction is finished, you still need to listen to our IPN messages.
+
+If ticket code is not valid, two exceptions may be thrown:
+- \SimPay\Laravel\Exceptions\BlikLevel0\InvalidBlikTicketException
+- \SimPay\Laravel\Exceptions\SimPayException
+
+
 ## Direct Billing
 
 ### Generate transaction

src/Enums/Payment/BlikLevel0TicketType.php

@@ -0,0 +1,9 @@
+<?php
+declare(strict_types=1);
+
+namespace SimPay\Laravel\Enums\Payment;
+
+enum BlikLevel0TicketType: string
+{
+    case T6 = 'T6';
+}

src/Exceptions/BlikLevel0/InvalidBlikTicketException.php

@@ -0,0 +1,10 @@
+<?php
+declare(strict_types=1);
+
+namespace SimPay\Laravel\Exceptions\BlikLevel0;
+
+use SimPay\Laravel\Exceptions\SimPayException;
+
+class InvalidBlikTicketException extends SimPayException
+{
+}

src/Services/Payment/InitiateBlikLevel0.php

@@ -0,0 +1,86 @@
+<?php
+
+namespace SimPay\Laravel\Services\Payment;
+
+use SimPay\Laravel\Enums\Payment\BlikLevel0TicketType;
+use SimPay\Laravel\Exceptions\BlikLevel0\InvalidBlikTicketException;
+use SimPay\Laravel\Exceptions\SimPayException;
+use SimPay\Laravel\Responses\TransactionGeneratedResponse;
+use SimPay\Laravel\Services\Service;
+
+final class InitiateBlikLevel0 extends Service
+{
+    private BlikLevel0TicketType $ticketType;
+    private string $ticket;
+    private string $transactionId;
+
+    /**
+     * @throws SimPayException
+     */
+    public function make(): true
+    {
+        $payload = [
+            'ticket' => [
+                $this->ticketType->value => $this->ticket,
+            ],
+        ];
+
+        $level0 = $this->sendRequest(
+            sprintf('payment/%s/blik/level0/%s', config('simpay.payment.service_id'), $this->transactionId),
+            'POST',
+            ['json' => $payload],
+        );
+
+        if ($level0->successful()) {
+            return true;
+        }
+
+        if (!$level0->badRequest()) {
+            throw new SimPayException(
+                sprintf('[%s] %s', $level0->json('errorCode', $level0->status()), $level0->json('message'))
+            );
+        }
+
+        $errorCode = $level0->json('errorCode');
+
+        if (in_array($errorCode, [
+            'INVALID_BLIK_CODE',
+            'INVALID_BLIK_CODE_FORMAT',
+            'BLIK_CODE_EXPIRED',
+            'BLIK_CODE_CANCELLED',
+            'BLIK_CODE_USED',
+            'BLIK_CODE_NOT_SUPPORTED',
+        ])) {
+            throw new InvalidBlikTicketException(sprintf('[%s] %s', $errorCode, $level0->json('message')));
+        }
+
+        throw new SimPayException(sprintf('[%s] %s', $errorCode, $level0->json('message')));
+    }
+
+    public function ticket(string $ticket): self
+    {
+        $this->ticket = $ticket;
+
+        return $this;
+    }
+
+    public function ticketType(BlikLevel0TicketType $ticketType): self
+    {
+        $this->ticketType = $ticketType;
+
+        return $this;
+    }
+
+    public function transaction(TransactionGeneratedResponse|string $transaction): self
+    {
+        if ($transaction instanceof TransactionGeneratedResponse) {
+            $this->transactionId = $transaction->transactionId;
+
+            return $this;
+        }
+
+        $this->transactionId = $transaction;
+
+        return $this;
+    }
+}

src/Services/Payment/Payment.php

@@ -59,4 +59,12 @@ public function currencies(): array
     {
         return (new ServiceCurrencies())->get();
     }
+
+    /**
+     * @throws SimPayException
+     */
+    public function blikLevel0(): InitiateBlikLevel0
+    {
+        return (new InitiateBlikLevel0());
+    }
 }

src/SimPay.php

@@ -8,7 +8,7 @@
 
 class SimPay
 {
-    public const string VERSION = '1.2.1';
+    public const string VERSION = '1.3.0';
 
     public function payment(): Payment
     {