Webhook endpoints

Πού στέλνουμε τα συμβάντα αυτής της επιχείρησης.

POST/v1/webhook_endpoints

Δικαίωμα: webhooks:write

Προσθέτει endpoint. Το url πρέπει να είναι δημόσιο HTTPS. Το events είναι λίστα τύπων συμβάντων· αν το παραλείψετε, λαμβάνετε όλα. Το secret για τις υπογραφές υπάρχει μόνο σε αυτή την απάντηση.

curl

curl https://loyaltyfy.io/api/v1/webhook_endpoints \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://pos.example.com/loyaltyfy/webhooks",
    "events": ["transaction.completed", "order.created"]
  }'

Απάντηση · 201

{
  "object": "webhook_endpoint",
  "id": "01c2a784-4bcf-43b9-8ac9-ddbad7a25341",
  "url": "https://pos.example.com/loyaltyfy/webhooks",
  "description": null,
  "events": ["transaction.completed", "order.created"],
  "status": "enabled",
  "disabled_reason": null,
  "livemode": false,
  "created_at": "2026-10-06T18:17:32.381+00:00",
  "secret": "whsec_UvjHvXfPk80ITYl_xPeAtskI0WjR8-PS"
}

GET/v1/webhook_endpoints

Δικαίωμα: webhooks:write

Όλα τα endpoints της επιχείρησης.

GET/v1/webhook_endpoints/{id}

Δικαίωμα: webhooks:write

Ένα endpoint, με την κατάστασή του και τον λόγο, αν έχει απενεργοποιηθεί.

PATCH/v1/webhook_endpoints/{id}

Δικαίωμα: webhooks:write

Αλλάζει τα url, events, description ή enabled. Χρησιμοποιήστε enabled: true για να ενεργοποιήσετε ξανά ένα endpoint που απενεργοποιήθηκε λόγω αποτυχιών.

DELETE/v1/webhook_endpoints/{id}

Δικαίωμα: webhooks:write

Διαγράφει το endpoint. Οι αποστολές σε εξέλιξη σταματούν.

POST/v1/webhook_endpoints/{id}/test

Δικαίωμα: webhooks:write

Στέλνει αμέσως ένα υπογεγραμμένο συμβάν test.ping και σας δείχνει τι απάντησε το endpoint σας.

curl

curl -X POST https://loyaltyfy.io/api/v1/webhook_endpoints/01c2a784-4bcf-43b9-8ac9-ddbad7a25341/test \
  -H "Authorization: Bearer sk_test_..."

# { "object": "webhook_test", "delivered": true, "status_code": 200, "error": null }