Fidelyo
Coming back to Lomé

Your till’s receipts fill the card.

Odoo, Loyverse or another till: Fidelyo receives your receipts and gives your customers their stamps or points. For this to work, your team rings up sales as before and adds the customer to the receipt.

Message us on WhatsApp

Till connections haven’t launched yet, and there’s no date. We’ll look at your till with you.

Example: an Odoo receipt from Belle Coiffure, on a 10-stamp card. Odoo is read every 5 minutes; the customer is found by her phone number.

Four ways to connect your till

One shop or several: each shop in your till is linked to its own Fidelyo shop.

  • Odoo

    Every 5 min

    You give your Odoo address, its database name and a read-only key: paid receipts are read every 5 minutes. A reward is confirmed on the Fidelyo counter screen, then the discount is applied in Odoo.

  • Loyverse

    On every receipt

    You connect your Loyverse account: each receipt and each return is recorded as soon as Loyverse sends it to Fidelyo. You switch off Loyverse points, so nothing is counted twice.

  • A CSV file

    Every night

    Your till sends a CSV file of receipts over SFTP, or you import it into Fidelyo. A WhatsApp message tells you how many lines are rejected; the report gives the reason for each one.

  • The API

    On every call

    Your software sends receipts and returns, finds a customer and uses a reward. For any other till.

The right customer, without guessing

A customer is found by phone number, Fidelyo card or the number of your own loyalty card, if you have one. A receipt with no customer found earns no stamps or points. If the phone number and the card point to two different customers, Fidelyo does not choose: the receipt waits in “To review” and you assign it.

Example: the same customer, found by any of the three.

What protects your receipts

  • A receipt sent twice counts only once.
  • A return takes back the stamps or points earned on the items returned. If the original sale still hasn’t arrived after 7 days, the return is rejected and nothing is taken off.
  • A WhatsApp alert if Odoo has not answered for 15 minutes, if Loyverse stays silent for 2 hours during your opening hours, or if the SFTP file is missing at 6 am, Lomé time.
  • One alert per incident, then a message when everything works again.
  • Receipts to review wait for you in a single list.

For whoever manages your till system

A REST API in JSON over HTTPS:

https://api.fidelyo.co/v1

Each receipt is recorded the same way as at the counter and follows your programme’s rules.

  • One key per shop, with its own permissions: read customers, write receipts, use a reward, export. It is shown only once and can be revoked at any time.
  • Each receipt and each reward used carries an external_id and applies only once. Same external_id, different content: 409 duplicate_receipt.
  • Phone number and card of two different customers: 202, status identity_conflict, 0 points. The receipt is recorded: do not send it again.
  • Webhooks to your software, signed with X-Fidelyo-Signature: customer.created, points.changed, reward.reached, redemption.created, tier.changed, membership.changed. Retries for 24 hours.
  • 20 requests per second per key; above that, 429 with a retry delay. Every error has a stable code and a message in French and English.
  • CSV file, one row per receipt line: shop_code, receipt_id, closed_at, customer_phone, customer_card, total_fcfa, sku, product_name, category, quantity, line_total, type (sale or return).
  • Every call is logged; you see the last 30 days.
  • No public documentation yet: message us to talk about it.
POST /receipts
{
  "shop": "BELLE-BE",
  "external_id": "POS-000123",
  "closed_at": "2026-11-09T10:42Z",
  "customer": {
    "phone": "+22890124521"
  },
  "total_fcfa": 15000,
  "lines": [
    {
      "sku": "TRS-01",
      "name": "Tresses",
      "category": "Coiffure",
      "quantity": 1,
      "line_total": 15000
    }
  ],
  "payment_method": "cash"
}
Example: the Belle Coiffure receipt, sent to the API. The shop’s key is not shown. The response gives the stamps or points added, the new balance, the rewards available and a surprise reward if there is one.
Receipts and returns
POST /receipts, POST /receipts/{external_id}/return.
Customers
GET /customers/lookup (phone or card), POST /customers, PATCH /customers/{id}.
Rewards
GET /customers/{id}/rewards, POST /redemptions, POST /redemptions/{id}/cancel within 24 hours.
Catalogue, files, exports
PUT /products, POST /imports, GET /imports/{id}, GET /exports/customers, /ledger and /receipts, paginated, in JSON or CSV.

Your till, connected to Fidelyo?

Tell us which till you use, for one shop or several, and we’ll work out with you how it would run in your shop.