mirror of
https://github.com/invoiceninja/invoiceninja.git
synced 2024-11-11 05:32:39 +01:00
111 lines
3.7 KiB
PHP
111 lines
3.7 KiB
PHP
<?php
|
|
/**
|
|
* Invoice Ninja (https://invoiceninja.com).
|
|
*
|
|
* @link https://github.com/invoiceninja/invoiceninja source repository
|
|
*
|
|
* @copyright Copyright (c) 2023. Invoice Ninja LLC (https://invoiceninja.com)
|
|
*
|
|
* @license https://www.elastic.co/licensing/elastic-license
|
|
*
|
|
* Documentation of Api-Usage: https://developer.gocardless.com/bank-account-data/overview
|
|
*/
|
|
|
|
namespace App\Helpers\Bank\Nordigen;
|
|
|
|
use App\Exceptions\NordigenApiException;
|
|
use App\Helpers\Bank\Nordigen\Transformer\AccountTransformer;
|
|
use App\Helpers\Bank\Nordigen\Transformer\TransactionTransformer;
|
|
use Log;
|
|
use Nordigen\NordigenPHP\Exceptions\NordigenExceptions\NordigenException;
|
|
|
|
class Nordigen
|
|
{
|
|
public bool $test_mode; // https://developer.gocardless.com/bank-account-data/sandbox
|
|
|
|
public string $sandbox_institutionId = "SANDBOXFINANCE_SFIN0000";
|
|
|
|
protected \Nordigen\NordigenPHP\API\NordigenClient $client;
|
|
|
|
public function __construct(string $secret_id, string $secret_key)
|
|
{
|
|
|
|
$this->test_mode = config('ninja.nordigen.test_mode');
|
|
|
|
$this->client = new \Nordigen\NordigenPHP\API\NordigenClient($secret_id, $secret_key);
|
|
|
|
$this->client->createAccessToken(); // access_token is valid 24h -> so we dont have to implement a refresh-cycle
|
|
|
|
}
|
|
|
|
// metadata-section for frontend
|
|
public function getInstitutions()
|
|
{
|
|
if ($this->test_mode)
|
|
return (array) $this->client->institution->getInstitution($this->sandbox_institutionId);
|
|
|
|
return $this->client->institution->getInstitutions();
|
|
}
|
|
|
|
// requisition-section
|
|
public function createRequisition(string $redirect, string $initutionId, string $reference)
|
|
{
|
|
if ($this->test_mode && $initutionId != $this->sandbox_institutionId)
|
|
throw new \Exception('invalid institutionId while in test-mode');
|
|
|
|
return $this->client->requisition->createRequisition($redirect, $initutionId, null, $reference); // we dont reuse existing requisitions, to prevent double usage of them. see: deleteAccount
|
|
}
|
|
|
|
public function getRequisition(string $requisitionId)
|
|
{
|
|
return $this->client->requisition->getRequisition($requisitionId);
|
|
}
|
|
|
|
// TODO: return null on not found
|
|
public function getAccount(string $account_id)
|
|
{
|
|
|
|
$out = new \stdClass();
|
|
|
|
$out->data = $this->client->account($account_id)->getAccountDetails()["account"];
|
|
$out->metadata = $this->client->account($account_id)->getAccountMetaData();
|
|
$out->balances = $this->client->account($account_id)->getAccountBalances()["balances"];
|
|
$out->institution = $this->client->institution->getInstitution($out->metadata["institution_id"]);
|
|
|
|
$it = new AccountTransformer();
|
|
return $it->transform($out);
|
|
|
|
}
|
|
|
|
public function isAccountActive(string $account_id)
|
|
{
|
|
|
|
try {
|
|
$account = $this->client->account($account_id)->getAccountMetaData();
|
|
|
|
if ($account["status"] != "READY")
|
|
return false;
|
|
|
|
return true;
|
|
} catch (\Exception $e) {
|
|
// TODO: check for not-found exception
|
|
return false;
|
|
}
|
|
|
|
}
|
|
|
|
/**
|
|
* this method returns booked transactions from the bank_account, pending transactions are not part of the result
|
|
* @todo @turbo124 should we include pending transactions within the integration-process and mark them with a specific category?!
|
|
*/
|
|
public function getTransactions(string $accountId, string $dateFrom = null)
|
|
{
|
|
|
|
$transactionResponse = $this->client->account($accountId)->getAccountTransactions($dateFrom);
|
|
|
|
$it = new TransactionTransformer();
|
|
return $it->transform($transactionResponse);
|
|
|
|
}
|
|
}
|