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.


ASPSPCapital One (Europe)
BrandCapital One
Date
Developer portal (s)https://open-banking-developer.capitalone.co.uk/

Announcements:

Improvement

Delivery date

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

  

Change to Production:

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


 

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.

 



On-boarding

Supports dynamic client registration (Y/N)Y
Instructions for manual onboardingN/A
OIDC .well-known endpoint

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

Notes on testingTPPs 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 versionv3
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.

RefAreaEndpointsNotes

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.

    • ReadAccountsBasic
    • ReadAccountsDetail
    • ReadBalances
    • ReadTransactionsBasic
    • ReadTransactionsDetail
    • ReadTransactionsCredits
    • ReadTransactionsDebits

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