Skip to main content
Lobyco is a modular loyalty platform, run as a service. It gives you a white-label mobile app, the Lobyco Admin Portal and the APIs behind both. You build the loyalty programme on top and connect it to your POS and your other systems. This page says what the pieces are, where the integrations sit, and how the API reference is organised. The Lobyco platform: customers use the white-label app, marketers the admin portal and customer support the analytics; an integration layer connects the Lobyco services to the client's POS, services and database Each client has its own tenant. Customers, marketers and support staff reach it through the app, the admin portal and reporting; your own infrastructure connects through the integration layer

How it works

Each client runs on its own tenant, with its own application instances and databases. Lobyco operates all of it. Nothing is installed or maintained on your side; your part of the work is the integration.

Where a purchase meets Lobyco

A loyalty programme only works when Lobyco sees what happens at the till. That is either a live connection from your POS to the Lobyco APIs, or data the POS produces, sent afterwards. You can build against the REST APIs yourself, or Lobyco can build an integration layer between your systems and its services. A purchase meets Lobyco at three points, shown below. Each is optional, and each can be done in more than one way. Together they run the loyalty programme end to end. That is enrolment, identification at the POS, coupon and reward redemption, and purchase processing, so that points and rewards accumulate. The three stages of a purchase: Identify, where the app and the check-in service link the customer to the sale; Verify, where the POS calls the promotion services; and Settle, where the purchase is loaded and feeds bonus calculation, ongoing campaigns and digital receipts Identify, verify, settle: the customer is linked to the sale, the offers are applied, and the finished sale is loaded

Identify

The customer checks in at the POS with their preferred method: the app’s QR code, a membership card, or another identifier. That links the transaction to a customer in the Members API. It can happen at any point in the transaction, depending on the flow you implement.

Verify

The POS asks Lobyco which offers apply. There are two ways. The POS fetches the customer’s active coupons with GET /v2/customers/{customerId}/coupons and applies them itself. Or the POS sends the basket to the Discounts API, and Lobyco returns the offers that apply and the discounts it calculated.

Settle

The POS, or your e-commerce platform, sends the finished sale to the Purchases API. Lobyco then processes it for every scenario you use:
  • Calculating bonus cash or points, and adding them to or deducting them from the customer’s account.
  • Progressing ongoing campaigns, such as challenges and stamp cards.
  • Rendering the digital receipt, shown in a web frame in the app or in other channels.

Environments

When you sign a contract, Lobyco gives you a test environment and a production environment. Each has its own APIs, admin portal and app builds. What an environment offers differs per client, because Lobyco releases new versions continuously and tailors functionality per contract. Treat this documentation as the overview, and your own environment as the truth.

API categories

The API reference groups endpoints by who calls them:

API reference

Endpoint documentation: Members, Coupons (POS), Discounts and Purchases.
Last modified on October 19, 2026