AIS
Upon your user consent, TransactionLink connects to their bank to download their data.

The AIS app can be configured to follow two different flows.
Every flow returns different data, and it's up to you to decide which one suits your use-case.
In this flow the user is redirected to the bank's website, where he consents for the data download.
This flow is the most common choice as it provides more robustness.
However, it doesn't provide detailed personal data like personal identity number, so it's KYC capabilities are limited.
In this flow all the interactions happen within TransactionLink's widget.
The data download happens only once and transactions history is limited to three months.
On the other hand you're able to get more of the personal data for example identity number.
Field | Type | Description |
---|---|---|
firstName | String | First name of the person |
lastName | String | Last name of the person |
personalIdentityNumber | String | Personal Identity Number of the person |
personAddresses | Object | Object containing person's addresses |
citizenship | String | Citizenship of the person |
gender | String | Gender of the person |
birthDate | String | Date of birth of the person |
resourceType | String | Type of the resource |
personAddresses table:
Field | Type | Description |
---|---|---|
registry | Object | Object containing registry address |
registry table:
Field | Type | Description |
---|---|---|
city | String | City name |
country | String | Country name |
postalCode | String | Postal code |
street | String | Street name and number |
Field | Type | Description |
---|---|---|
id | String | Unique identifier of the account. |
number | String | Account number. |
name | String | Account name. |
openedAt | String | Date when the account was opened. |
currency | String | Currency of the account. |
availableBalance | Number | Available balance in the account. |
bookingBalance | Number | Booking balance in the account. |
overdraftLimit | Number | Overdraft limit of the account. |
bic | String | Bank Identifier Code of the bank where the account is held. |
bankName | String | Name of the bank where the account is held. |
transactions | Array | List of transactions associated with the account. |
Field | Type | Description |
---|---|---|
id | String | Unique identifier of the transaction. |
accountId | String | Unique identifier of the account associated with the transaction. |
amount | Number | Amount of the transaction. |
currency | String | Currency of the transaction. |
title | String | Title of the transaction. |
tradedAt | String | Date and time when the transaction was made. |
status | String | Status of the transaction. |
accountNumber | String | Account number of the counterparty. |
description | String | Description of the transaction. |
bookedAt | String | Date and time when the transaction was booked. |
counterpartyAccount | String | Account number of the counterparty. |
counterpartyName | String | Name of the counterparty. |
counterpartyBic | String | Bank Identifier Code of the counterparty. |
counterpartyBankName | String | Name of the counterparty bank. |
category | String | Category of the transaction. |
postTransactionBalance | Number | Balance after the transaction was made. |
{
"ais": {
"identity": {
"firstName": "Anna",
"lastName": "Nowak",
"personalIdentityNumber": "81021118350",
"personAddresses": {
"registry": {
"city": "Pcim",
"country": "Poland",
"postalCode": "32-432",
"street": "Pcim 143"
}
},
"citizenship": "Poland",
"gender": "M",
"birthDate": "1981-02-11",
"resourceType": "PERSON"
},
"accounts": [
{
"id": "ad09b363-8614-4b4a-820a-e9f325043932",
"number": "PL28114020040000330279698727",
"name": "Konto Firmowe",
"openedAt": "2017-10-15T15:26:26.752Z",
"currency": "PLN",
"availableBalance": 18965887,
"bookingBalance": 18965887,
"overdraftLimit": 0,
"bic": "IEEAPLPAXXX",
"bankName": "Idea Bank S.A.",
"transactions": [
{
"id": "e2867fc8-fddf-4157-ab64-aba306e9674e",
"accountId": "ad09b363-8614-4b4a-820a-e9f325043932",
"amount": 7795,
"currency": "PLN",
"title": "Faktura za wynajem",
"tradedAt": "2022-04-20T19:47:12.966Z",
"status": "DONE",
"accountNumber": "PL28114020040000330279698727",
"description": "additional info",
"bookedAt": "2022-04-20T19:47:12.966Z",
"counterpartyAccount": "PL23116022600319418058981335",
"counterpartyName": "Sklep Alexander",
"counterpartyBic": "IEEAPLPAXXX",
"counterpartyBankName": "Bank Millenium SA",
"category": "TRANSFER",
"postTransactionBalance": 6613.29
},
]
}
]
}
}
Last modified 1mo ago