Implementation Guide: Capital One

Implementation Guide: Capital One

This page has been created and maintained by the relevant ASPSP, and OBIE takes no liability for the completeness nor accuracy of this data.

Note to ASPSP: Please indicate which brands this applies to and/or duplicate this page per brand if relevant.

 

ASPSP

Capital One (Europe)

Brand

Capital One

Date

 

Developer portal (s)

https://open-banking-developer.capitalone.co.uk/

Announcements:

Improvement

Delivery date

Improvement

Delivery date

Addition of Statement Endpoints to Capital One's Open Banking offering.

 Dec 13, 2023 

Change to Production:

Improvement

Delivery date

Improvement

Delivery date

Summary: Addition of Statement Endpoints to Capital One's Open Banking offering.

  • Data will be provided in JSON format only. Further details are available on our developer portal

 

Dec 13, 2023 

Summary: We will limit the access to Transaction data to 90 days without SCA

Solution

  • Following customer authentication, access to more than 90 days worth of transaction data will be possible for up to a 5 minute window. After this has elapsed or for any information requests without a customer authentication journey, Capital One will proactively trim any requests for more than 90 days worth of data.

TPP Changes

  • For this reason, as of 234th August 2023, if you require data older than 90 days you must request it following a successful customer authentication journey. You must also make the request within a 5 minute period following Capital One receiving confirmation that customer authentication has been completed.

Aug 24, 2023 



On-boarding

Supports dynamic client registration (Y/N)

Y

Instructions for manual onboarding

N/A

OIDC .well-known endpoint

https://integrations.capitalone.co.uk/.well-known/openid-configuration

Notes on testing

TPPs must be registered with the Open Banking Directory

Other on-boarding notes

  • There is currently no support for Client Management

  • SSA must be issued by Open Banking

  • redirect_uris MUST match or be a subset of the software_redirect_uris claim in the SSA

  • See well-known endpoint for supported configurations

  • When onboarding if any challenges arise please contact ukdevelopersupport@capitalone.com

  • private_key_jwt must be specified as the the token_endpoint_auth_method

Documentation URL

 

https://open-banking-developer.capitalone.co.uk/

Account Information API

Note to ASPSP: Please add a column per brand if relevant

Swagger version

v3

Base URI

https://open-banking.capitalone.co.uk/open-banking/v3.1/aisp

General variances to specification 

Time format - our interface supports the following data time format 2011-12-03T10:15:30

Non-functional limitations

Pagination is not supported

API Call Limits - Our interface implements rate-limiting on TPP data requests where the Customer is not present (as indicated by x-fapi-customer-ip-address header) where reached a 429 response will be returned.

Ref

Area

Endpoints

Notes

Ref

Area

Endpoints

Notes

 

Account Access Consents

POST /account-access-consents

GET /account-access-consents/{consentId}

DELETE /account-access-consents/{consentId}

 

Supported Permissions:

Note: These align with the data endpoints supported by our API implementation, other permissions other than list will be rejected.

 

Accounts

GET /accounts

GET /accounts/{accountId}

The following fields will be included in the response where appropriate

Data.Account.AccountId
Data.Account.Currency
Data.Account.AccountType
Data.Account.AccountSubType
Data.Account.Description
Data.Account.Account
Data.Account.Account.SchemeName        // always UK.OBIE.PAN
Data.Account.Account.Identification           // last four of masked PAN
Data.Account.Account.Name

We do not support any optional fields

 

Balances

GET /balances

GET /balances/{accountId}

The following fields will be included in the response where appropriate

Data.Balance.AccountId
Data.Balance.CreditDebitIndicator
Data.Balance.Type                    // only support OpeningBooked
Data.Balance.DateTime
Data.Balance.Amount
Data.Balance.Amount.Amount
Data.Balance.Amount.Currency
Data.Balance.CreditLine
Data.Balance.CreditLine.Types

We do not support any optional fields

 

Statements

GET /Statements

GET /accounts/{AccountId}/statements

GET /accounts/{AccountId}/statements/{StatementId}

The following fields will be included in the response where appropriate

Data.Statement.AccountId 
Data.Statement.CreationDateTime
Data.Statement.EndDateTime 
Data.Statement.StartDateTime 
Data.Statement.StatementId 
Data.Statement.Type 
Data.Statement.StatementAmount 
Data.Statement.StatementAmount.Amount 
Data.Statement.StatementAmount.Amount.Amount 
Data.Statement.StatementAmount.Amount.Currency 
Data.Statement.StatementAmount.CreditDebitIndicator
Data.Statement.StatementAmount.Type 
Data.Statement.StatementDateTime 
Data.Statement.StatementDateTime.DateTime 
Data.Statement.StatementDateTime.Type 
Data.Statement.StatementFee 
Data.Statement.StatementFee.Amount 
Data.Statement.StatementFee.Amount.Amount 
Data.Statement.StatementFee.Amount.Currency 
Data.Statement.StatementFee.CreditDebitIndicator 
Data.Statement.StatementFee.Type 
Data.Statement.StatementInterest 
Data.Statement.StatementInterest.Amount 
Data.Statement.StatementInterest.Amount.Amount 
Data.Statement.StatementInterest.Amount.Currency 
Data.Statement.StatementInterest.CreditDebitIndicator 
Data.Statement.StatementInterest.Type 
Data.Statement.StatementRate 
Data.Statement.StatementRate.Rate 
Data.Statement.StatementRate.Type 
Data.Statement.StatementDescription

 

Transactions

GET /transactions

GET /transactions/{accountId}

GET /accounts/{AccountId}/statements/{StatementId}/transactions

The following fields will be included in the response where appropriate

Data.Transaction.AccountId
Data.Transaction.TransactionReference
Data.Transaction.CreditDebitIndicator
Data.Transaction.Status
Data.Transaction.BookingDateTime
Data.Transaction.ValueDateTime
Data.Transaction.TransactionInformation
Data.Transaction.AddressLine
Data.Transaction.Amount
Data.Transaction.Amount.Amount
Data.Transaction.Amount.Currency
Data.Transaction.MerchantDetails
Data.Transaction.MerchantDetails.MerchantName

We do not support any optional fields