Επισκέψεις

Check-in χωρίς απόδειξη, για προγράμματα σφραγίδων και επισκέψεων.

POST/v1/visits

Δικαίωμα: transactions:write ή devices:write

Καταγράφει μια επίσκεψη και δίνει την επιβράβευση ανά επίσκεψη του προγράμματος. Επιστρέφει αντικείμενο όπως μια συναλλαγή, με object: "visit" και amount: 0. Η επανάληψη ενός external_id επιστρέφει την αποθηκευμένη επίσκεψη με 200. Τα προγράμματα cashback απαντούν 400 visit_not_supported.

external_idstring, υποχρεωτικό: Το δικό σας id για αυτό το check-in. Μοιράζεται τον ίδιο χώρο τιμών με τις συναλλαγές.
memberstring, υποχρεωτικό: Οτιδήποτε ταυτοποιεί το μέλος, και η ακατέργαστη τιμή από σαρωτή.
device_idstring: Ποια συσκευή την κατέγραψε. Εμφανίζεται στις αναφορές ως ταμείο.
visited_atdatetime: Πότε έγινε. Προεπιλογή: τώρα.

Παράμετρος	Τύπος	Περιγραφή
external_id	string, υποχρεωτικό	Το δικό σας id για αυτό το check-in. Μοιράζεται τον ίδιο χώρο τιμών με τις συναλλαγές.
member	string, υποχρεωτικό	Οτιδήποτε ταυτοποιεί το μέλος, και η ακατέργαστη τιμή από σαρωτή.
device_id	string	Ποια συσκευή την κατέγραψε. Εμφανίζεται στις αναφορές ως ταμείο.
visited_at	datetime	Πότε έγινε. Προεπιλογή: τώρα.

curl

curl https://loyaltyfy.io/api/v1/visits \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "external_id": "door-1-2026-10-06-0042",
    "member": "4285324286429",
    "device_id": "door-1"
  }'

Απάντηση · 201

{
  "object": "visit",
  "id": "feb2ad75-ac7b-4bb6-8b64-192323b7f6ea",
  "external_id": "door-1-2026-10-06-0042",
  "status": "completed",
  "amount": 0,
  "stamps_earned": 1,
  "reward_unlocked": false,
  "register_id": "door-1",
  "livemode": false,
  "created_at": "2026-10-06T18:17:28.209+00:00",
  "member": {
    "object": "member",
    "card_number": "4285324286429",
    "stamps": { "current": 2, "required": 5, "rewards_available": 0 },
    ...
  },
  ...
}

Μια επίσκεψη ακυρώνεται όπως μια απόδειξη: POST /v1/transactions/{external_id}/void.