Aiden Payments

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.