chore: misc

Author: frknasir

README.md

@@ -73,9 +73,9 @@ array(21) { ... }
 - [x] Collection subaccounts
 - [x] Payout subaccounts
 - [x] Bills
-- [ ] Remita payments
+- [x] Remita payments
 - [x] Banks
-- [ ] Misc
+- [x] Misc
 - [x] Settlements
 - [x] OTPS
 - [x] Chargebacks

src/Client.php

@@ -24,6 +24,7 @@
 use StarfolkSoftware\Flutterwave\API\Transfer;
 use StarfolkSoftware\Flutterwave\API\VirtualAccountNumber;
 use StarfolkSoftware\Flutterwave\API\VirtualCard;
+use StarfolkSoftware\Flutterwave\Concerns\MiscellaneousEndpoints;
 
 /**
  * PHP Flutterwave client.
@@ -34,6 +35,8 @@
  */
 final class Client
 {
+    use MiscellaneousEndpoints;
+    
     /** @var ClientBuilder $clientBuilder */
     private ClientBuilder $clientBuilder;
 

src/Concerns/MiscellaneousEndpoints.php

@@ -0,0 +1,114 @@
+<?php
+
+namespace StarfolkSoftware\Flutterwave\Concerns;
+
+use StarfolkSoftware\Flutterwave\HttpClient\Message\ResponseMediator;
+
+trait MiscellaneousEndpoints
+{
+    /**
+     * Retrieve balances
+     * 
+     * @param string $currency
+     * @return array
+     */
+    public function balances(string $currency = ''): array
+    {
+        $url = $currency ? "balances/{$currency}" : "balances";
+
+        $response = $this->getHttpClient()->get($url);
+
+        return ResponseMediator::getContent($response);
+    }
+
+    /**
+     * Resolves account details
+     * 
+     * @param string $accountNumber
+     * @param string $accountBank
+     * @return array
+     */
+    public function resolveAccount(string $accountNumber, string $accountBank): array
+    {
+        $response = $this->getHttpClient()->post("accounts/resolve", [
+            'json' => json_encode([
+                'account_number' => $accountNumber,
+                'account_bank' => $accountBank,
+            ])
+        ]);
+
+        return ResponseMediator::getContent($response);
+    }
+
+    /**
+     * Resolves bvn details
+     * 
+     * @param string $bvn
+     * @return array
+     */
+    public function resolveBvn(string $bvn): array
+    {
+        $response = $this->getHttpClient()->get("kyc/bvns/{$bvn}");
+
+        return ResponseMediator::getContent($response);
+    }
+
+    /**
+     * Resolves card bins
+     * 
+     * @param int $bin
+     * @return array
+     */
+    public function resolveCardBin(int $bin): array
+    {
+        $response = $this->getHttpClient()->get("card-bins/{$bin}");
+
+        return ResponseMediator::getContent($response);
+    }
+
+    /**
+     * Fetch FX rates
+     * 
+     * @param string $from
+     * @param string $to
+     * @param int $amount
+     * @return array
+     */
+    public function fxRates(string $from, string $to, int $amount): array
+    {
+        $response = $this->getHttpClient()->get("rates", [
+            'query' => json_encode([
+                'from' => $from,
+                'to' => $to,
+                'amount' => $amount
+            ])
+        ]);
+
+        return ResponseMediator::getContent($response);
+    }
+
+    /**
+     * Fetches wallet statement
+     * 
+     * @param string $from
+     * @param string $to
+     * @param string $currency
+     * @param string $type
+     * @param int $page
+     * @return array
+     */
+    public function balanceHistory(string $from, string $to, string $currency, string $type = 'C', int $page = 1): array
+    {
+        $response = $this->getHttpClient()->get("wallet/statement", [
+            'query' => json_encode([
+                'from' => $from,
+                'to' => $to,
+                'currency' => $currency,
+                'type' => $type,
+                'page' => $page
+            ])
+        ]);
+
+        return ResponseMediator::getContent($response);
+    }
+}

tests/MiscEndpointsTest.php

@@ -0,0 +1,74 @@
+<?php
+
+namespace StarfolkSoftware\Flutterwave\Tests;
+
+use Laminas\Diactoros\Response\JsonResponse;
+
+final class MiscEndpointsTest extends TestCase
+{
+    public function testBalancesCanBeRetrieved(): void
+    {
+        $this->mockClient->addResponse((new JsonResponse([
+            "status" => "success",
+        ]))->withStatus(200));
+
+        $response = $this->client()->balances();
+
+        $this->assertEquals('success', $response['status']);
+    }
+
+    public function testAccountsCanBeResolved(): void
+    {
+        $this->mockClient->addResponse((new JsonResponse([
+            "status" => "success",
+        ]))->withStatus(200));
+
+        $response = $this->client()->resolveAccount('dsdfs', 'dsdfsdf');
+
+        $this->assertEquals('success', $response['status']);
+    }
+
+    public function testBvnCanBeResolved(): void
+    {
+        $this->mockClient->addResponse((new JsonResponse([
+            "status" => "success",
+        ]))->withStatus(200));
+
+        $response = $this->client()->resolveBvn('dsdfs');
+
+        $this->assertEquals('success', $response['status']);
+    }
+
+    public function testCardBinCanBeResolved(): void
+    {
+        $this->mockClient->addResponse((new JsonResponse([
+            "status" => "success",
+        ]))->withStatus(200));
+
+        $response = $this->client()->resolveCardBin(2332);
+
+        $this->assertEquals('success', $response['status']);
+    }
+
+    public function testFxRatesCanBeRetrieved(): void
+    {
+        $this->mockClient->addResponse((new JsonResponse([
+            "status" => "success",
+        ]))->withStatus(200));
+
+        $response = $this->client()->fxRates('ngn', 'usd', 2000);
+
+        $this->assertEquals('success', $response['status']);
+    }
+
+    public function testBalanceHistoryCanBeRetrieved(): void
+    {
+        $this->mockClient->addResponse((new JsonResponse([
+            "status" => "success",
+        ]))->withStatus(200));
+
+        $response = $this->client()->balanceHistory('dsdfs', 'dfsdf', 'ngn');
+
+        $this->assertEquals('success', $response['status']);
+    }
+}