1. User Journey
Specifications allowing API providers (e.g. banks, building societies and ATM providers) to develop API endpoints which can then be accessed by API users (e.g. third party developers) to build mobile and web applications for banking users/customers.
This use case includes all relevant artifacts for the Open Data API Specification. Currently, price comparison websites have to obtain their product data either via bank proprietary APIs, via information collected by dedicated data capture agencies or via "screen scraping" (i.e. capturing product web page information and writing scripts to extract relevant data). This work is complex and prone to error, so having a standard API would make the data capture side much easier and allow more third-party providers to provide applications that could target particular consumer markets. This endpoint can contain multiple brands owned by a particular banking group. Each brand can own multiple products. The user journey begins with a product details request by the AISP. ASPSP returns a collection of products and services requested by the AISP.
2. List of Products and Services covered
For the purpose of Bahrain’s open banking the following list of products and services to be shared by the ASPSPs (Banks) to the AISP upon their request for sharing product details
S. No. | Product | Field Name | Description |
1 | Current account, savings account (including foreign currency account and cash management account) | Product Details | |
Category name | Product category name used by TPPs to call in the APIs | ||
Category code | Product category code used by the TPPs to call in the APIs | ||
Product description | A brief description of the product | ||
Product code | Product Code for Banks operational purpose | ||
Sub product code | Sub-Product Code for Banks operational purpose | ||
Product URL | Product URL | ||
Segment | Product segment such as retail, SME, business, etc. | ||
Features | |||
Currency | Payment and transaction currency as applicable on the selected loan type | ||
Min. balance maintenance | Minimum balance to be maintained by the account holder in BHD | ||
Handling fees/supplementary fees | Account handling fees applicable for products in BHD excluding taxes per annum | ||
Over draft limit | Limit offered by banks for the user/customer based on turnover and spending levels in BHD per month | ||
Interest rates | Interest payable on repayment of the loan amount | ||
Deposit rate | Interest rate applicable for deposits only | ||
Min. deposit amount | Minimum one time deposit amount in BHD | ||
2 | Investment/Deposits accounts | Account Number | Bank Account number |
Account Type | Type of account as classified by the ASPSP (eg. Savings Account, Current account) | ||
Product type description | Full description of the product | ||
Account Name | Full account name | ||
Branch Name | Branch Name | ||
Account status | One of ‘active’/’inactive’/'dormant'/’frozen’ (A/I/D/F) | ||
Account Closed | Y or N | ||
Account currency | Currency code | ||
Rate | Interest rate / profit rate for islamic banks | ||
Initial deposit amount | Initial deposit amount | ||
Deposit terms- Months | Deposit terms in months (in case of years convert to months) | ||
Deposit terms - Days | Deposit term in days | ||
Maturity Amount | Maturity Amount | ||
Maturity Date | Maturity Date | ||
IBAN | IBAN account number | ||
ExchangeRate | Conversion rate in case of foreign currency (to BHD). In case the currency of the account is BHD, value will be 1.000 | ||
Account opening date | Account opening date | ||
Account closing date | If the account is closed then Account closed date should be available. | ||
Joint holders CPRs | List of joint account holder CPRs | ||
3 | Loans (including financing products and overdraft facilities) | Account Number | Bank Account number |
Account Type | Type of account as classified by the ASPSP (eg. Savings Account, Current account) | ||
Product type description | Full description of the product | ||
Account Name | Full account name | ||
Branch Name | Branch Name | ||
Account status | One of ‘active’/’inactive’/'dormant'/’frozen’ (A/I/D/F) | ||
Account Closed | Y or N | ||
Account currency | Currency code | ||
Rate | Interest rate / profit rate for islamic banks | ||
Loan Amount | Initial Loan Amount | ||
Disbursed Amount | Disbursed Amount till date | ||
Outstanding Loan Amount | Outstanding Loan Amount | ||
No. of installments | Number of installments | ||
Loan terms- Months | Deposit terms in months (in case of years convert to months) | ||
Deposit terms - Days | Deposit term in days | ||
IBAN | IBAN account number | ||
ExchangeRate | Conversion rate in case of foreign currency (to BHD). In case the currency of the account is BHD, value will be 1.000 | ||
Account opening date | Account opening date | ||
Account closing date | If the account is closed then Account closed date should be available. | ||
Joint holders CPRs | List of joint account holder CPRs | ||
4 | Credit cards (including debit cards, prepaid cards and E Wallets) | Card Number | Card number (Masked card details) |
Card Issuer | Card issuer (e.g VISA) | ||
Card Type | Primary or Secondary | ||
Product type description | Full description of the product | ||
Card Name | Full name as on the Card | ||
Branch Name | Branch Name | ||
Card status | One of ‘active’/’inactive’/'dormant'/’frozen’ (A/I/D/F) | ||
Card Closed | Y or N | ||
Card currency | Currency code | ||
Card Balance | Card Balance | ||
Rate | Interest rate / profit rate for islamic banks | ||
Card Limit | Card Limit | ||
Minimum Due | Minimum Amount payable | ||
Total Due | Total Amount payable | ||
Payment Due date | Payment Due date | ||
Add on cards | Number of add-on cards (supplementary cards) | ||
ExchangeRate | Conversion rate in case of foreign currency (to BHD). In case the currency of the account is BHD, value will be 1.000 | ||
Card Issue date | Card Issue date | ||
Card closing date | If the Card is closed then Account closed date should be available |