Introduction
Aiden Payments is Aiden’s payment service for handling in-store payments. It provides a scalable, secure, and future-proof way to centrally manage payment transactions, independent of the frontend where the sale is initiated.
Aiden Payments is designed as Payments as a Service: Aiden delivers the payment backend and management capabilities, while customers retain full flexibility to implement their own frontend and sales flows.
Architecture & Principles
The Aiden Payments solution consists of three main components:
-
Aiden POS Management Portal
Used to manage stores, payment devices, and related configurations. -
Aiden Payments Backend (API-first)
The backend handles all payment logic, transaction status handling, logging, and reporting. -
Customer Frontend (optional)
Customers can implement their own frontend (e.g. webshop, order application, or POS frontend) that communicates with Aiden Payments via APIs.
A key principle is that Aiden does not enforce a frontend. Integration is fully API-driven.
Management Portal
Operational management is handled through the Aiden POS Management Portal. From this portal, users can:
-
Manage stores
-
Link payment devices (PIN terminals) to stores
-
Configure store-specific settings
The portal acts as the central management layer on top of the payment infrastructure.
Payments API
The Aiden Payments backend is fully API-driven. All functionality is exposed via APIs and documented using Swagger:
-
Production: https://payments.prd.aidencloud.eu/swagger/index.html
-
Acceptance: https://payments.acc.aidencloud.eu/swagger/index.html
Core Capabilities
Through the APIs, the following functionality is available:
-
Retrieve available payment methods (e.g. PIN, cash)
-
Retrieve available payment devices per store
-
Initiate a payment on a device
-
Retrieve payment status updates
-
Retrieve payment reports and overviews
Payment Flow & Status Updates
When a payment is initiated on a payment device, the payment status must be communicated back to the frontend. In order to provide our customers with a similar process, regardless of the payment provider, we currently provide this mechanism via periodic polling: The frontend periodically requests the current payment status.
Logging & Reporting
All payments processed through Aiden Payments are logged within the payment service.
This logging forms the basis for:
-
Payment overviews per store
-
End-of-day reporting
-
Insight into transaction statuses
Reports are exposed via the API and can be presented in the customer’s own frontend or back-office systems.
Extensibility
Aiden Payments is built in a modular way and can be extended with additional functionality. We currently also provide these functions:
-
Cash management (cash-in / cash-out)
-
End-of-day closing support
-
Additional reports or API endpoints
These extensions are exposed via the same API structure and integrate seamlessly with Aiden POS.