Γρήγορη εκκίνηση

Δημιουργήστε δοκιμαστικό κλειδί, ελέγξτε το, εγγράψτε έναν πελάτη και περάστε μια απόδειξη. Πέντε κλήσεις, περίπου πέντε λεπτά.

1
Δημιουργήστε δοκιμαστικό κλειδί
Στον πίνακα ελέγχου της επιχείρησης ανοίξτε Προγραμματιστές → Κλειδιά API, επιλέξτε Δοκιμή και τα δικαιώματα που χρειάζεστε. Το κλειδί εμφανίζεται μία φορά και ξεκινά με sk_test_. Αν αναπτύσσετε για πολλές επιχειρήσεις, ζητήστε από κάθε επιχείρηση να δημιουργήσει ένα κλειδί για εσάς ή γράψτε μας για να σας ανοίξουμε λογαριασμό συνεργάτη.
2
Ελέγξτε το κλειδί
Καλέστε GET /v1/account. Επιστρέφει την επιχείρηση, τα προγράμματα επιβράβευσής της και τα δικαιώματα του κλειδιού σας. Αν λάβετε 401, το κλειδί είναι λάθος ή έχει ανακληθεί.
3
Εγγράψτε έναν πελάτη
Καλέστε POST /v1/members με τηλέφωνο, όνομα και consent: true. Η απάντηση περιέχει τον αριθμό κάρτας και συνδέσμους για προσθήκη της κάρτας στο Apple Wallet ή στο Google Wallet.
4
Περάστε μια απόδειξη
Καλέστε POST /v1/transactions με το δικό σας id απόδειξης στο external_id, τον αριθμό κάρτας και το ποσό. Η απάντηση δείχνει τι κέρδισε ο πελάτης και το νέο υπόλοιπο.
5
Αναιρέστε την
Καλέστε POST /v1/transactions/{external_id}/void. Το υπόλοιπο επιστρέφει εκεί που ήταν.

1. Ελέγξτε το κλειδί

curl

curl https://loyaltyfy.io/api/v1/account \
  -H "Authorization: Bearer sk_test_4eC39HqLyjWDarjtT1zdp7dc"

Απάντηση · 200

{
  "object": "account",
  "id": "73267e72-7f6e-4ddd-bfa2-bd6746500794",
  "slug": "api-sandbox",
  "name": "API Sandbox",
  "timezone": "Europe/Chisinau",
  "livemode": false,
  "key": { "id": "65b6f90b-ba6f-47ce-886f-2deb9be1f087", "scopes": ["*"] },
  "programs": [
    {
      "id": "06af6eba-eaf5-4662-8a5e-2b6b52c65314",
      "slug": "default",
      "name": "Sandbox Cashback",
      "mechanic": "cashback",
      "currency": "MDL",
      "published": true,
      "barcode": "card_code128",
      "stamps_required": null,
      "cashback_rate": 5
    },
    {
      "id": "1480831a-9331-46dc-b055-90d14c844fb8",
      "slug": "stamps",
      "name": "Sandbox Stamps",
      "mechanic": "stamps",
      "currency": "MDL",
      "published": true,
      "barcode": "card_qr",
      "stamps_required": 5,
      "cashback_rate": null
    }
  ],
  "locations": []
}

Προσέξτε τη λίστα programs: μια επιχείρηση μπορεί να έχει πολλά προγράμματα (για παράδειγμα cashback για τους τακτικούς πελάτες και σφραγίδες για τον καφέ). Το mechanic σας λέει ποια νούμερα μετράνε για ένα μέλος: cashback, stamps, visit_discount και άλλα.

2. Εγγράψτε έναν πελάτη

curl

curl https://loyaltyfy.io/api/v1/members \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 7d1b2c4e-enrol-000123" \
  -d '{
    "phone": "+37366791102",
    "first_name": "Ion",
    "last_name": "Popescu",
    "card_number": "2000111703779",
    "language": "ro",
    "consent": true
  }'

