Вебхук эндпоинттері

Осы мекеменің оқиғаларын қайда жіберетініміз.

POST/v1/webhook_endpoints

Құқық: webhooks:write

Эндпоинт қосады. 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

Мекеменің барлық эндпоинті.

GET/v1/webhook_endpoints/{id}

Құқық: webhooks:write

Бір эндпоинт, мәртебесімен және өшірілген болса, себебімен.

PATCH/v1/webhook_endpoints/{id}

Құқық: webhooks:write

url, events, description немесе enabled өзгертеді. Ақаулар салдарынан өшірілген эндпоинтті қайта қосу үшін enabled: true жіберіңіз.

DELETE/v1/webhook_endpoints/{id}

Құқық: webhooks:write

Эндпоинтті жояды. Жүріп жатқан жеткізулер тоқтайды.

POST/v1/webhook_endpoints/{id}/test

Құқық: webhooks:write

Қол қойылған test.ping оқиғасын дәл қазір жіберіп, эндпоинтіңіз не жауап бергенін көрсетеді.

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 }