nordigen_integration 1.2.0

Dart/Flutter Package for Nordigen EU PSD2 AISP Integration, with relevant Data Models.

nordigen_integration

Development of a Null Safe Dart/Flutter Package for Nordigen EU PSD2 AISP Integration with relevant Data Models, proper encapsulation with the exposing of parameters, and succinct documentation.

For more information about the API view Nordigen's Account Information API documentation.

Find Package on Official Dart Pub:

Usage Steps

1. Go through the Nordigen's Account Information API documentation.

2. Register and get the API Access Token from https://ob.nordigen.com.

3. Initialise the NordigenAccountInfoAPI Class with the token recieved from Step 2.

4. Call any of the NordigenAccountInfoAPI Class methods to directly interact with Nordigen Server's endpoints while having the internal requests and relevant headers abstracted, based on your need.

5. Utilize any of the available Data Classes to modularly and sufficiently store and process the information during any of the API usage steps. The Data Classes have functionality to be constructed fromMap() and to be easily converted back toMap() as well as to be serialized, at any point.

---

Available Methods

1. NordigenAccountInfoAPI({required String accessToken}) (Class constuctor)

   Call it with accessToken parameter which is the access token recieved from https://ob.nordigen.com/, to access API features.

   Analogous to Step 1 of Account Information API documentation.

2. getBanksForCountry({required String countryCode})

   Gets the ASPSPs (Banks) in the Country represented by the given two-letter countryCode (ISO 3166).

   Analogous to Step 2 of Account Information API documentation.

3. createEndUserAgreement({required String endUserID, String? aspspID, ASPSP? aspsp, int maxHistoricalDays = 90})

   Creates an End User Agreement for the given endUserID, aspspID (or aspsp) and for the given maxHistoricalDays (default 90 days) and returns the resulting EndUserAgreementModel.

   Both aspspID and aspsp can not be NULL.If both are NOT NULL, ID of aspsp will be prefereed.

   Analogous to Step 3 of Account Information API documentation.

4. createRequisition({required String endUserID, required String redirect, required String reference, List<String> agreements = const <String>[]})

   Create a Requisition for the given endUserID and returns the resulting RequisitionModel. reference is additional layer of unique ID. Should match Step 3 if done. redirect is the link where the end user will be redirected after finishing authentication in ASPSP. agreements is as an array of ID(s) from Step 3 or empty array if that step was skipped.

   Analogous to Step 4.1 of Account Information API documentation.

5. fetchRedirectLinkForRequisition({String? aspspID, String? requisitionID, ASPSP? aspsp, RequisitionModel? requisition})

   Provides a redirect link to the Requisition passed in for the given ASPSP.

   Both aspspID and aspsp can not be NULL. If both are NOT NULL, ID of aspsp will be prefereed.

   Both requisitionID and requisition can not be NULL. If both are NOT NULL, ID of requisition will be prefereed.

   Analogous to Step 4.2 of Account Information API documentation.

6. getRequisition({required String requisitionID})

   Gets the Requisition identified by requisitionID.

7. getEndUserAccountIDs({required String requisitionID})

   Gets the Account IDs of the User for the Requisition identified by requisitionID.

   Analogous to Step 5 of Account Information API documentation.

8. getAccountDetails({required String accountID})

   Gets the Details of the Bank Account identified by accountID.

   Analogous to Step 6 of Account Information API documentation for Account Details.

9. getAccountTransactions({required String accountID})

   Gets the Transactions of the Bank Account identified by accountID.

   Analogous to Step 6 of Account Information API documentation for Account Transactions.

10. getAccountBalances({required String accountID})

    Gets the Balances of the Bank Account identified by accountID.

    Analogous to Step 6 of Account Information API documentation for Account Balances.

---

Available Data Classes

1. ASPSP({required String id, required String name, String bic = '', int transactionTotalDays = 90, required List<String> countries})

   ASPSP (Bank) Data Model for Nordigen. Contains the id of the ASPSP, its name, bic and the countries associated with the ASPSP.

2. EndUserAgreementModel({required String id, String created, String? accepted, int maxHistoricalDays = 90, int accessValidForDays = 90, required String endUserID, required String aspspID}):

   End-user Agreement Data Model for Nordigen. Contains the id of the Agreement, its created time string, accepted, the number of maxHistoricalDays and accessValidForDays, and the endUserID and aspspID relevant to the Agreement.

3. RequisitionModel({required String id, required String redirectURL, required String reference, String status = '', List<String> agreements = const <String>[], List<String> accounts = const <String>[], required String endUserID}):

   Requisition Data Model for Nordigen. Contains the id of the Requisition, its status, end-user agreements, the redirectURL to which it should redirect, reference ID if any, accounts associated, and the associated endUserID.

4. BankAccountDetails({required String id, String created, String? lastAccessed, required String iban, required String aspspIdentifier, String status = ''}):

   Bank Account Data Model. Contains the id of the Bank Account, its created and lastAccessed date and time, iban, status and the aspspIdentifier identifiying its ASPSP.

5. TransactionData({required String id, String? debtorName, Map<String, dynamic>? debtorAccount, String? bankTransactionCode, String bookingDate = '', String valueDate = '', required String transactionAmount, String? remittanceInformationUnstructured = ''}):

   Transaction Data Model for Nordigen. Contains the id of the Transaction, its debtorName and bankTransactionCode, bookingDate and valueDate as String, transactionAmount as TransactionAmountData and its remittanceInformationUnstructured.

   TransactionAmountData({required String amount, required String currency}) is a simple Class that holds the transaction amount and the currency type.

---

Example Usage

import 'package:nordigen_integration/nordigen_integration.dart';

void main() async {
    /// Step 1
    final NordigenAccountInfoAPI apiInterface = NordigenAccountInfoAPI(
        accessToken: 'YOUR_TOKEN',
    );

    /// Step 2 and then selecting the first ASPSP
    final ASPSP firstBank =
        (await apiInterface.getBanksForCountry(countryCode: 'gb')).first;

    /// Step 4.1
    final RequisitionModel requisition = await apiInterface.createRequisition(
        endUserID: 'exampleEndUser',
        redirect: 'http://www.yourwebpage.com/',
        reference: 'exampleReference420',
    );

    /// Step 4.2
    final String redirectLink =
        await apiInterface.fetchRedirectLinkForRequisition(
        requisition: requisition,
        aspsp: firstBank,
    );

    /// Open and Validate [redirectLink] and proceed with other functionality.
    print(redirectLink);
}

---

Dependencies

http is used for making API calls to the Nordigen Server Endpoints with proper response and error handling.

---

Getting Started

This project is a starting point for a Dart package, a library module containing code that can be shared easily across multiple Flutter or Dart projects.

For help getting started with Flutter, view our online documentation, which offers tutorials,samples, guidance on mobile development, and a full API reference.