Version | Date | Author | Comments |
---|---|---|---|
2.0.0 | 24 Jul 2017 | Open Banking Open Data API Team | This is the baseline version. |
2.1.0 | 21 Aug 2017 | Open Banking Open Data API Team | This release incorporates all known issues with 2.0.0 up to 18 Aug 2017. Please see the release notes for details. |
2.1.1 | 12 Oct 2017 | Open Banking Open Data API Team | For CCC, this release is identical to v2.1.0 API. Please see the 2.1.0 release notes for details. The MIG is from v2.2 (as recommended by PMG) |
This specification includes all relevant artefacts for the Open Data Business SME Commercial Credit Cards (CCC) API Specification.
Currently, price comparison websites have to obtain their CCC 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 SME markets.
This endpoint can contain multiple brands owned by a particular banking group. Each brand can own multiple SME Commercial Credit Card products.
This section covers CCC attributes that will change only under rare circumstances (see CoreProduct section for additional attributes that will be updated regularly).
The following information can be provided:-
Within our design, we have a concept of a "marketing state" for the product. This concept is required because for any "On Sale" CCC product:-
We'll illustrate this with an example.
CMA9Bank has a CCC product that was first advertised on 1/1/2017 and has the following features currently:-
If the card accountholder takes the product, they are offered:
The original marketing states can be shown as follows:-
Identification | PredecessorID | MarketingState | FirstMarketedDate | LastMarketedDate | StateTenureLength | StateTenurePeriod | Notes |
CP1 |
| Promotional | 1/1/2017 | 31/12/9999 | 9 | Month | When an accountholder opens the CCC, they will receive an initial promotional offer lasting 9 months. Attached to this state will be the original initial promotional interest rate information (0% Balance transfer rate, 0% Purchase rate) |
CP2 | CP1 | Promotional | 1/1/2017 | 31/12/9999 | 12 | Month | 9 months after the account has been opened, the customers promotional offer lasting a further 3months is (0% Balance transfer and regular 15.9% Purchase rate) |
CR1 | CP2 | Regular | 1/1/2017 | 31/12/9999 |
|
| After the promotional period has expired, the accountholder will be moved to the regular interest rate for both balance and purchases) |
On 17th July, CMA9Bank are going to change the offer, so that purchase rate are charged at 2% in the first 9 months. The marketing states on 16th July will look like this:-
Identification | PredecessorID | MarketingState | FirstMarketedDate | LastMarketedDate | StateTenureLength | StateTenurePeriod | Notes |
CP1 |
| Promotional | 1/1/2017 | 16/7/2017 | 9 | Month | When an accountholder opens the CCC, they will receive an initial promotional offer lasting 9 months. Attached to this state will be the original initial promotional interest rate information. (0% Balance transfer rate, 0% Purchase rate) |
CP2 | CP1 | Promotional | 1/1/2017 | 31/12/9999 | 12 | Month | 9 months after the account has been opened, the customers promotional offer lasting a further 3months is (0% Balance transfer and regular 15.9% Purchase rate) |
CR1 | CP2 | Regular | 1/1/2017 | 31/12/9999 |
|
| After the promotional period has expired, the accountholder will be moved to the regular interest rate for both balance and purchases) |
CP3 |
| Promotional | 17/7/2017 | 31/12/9999 | 9 | Month | When an accountholder opens the CCC, they will receive an initial promotional offer lasting 9 months. Attached to this state will be the original initial promotional interest rate information. (0% Balance transfer rate, 2% Purchase rate) |
And on the 17th July, the marketing states will look like this:-
Identification | PredecessorID | MarketingState | FirstMarketedDate | LastMarketedDate | StateTenureLength | StateTenurePeriod | Notes |
CP2 | CP3 | Promotional | 1/1/2017 | 31/12/9999 | 12 | Month | 9 months after the account has been opened, the customers promotional offer lasting a further 3months is (0% Balance transfer and regular 15.9% Purchase rate) |
CR1 | CP2 | Regular | 1/1/2017 | 31/12/9999 |
|
| After the promotional period has expired, the accountholder will be moved to the regular interest rate for both balance and purchases) |
CP3 |
| Promotional | 17/7/2017 | 31/12/9999 | 9 | Month | When an accountholder opens the CCC, they will receive an initial promotional offer lasting 9 months. Attached to this state will be the original initial promotional interest rate information. (0% Balance transfer rate, 2% Purchase rate) |
Notes:
This sections includes information that can change relatively often. Information to be provided includes:-
Minimum Payment
This is the minimum payment that has to be paid every period ( typically every month ). This amount is the larger of the MinBalanceRepaymentRate applied to the outstanding statement balance or the MinBalanceRepaymentAmount.
Repayment Allocation
The mechanism of allocating of charges for any outstanding balance on a statement may differ between banks. Each bank may apply charges differently to the different balance buckets and hence accruing different charges at different rates. For example an outstanding balance on a credit card statement could be broken down to:
In order for a TPP to offer a service to recommend the a credit it would be necessary to include information on:
This clarification has to be supplied by each Bank in the Notes section ( see TDA decision 059 - https://openbanking.atlassian.net/wiki/display/WOR/059)
An example from the LBG website: ( https://www.lloydsbank.com/credit-cards/terms-and-conditions/credit-cards-terms.asp )
B7.4 How we apply your payments
We use your payments to clear any overdue amounts before we apply them to your latest minimum payment.
We will reduce the amount you owe in the following order:
We use your payments to pay off balances charged at the highest interest rate first and so on down to balances with the lowest interest rates. This means the more expensive balances are always paid off first.
If there is more than one type of balance at the same interest rate, they are paid off in the following order: cash transactions, purchases, balance transfers and money transfers, and then default charges (plus any interest or charges incurred as a result of those balances). For each type of balance, your payments will pay off the oldest balance (and related fees, charges or insurance) first.
Non Repayment Fee Charges
Examples
Use the notes field to indicate what balance type you are allocating the fee to, as well as, indicating how interest is charged on the fee.
Key Fees & Charges that a customer has to pay can be specified in the Core Product, Repayment and Features & Benefits sections (see above).
The long tail of additional fees & charges that are not associated any of the above areas can be specified in this section.
Details as to any capping (i.e. maximum amount that can be charged to a customer for a particular period) for any fee/charge can also be specified in this section.
Examples could be:
Use the notes field to indicate what balance type you are allocating the fee to, as well as, indicating how interest is charged on the fee.
In order to get a CCC a mix of qualifications are required for both the Business and Business owners. For example:
Note eligibility criteria for features & benefits are treated in that section.
Specify any restrictions on Transferring a Balance from another Card in the Notes.
In this section, information about any inherent product features or value-added benefits (whether they're charged or not) can be captured.
Benefits can also be grouped together e.g. if a package of benefits is supplied. For any benefits group, benefit details may be individually added or notes simply added to the benefits group.
For a benefits group or for individual benefits, any eligibility criteria required to obtain that benefit can be specified as notes.
The following UML Class Diagram provides the hierarchical structure of the message in a graphical form, which is easier to digest.
The message implementation guide (MIG) is designed to assist the implementers of the messaging specification by providing worked examples as to how the message fields should be completed in different scenarios.
The intention is that this will better ensure consistency. This guide should be read alongside the data dictionary which provides fuller information about the rules, constraints and guidelines that should be adhered to when populating the fields.
The format that is used in this document for field value assignment is:-
[] enclose a set of field values. Where there are multiple records for a particular field, I depict this as [<record 1 value1>,< record 1 value2>…<recordn valuen>], whilst where I’m showing that there is 1 field value in 1 record, and another field value in a 2nd record, I depict this as [<record1 value1>],[<record 2 value 1>],[<record 3 value 3>], seperates individual field values within a field value set.
“ surrounds a text or date field value.
We are choosing different accounts based on how fully they test each section of the design.
Before implementing the message standard, it is useful browsing the current market leading price comparison websites (e.g. https://www.moneysupermarket.com/business-finance/business-credit-cards-explained/, http://www.knowyourmoney.co.uk/business-credit-cards-guide/) to understand how implementation of our standard by the CMA9 banks would help to more easily facilitate provision of information used on those sites.
Currently, price comparison websites have to obtain their CCC 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.
Example: HSBC Business Credit Card |
(1) Marketing State
Example: After 43 months, the rate on balance transfers will go from 0 to 15.9% After 6 months, the rate on purchases will go from 0% to 15.9% Notes:
We use the StateTenureLength and StateTenurePeriod to indicate the period of time during which the Account Holder experiences a particular offering. We use the FirstMarketedState and LastMarketedState to indicate the period of time during which a complete set of offerings is advertised. |
Example: HSBC Business Credit Card Minimum Payment: The sum of:the interest for the period from the last statement; any fees and charges; 1.5% of the full amount you owe us as shown on your monthly statement rounded to the nearest pound above minimum £5 or your statement balance if it is lower. Notes: 1. It is an industry standard that interest and any fees and charges have to be paid off, and that the minimum payment will either be the outstanding balance or the maximum of a specified rate or minimum payment amount, but this can be specified in the notes, as in the example above. |
Example: HSBC Business Credit Card Late Payment: £12 Returned Payment: £5 |
Example: HSBC Business Credit Card Purchases: 15.9% variable Cash Advances: 15.9% variable, handling fee 1% (minimum £3) Non-Sterling Transaction Fee: 2.99% |
Example: Santander Business Credit Card You can apply for a credit card if:-
|
Example: Business Rewards with Barclays Business Credit Card Essentials
Marketing
Entertainment
|