Απάντηση · 201

{
  "object": "member",
  "id": "6dacfe0a-2500-44c6-a37c-05c660b093b4",
  "card_number": "2000111703779",
  "serial": "b90273b1-10c9-46eb-ba74-8fef48266b5d",
  "first_name": "Ion",
  "last_name": "Popescu",
  "phone": "+37366791102",
  "email": null,
  "birthday": null,
  "language": "ro",
  "marketing_consent": false,
  "program": {
    "id": "06af6eba-eaf5-4662-8a5e-2b6b52c65314",
    "name": "Sandbox Cashback",
    "mechanic": "cashback",
    "barcode": "card_code128"
  },
  "stamps": null,
  "cashback": {
    "balance": 1250,
    "currency": "MDL",
    "earn_rate": 5,
    "level": null,
    "redeem_max_percent": 30,
    "min_amount": 10000,
    "expires_at": "2027-01-04T18:17:17.721+00:00"
  },
  "discount": null,
  "visits": 1,
  "total_spent": 25000,
  "wallet": {
    "apple_url": "https://loyaltyfy.io/api/wallet/issue/3832466f-...?platform=apple&t=...",
    "google_url": "https://loyaltyfy.io/api/wallet/issue/3832466f-...?platform=google&t=...",
    "card_url": "https://loyaltyfy.io/wallet/3832466f-...?t=..."
  },
  "created_at": "2026-10-06T18:17:15.594+00:00"
}

Το card_number είναι προαιρετικό. Αν το παραλείψετε, εκδίδουμε 13ψήφιο αριθμό. Στείλτε το όταν το ταμείο έχει ήδη δικές του κάρτες και η κάρτα Wallet πρέπει να έχει τον ίδιο αριθμό.

3. Περάστε μια απόδειξη

curl

curl https://loyaltyfy.io/api/v1/transactions \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "external_id": "CHK-2026-000123",
    "member": "2000111703779",
    "amount": 25000,
    "currency": "MDL",
    "register_id": "POS-1",
    "closed_at": "2026-10-06T18:17:00+03:00",
    "line_items": [
      { "sku": "1001", "name": "Espresso", "quantity": 2, "unit_price": 4000, "category": "Coffee" },
      { "sku": "2005", "name": "Cheesecake", "quantity": 1, "unit_price": 17000, "category": "Desserts" }
    ]
  }'

Απάντηση · 201

{
  "object": "transaction",
  "id": "f8acbb16-0b3b-4afc-acbb-e5eabd4dd072",
  "external_id": "CHK-2026-000123",
  "status": "completed",
  "amount": 25000,
  "redeem_amount": 0,
  "cashback_earned": 1250,
  "stamps_earned": 0,
  "reward_unlocked": false,
  "net_amount": 25000,
  "currency": "MDL",
  "register_id": "POS-1",
  "closed_at": "2026-10-06T15:17:00+00:00",
  "livemode": false,
  "created_at": "2026-10-06T18:17:17.921+00:00",
  "voided_at": null,
  "member": {
    "object": "member",
    "id": "6dacfe0a-2500-44c6-a37c-05c660b093b4",
    "card_number": "2000111703779",
    "cashback": { "balance": 1250, "currency": "MDL", "earn_rate": 5, ... },
    ...
  }
}

4. Αναιρέστε την

curl

curl -X POST https://loyaltyfy.io/api/v1/transactions/CHK-2026-000123/void \
  -H "Authorization: Bearer sk_test_..."

Ό,τι κάνετε με κλειδί sk_test_ σημειώνεται ως livemode: false. Τα δοκιμαστικά μέλη και οι αποδείξεις είναι πραγματικές εγγραφές στον λογαριασμό της επιχείρησης, οπότε χρησιμοποιήστε δοκιμαστική επιχείρηση ή καθαρίστε μετά. Δείτε Δοκιμές.