Get started with the DNB PSD2 api.

The purpose if this repository is to serve as a starting point from which one can explore, and test the DnB API. This repository is based upon the Sandbox API.

Provided under MIT License by Njord Technologies.

Note: this library may be subtly broken or buggy. The code is released under the MIT License – please take the following message to heart:

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Limitations:

The code in this repository only contain code that works with the AISP section of the DNB API. Please see the TODO list at the bottom of the README if to see what features the team is working on implementing.

Requirements:

First, you should sign up at the DNB Developer portal, and read the Documentation there. There is only one requirement to get this code up and running. And it is to create, and download a certificate from here.

Installation:

1. Make sure that you have Python 3.7 or higher installed on your computer.
2. Make sure that you have pip installed.
3. Install the library by using the following command: pip install git+https://github.com/Njord-Technologies/get_started_with_psd2
4. Test that the installation of the library was successful by running the command python -m from DNB_psd2 import AISP If there are no error messages you're good to go! (Knock on wood)

Getting Started

The DNB sandbox API can be divded in three parts. These are:

• AISP - Account Information Service Provider. With this role you can list accounts, get balances and account details.
• PISP - Payment Initiation Service Provider. With this role you can initiate payments.
• PIISP - Payment Instrument Issuing Service Provider. With this role you can check if a card/account has sufficient funds for a transaction

In it's current stage, this code only supports a limited set of the API. Work is being done at broadening the capability of the code.

The AISP endpoints can be reached using AISP

from DNB_psd2 import AISP
AISP_client = AISP(PSU_ID = "Insert SSN or TB here", pem_path = "Path to the *.pem file",
                    key_path =  "Path to the *.key file")

The AISP() class collects the consent for the user.

The following SSN's(Sosial Security Number) and ID for Corporate users are accesible in the Sandbox API:

SSN/TB-ident	No. of accounts	No. of credit card accounts	Available context
31125453913	4	4	Retail
31125451740	2	6	Retail
31125459199	1	2	Retail
31125458990	3	2	Retail
31125461037	2	4	Retail
31125461118	1	2	Retail
31125452887	2	4	Retail
31125450361	3	2	Retail
31125458052	2	2	Retail
31125470982	2	2	Retail
TB76688	4	-	Corporate

AISP Methods

• accounts

# Get the accounts accosiated with the SSN/TB
AISP.accounts()

• Get account details

#Get information about a certain account.
AISP.get_account_info(bban = "Insert Account nr(bban) here")

• Get account balances

#Get balance for a certain account.
AISP.get_account_balance(bban = "Insert Account nr(bban) here")

• Get Bank Transactions

#Get the bank transactions for the spesified account
AISP.get_bank_transactions(bban = "Insert Account nr(bban) here")

• Get card accounts

#Get information about the card accounts tied to a spesific user
AISP.get_card()

• Get card transactions

#Get a list over the transactions for the spesified card account 
AISP.get_card_transactions(bban = "Insert Account nr(bban) here")