tests: add client tests

Author: bernard-ng

.github/workflows/test.yaml

@@ -0,0 +1,40 @@
+name: Tests
+on: [push]
+jobs:
+    test:
+        name: Tests
+        runs-on: ubuntu-latest
+        strategy:
+            fail-fast: false
+            matrix:
+                php: [ '8.2', '8.3' ]
+
+        steps:
+            - name: Checkout
+              uses: actions/checkout@v2
+
+            - name: Setup PHP
+              uses: shivammathur/setup-php@v2
+              with:
+                  php-version: ${{ matrix.php }}
+                  tools: composer:v2
+
+            - name: Setup cache
+              run: echo "COMPOSER_CACHE_DIR=$(composer config cache-dir)" >> $GITHUB_ENV
+
+            - name: Cache dependencies installed with composer
+              uses: actions/cache@v2
+              with:
+                  path: ${{ env.COMPOSER_CACHE_DIR }}
+                  key: php${{ matrix.php }}-composer-${{ hashFiles('**/composer.json') }}
+                  restore-keys: |
+                      php${{ matrix.php }}-composer-latest-
+
+            - name: Update composer
+              run: composer self-update
+
+            - name: Install dependencies with composer
+              run: composer install --prefer-dist --no-interaction --no-progress --optimize-autoloader --ansi
+
+            - name: Run tests
+              run: make test

CHANGELOG.md

@@ -3,6 +3,7 @@
 This changelog references the relevant changes (bug and security fixes) done
 
 ### 2.0.0 [unreleased]
+- Added: `isSuccessful` to `Transaction` class
 - Breaking Change: `pay` supports both `vpos` and `mobile` request
 - Added: `vpos` and `mobile` method to `Client`
 - Added: `VposResponse`, `Request`, `VposRequest`, `MobileRequest` class

README.md

@@ -1,7 +1,7 @@
 # Flexpay PHP
 
 ![Lint](https://github.com/devscast/flexpay/actions/workflows/lint.yaml/badge.svg)
-![Test](https://github.com/devscast/flexpay/actions/workflows/lint.yaml/badge.svg)
+![Test](https://github.com/devscast/flexpay/actions/workflows/test.yaml/badge.svg)
 [![Latest Stable Version](https://poser.pugx.org/devscast/flexpay/version)](https://packagist.org/packages/devscast/flexpay)
 [![Total Downloads](https://poser.pugx.org/devscast/flexpay/downloads)](https://packagist.org/packages/devscast/flexpay)
 [![License](https://poser.pugx.org/devscast/flexpay/license)](https://packagist.org/packages/devscast/flexpay)
@@ -35,30 +35,51 @@ $flexpay = new Flexpay(
 );
 ```
 
-### Create a Payment (Intention)
+### Create a Payment Request
 
 ```php
-use Devscast\Flexpay\Data\Currency;use Devscast\Flexpay\Request\MobileRequest;
+use Devscast\Flexpay\Data\Currency;
+use Devscast\Flexpay\Request\VposRequest;
+use Devscast\Flexpay\Request\MobileRequest;
 
-$entry = new MobileRequest(
+$mobile = new MobileRequest(
     amount: 10, // 10 USD
     currency: Currency::USD,
-    phone: "243999999999", // mandatory for mobile money
+    phone: "243999999999",
     reference: "your_unique_transaction_reference",
     description: "your_transaction_description",
     callbackUrl: "your_website_webhook_url",
 );
+
+$card = new VposRequest(
+    amount: 10, // 10 USD
+    currency: Currency::USD,
+    reference: "your_unique_transaction_reference",
+    description: "your_transaction_description",
+    callbackUrl: "your_website_webhook_url",
+    homeUrl: "your_website_home_url",
+)
 ```
 
 > **Note**: we highly recommend your `callbacks` urls to be unique for each transaction. 
 
-### Process a payment (Mobile Money)
+### Mobile Payment
 Once called, Flexpay will send a payment request to the user's mobile money account, and the user will have to confirm the payment on their phone.
 after that the payment will be processed and the callback url will be called with the transaction details.
 
 ```php
-$payment = $flexpay->pay($entry);
+$response = $flexpay->pay($mobile);
 ```
+
+### Virtual POS Payment
+You can set up card payment via VPOS features, which is typically used for online payments.
+it's a gateway that allows you to accept payments from your customers using their credit cards.
+
+```php
+$response = $flexpay->pay($card);
+// redirect to $response->url to complete the payment
+```
+
 #### **handling callback (callbackUrl, approveUrl, cancelUrl, declineUrl)**
 Flexpay will send a POST request to the defined callbackUrl and the response will contain the transaction details.
 you can use the following code to handle the callback by providing incoming data as array.
@@ -75,8 +96,3 @@ You don't trust webhook ? you can always check the transaction state by providin
 $state = $flexpay->check($payment->orderNumber);
 $state->isSuccessful(); // true or false
 ```
-
-## Features supported
-- [x] Mobile Payment Service
-- [x] Check Transaction
-- [ ] Card Payment (unstable)

composer.json

@@ -14,6 +14,11 @@
             "Devscast\\Flexpay\\": "src/"
         }
     },
+    "autoload-dev": {
+        "psr-4": {
+            "Devscast\\Flexpay\\Tests\\": "tests/"
+        }
+    },
     "authors": [
         {
             "name": "bernard-ng",