Eurobank Cyprus Integration Eurobank Cyprus — Integration Guide Eurobank Cyprus follows a consent-first flow that differs from other banks in the Open Banking API. You must create a consent before initiating account access, and include the ConsentId header in subsequent requests.
🔗 Base URLs Environment
Domain
Production
https://fintech.entersoftone.gr
Development (sandbox accounts only)
https://fintech-dev.entersoftone.gr
⚠️ Key Differences from Other Banks Feature
Other Banks
Eurobank Cyprus
Consent
Optional or post-token
Required before initiate
ConsentId header
Not used
Required on initiate, token, refresh, logout
Initiate Account
Returns authUri directly
Requires ConsentId header
Logout
Revokes token
Deletes consent via bank API
Bank Fintech Client Bank Fintech Client 1. Create Consent Payload: - redirectUri Response: - consentId 2. Initiate Account Headers: - Software - Serialnumber - ConsentId Payload: - redirectUri Response: - authUri 3. User Authorization (Browser) User logs in and approves consent 4. Exchange Code for Token Headers: - Software - Serialnumber - ConsentId Payload: - code - redirectUri Response: - accessToken - refreshToken - expiresIn 5. Retrieve Account Data Headers: - Authorization: Bearer {token} - Software - Serialnumber - ConsentId 6. Refresh Token (when accessToken expires) Headers: - Software - Serialnumber - ConsentId Payload: - refreshToken Response: - accessToken - refreshToken - expiresIn Re-authentication required (restart from step 2) alt [success] [token expired] POST /api/eurobank-cy/consents 1 Create consent (2-month validity) 2 consentId 3 200 OK 4 POST /api/eurobank-cy/initiate/account 5 200 OK 6 Redirect to authUri 7 Redirect to redirectUri?code=xxx&bank=eurobankcy 8 POST /api/eurobank-cy/oauth2/token 9 Exchange authorization code 10 tokens 11 200 OK 12 GET /api/eurobank-cy/accounts 13 GET accounts 14 accounts 15 200 OK with accounts 16 POST /api/eurobank-cy/oauth2/refresh 17 refresh_token grant 18 200 OK 19 401 Unauthorized 20 💡 Payment Initiation Flow Bank Fintech Client Bank Fintech Client 1. Initiate Payment Headers: - Software - Serialnumber Payload: - debtor.accountCode - creditor.accountCode - creditor.name - instructedAmount.value - instructedAmount.currency - reason - callbackUrlOK - callbackUrlNOK Response: - paymentUri 2. Payment Authorization (Browser) User logs in, enters OTP, authorizes payment query param: paymentRequestId query param: error alt [payment approved] [payment rejected] POST /api/eurobank-cy/initiate/payment 1 Create payment (SEPA or Cross-Border) 2 paymentId + SCA redirect 3 201 Created 4 Redirect to paymentUri 5 Redirect to Bank SCA page 6 Redirect to callbackUrlOK 7 Redirect to callbackUrlNOK 8 💡 Delete Consent (Logout) Bank Fintech Client Bank Fintech Client Headers: - Authorization: Bearer {token} - Software - Serialnumber - ConsentId alt [success] [consent not found] GET /api/eurobank-cy/oauth2/logout 1 DELETE consent 2 204 No Content 3 204 No Content 4 404 5 404 Not Found 6 Header
Required
Description
Software
✅ Always
Your registered software identifier
Serialnumber
✅ Always
Your device/integration serial number
ConsentId
✅ Most endpoints
The consentId from POST /consents
Authorization
✅ After token
Bearer
Last modified: 01 July 2026