Qovex Open Banking API (PSD2)
Welcome to Qovex's Open Banking API.
Our API offers Third Party Providers (TPPs) secure access to financial data, enabling them to create innovative products and services that leverage customer data while enhancing customer choice. With our Open Banking API, you can access financial data, including transaction history and account balances, in accordance with the Revised Payment Services Directive (PSD2, Directive (EU) 2015/2366).
The usage of the Qovex Open Banking API is completely free of charge; however, access to it is restricted to institutions that have obtained valid registration from the competent National Authority and possess a Qualified Certificate that includes the Account Information Services PSD2 role.
How to get access?
To gain access to the Qovex Open Banking API, Third Party Providers (TPPs) must undergo a registration process, which serves to safeguard our customers' information by limiting access to authorized parties only and is crucial in maintaining the security of the financial data.
If you are a certified Third Party Provider (TPP), you can obtain access to the Qovex Open Banking API by registering through the button below and completing the registration form. Our team will contact you with additional details.
Integration process
Registration
To begin the integration process, you must submit a registration form that includes fundamental information about your company, including the company name, registration number, and contact details.
Receiving Credentials
After submission of the registration form, we will review the provided details. Once we have successfully verified the information, we will provide you with API credentials and other necessary information required to access our Sandbox and Production environments.
Technical Integration
With access to Open Banking APIs in the Sandbox environment, the next step is to complete the technical integration process. The required API documentation can be found below.
Testing and Launch
After successfully completing the technical integration process, you should proceed to test your integration. Once done, you may launch it in production and start utilizing the Open Banking APIs.
Account Balances
Returns an array of your fiat balances (EUR, USD, GBP).
| Request | |
| GET | /api-external/psd2/v1/account-balances/ |
| Request parameters | |
| currency string (Optional) |
Filter by currency.
Valid options: USD, EUR, GBP. |
| Response (JSON): Array of balances per currency. Every entry contains: | |
| amount string | Balance amount |
| currency string | Balance currency |
| Response (JSON): failure | |
| code string | Error code |
| message string | Error Message |
Fiat Transaction History
Returns a paginated array of your fiat transactions.
| Request | |
| GET | /api-external/psd2/v1/transactions/ |
| Request parameters | |
| currency string (Optional) | One of: USD, EUR, GBP. |
| sort string (Optional) |
Sorting by date and time:
asc - ascending (default) desc - descending |
| sinceTimestamp integer (Optional) | Show only transactions since this unix timestamp. |
| offset integer (Optional) |
Skip this many transactions before returning results (default: 0, maximum: 200000).
If you need to export older history contact support or use a combination of limit and sinceId parameters. |
| sinceId integer (Optional) |
Show only transactions from specified transaction id.
If sinceId parameter is used, limit parameter is set to 1000. |
| limit integer (Optional) | Limit result to this many transactions (default: 100; maximum: 1000). |
| Response (JSON) - paginated array of transactions. Every transaction contains: | |
| transactionId string | Transaction ID (not available for pending) |
| amount string | Transaction amount |
| currency string | Transaction currency |
| datetime string | Transaction UTC datetime in ISO format |
| type string |
Transaction type:
|
| fee string | Transaction fee if applicable |
| amountReceived string | Amount received (on buy orders only) |
| currencyReceived string | Received currency (on buy orders only) |
| amountPaid string | Amount paid (on sell orders only) |
| currencyPaid string | Paid currency (on sell orders only) |
| iban string | Withdrawal account (on withdrawals only) |
| bic string | Bank account BIC (on withdrawals only) |
| nameAndSurname string | Name of account owner (on withdrawals only) |
| reference string | Reference: <USERNAME>-reference (on withdrawals only) |
| valueDate string | Withdrawal UTC value datetime in ISO format (on withdrawals only) |
| Invalid Currency API5003 | Filtering transactions with invalid currency. |
| Response (JSON): failure | |
| code string | Error code |
| message string | Error message |
| Invalid offset | Offset parameter should be number from 0 to 200000 |
| Limit too large | Max value of limit parameter is 1000 |
| Invalid limit | Limit parameter should be number from 1 to 1000 |
| Invalid sort parameter | Sort parameter can only be 'asc' or 'desc' |
| Invalid sinceTimestamp parameter | sinceTimestamp must be an integer |
| since_timestamp parameter must be higher than <timestamp>. | Make sure that sinceTimestamp is less than 30 days in the past |
| Failed to convert since_timestamp parameter | Check the value of sinceTimestamp parameter |
| Invalid untilTimestamp parameter | untilTimestamp must be an integer |
| until_timestamp parameter must be higher than <timestamp>. | Make sure that untilTimestamp is less than 30 days in the past |
| Failed to convert until_timestamp parameter | Check the value of untilTimestamp parameter |
| Old Token API5001 | Requesting older transactions with old token. |
| Invalid Currency API5003 | Filtering transactions with invalid currency. |