如何高效安全地集成银行账户数据？NordigenPHP客户端助你轻松搞定！

<code class="bash">composer require nordigen/nordigen-php</code>

<pre class="brush:php;toolbar:false;"><?php

require_once('vendor/autoload.php');

use Nordigen\NordigenPHP\API\NordigenClient;

// 从 GoCardless Bank Account Data Portal 获取你的 SECRET_ID 和 SECRET_KEY
$secretId  = "YOUR_SECRET_ID";
$secretKey = "YOUR_SECRET_KEY";

// 1. 初始化 Nordigen 客户端
$client = new NordigenClient($secretId, $secretKey);

// 2. 生成访问令牌（Access Token），有效期通常为24小时
// 令牌会自动注入到后续的每个请求中
$token = $client->createAccessToken();
echo "Access Token: " . $client->getAccessToken() . "\n";
echo "Refresh Token: " . $client->getRefreshToken() . "\n\n";

// 如果需要，也可以使用 refresh token 刷新令牌
// $newToken = $client->refreshAccessToken($client->getRefreshToken());

// 3. 获取支持的银行列表
// 以拉脱维亚 (LV) 为例，你可以替换为其他 ISO 3166 国家代码
$institutions = $client->institution->getInstitutionsByCountry("LV");
echo "支持的银行列表（部分）:\n";
foreach (array_slice($institutions, 0, 3) as $institution) {
    echo "- " . $institution['name'] . " (ID: " . $institution['id'] . ")\n";
}
echo "\n";

// 4. 初始化银行连接会话 (Requisition)
// 假设我们选择 Revolut，你需要替换为实际的银行 ID 和你的重定向 URI
$institutionId = "REVOLUT_REVOGB21"; // 示例 Revolut ID
$redirectUri = "https://your-app.com/nordigen-callback"; // 用户授权后重定向回你的应用地址

echo "正在初始化银行连接会话...\n";
$session = $client->initSession($institutionId, $redirectUri);

// 获取用户授权链接
$link = $session["link"];
$requisitionId = $session["requisition_id"];

echo "请用户访问此链接进行银行授权: " . $link . "\n";
echo "Requisition ID: " . $requisitionId . "\n\n";

// 此时，你的应用需要等待用户在银行页面完成授权，
// 授权成功后，银行会将用户重定向回 $redirectUri，并携带相关参数。
// 你需要在你的回调路由中处理这些参数。

// 假设用户已经授权完成，我们可以通过 requisitionId 获取账户信息
// 在实际应用中，这部分代码会在你的回调路由中执行
echo "假设用户已完成授权，正在获取账户数据...\n";
try {
    // 5. 获取 Requisition 详情，从中获取 accountId
    $requisitionData = $client->requisition->getRequisition($requisitionId);
    $accountId = $requisitionData["accounts"][0]; // 通常只有一个账户，或者选择其中一个

    echo "获取到的账户 ID: " . $accountId . "\n";

    // 6. 实例化账户对象，并获取数据
    $account = $client->account($accountId);

    $metadata = $account->getAccountMetaData();
    $balances = $account->getAccountBalances();
    $details = $account->getAccountDetails();
    $transactions = $account->getAccountTransactions();

    echo "账户元数据:\n";
    print_r($metadata);
    echo "\n账户余额:\n";
    print_r($balances);
    echo "\n账户详情:\n";
    print_r($details);
    echo "\n账户交易记录（部分）:\n";
    foreach (array_slice($transactions['booked'], 0, 3) as $transaction) {
        echo "- " . $transaction['bookingDate'] . ": " . $transaction['transactionAmount']['amount'] . " " . $transaction['transactionAmount']['currency'] . " - " . $transaction['remittanceInformationUnstructured'] . "\n";
    }

    // 也可以按日期范围筛选交易记录
    // $filteredTransactions = $account->getAccountTransactions("2023-01-01", "2023-01-31");

} catch (Exception $e) {
    echo "获取账户数据失败: " . $e->getMessage() . "\n";
}