Skip to main content
This section describes how a Point of Sale (POS) or e-commerce checkout integrates with Lobyco across the whole purchase lifecycle — from checking a customer in, through applying discounts and taking payment, to recording the finalized transaction. Each step is handled by a different Lobyco service, and each service has a distinct job. Use this page to understand which API does what before diving into the detailed guides.
Only the Purchase API records the sale. Calculating discounts and capturing payment do not — if you skip Transaction Data, customers get no bonus, no receipts and no challenge progress.

​
The purchase lifecycle

A typical customer purchase flows through the following stages. Not every integration uses every stage (for example, payment through Lobyco is optional), but the order and the responsibility of each API stay the same.
1

​
Set up payment locations (one-time)

Register each POS or self-checkout as a payment location so it can accept check-in and payments.Setting up a payment location
2

​
Check the customer in

The customer is identified at the payment location, either by scanning a QR-code sticker at the POS or by the POS scanning a code from the app.Registering at POS
3

​
Calculate discounts

Apply the customer’s coupons and offers to the basket. You choose one of two approaches: the POS decides what to apply (Coupon API) or Lobyco decides (Discount API).This step only calculates prices — nothing is stored or charged yet.Direct Coupon Service Integration / Discount Integration
4

​
Take payment

Capture funds through the Payment Coordinator (bonus, card, Apple / Google Pay, loyalty subscription).Payments
5

​
Redeem coupons

Confirm which coupons were actually used so they can’t be reused, or include them on the purchase for offline redemption.Coupon Redemption at POS
6

​
Record the transaction

Send the finalized sale to the Purchase API. This stores the receipt and publishes it so customers receive digital receipts, real-time bonus, and challenge progress, and so the data feeds analytics.Transaction Data

​
Integration building blocks

The table below summarizes each building block and — importantly — which one actually records the sale and triggers customer benefits. Only the Purchase API does this.

​
Applying discounts: two options

Step 3 above can be implemented in one of two ways. Both end with the same coupon redemption step, and both still require you to record the finalized sale via the Purchase API.

​
Guides

Setting up a payment location

Register each POS or self-checkout. Prerequisite for check-in and payments.

Registering at POS

Both check-in directions — sticker scan and app scan.

Direct Coupon Service Integration

The POS retrieves the customer’s coupons and decides what to apply.

Discount Integration

Send the basket to Lobyco and let Lobyco calculate the discounts.

Coupon Redemption at POS

Confirm which coupons were actually used so they cannot be reused.

Payments

Capture funds through the Payment Coordinator.

Transaction Data

Send the finalized sale to the Purchase API. This is what records it.
Last modified on August 12, 2026