Webhookok és kézbesítési napló
Események továbbítása, aláírások és újrapróbálás.
A webhook valós időben értesíti a külső rendszeredet a stmpr eseményeiről, például új vendégről, pecsétről, jutalomra kész állapotról vagy beváltásról.
Minden kérés aláírást kap, így a fogadó rendszer ellenőrizheti, hogy valóban a stmpr küldte. Sikertelen kézbesítésnél a rendszer késleltetve újrapróbálkozik.
A kézbesítési naplóban látható az esemény, az időpont, a válaszkód és az újrapróbálások eredménye.
https://stmpr.io/dashboard/developers · Webhooks
Lépésről lépésre
- Nyisd meg az Integrációk menü Webhookok oldalát.
- Adj hozzá HTTPS-végpontot, majd válaszd ki a továbbítandó eseményeket.
- Mentsd el az aláírási titkot a fogadó rendszer biztonságos konfigurációjában.
- Küldj teszteseményt, és ellenőrizd az aláírást, a kérés törzsét és a sikeres 2xx választ.
- Élesítés után figyeld a kézbesítési naplót. A javított végpontnál indítsd újra a sikertelen kézbesítést.
Mit tartalmaz egy webhook kérés
- Kérés törzse: az event neve, a created_at időbélyeg és a data objektum.
- data.wallet: a hűségkártya azonosítója és neve.
- data.customer: a vendég azonosítója, négyjegyű kódja, pecsétjeinek száma, a szükséges pecsétszám, hogy jutalomra kész-e, a csatlakozás és az utolsó aktivitás időpontja.
- customer.created: új vendég csatlakozott, további mező nélkül.
- stamp.added: a fentiek mellett a pecsét forrása (manual, api, auto, survey_reward, kiosk).
- stamp.removed: ugyanaz, mint a hozzáadásnál, a visszavonás forrásával.
- reward.ready: a vendég összegyűjtötte a jutalomhoz szükséges pecsétet, további mező nélkül.
- reward.redeemed: a beváltás típusa (staff, manual, auto, api).
- pass.updated: mely kártyák frissültek a telefonon (apple, google).
- Fejlécek: X-Stmpr-Event az esemény neve, X-Stmpr-Delivery a kézbesítés azonosítója, X-Stmpr-Signature pedig t=időbélyeg,v1=HMAC-SHA256 aláírás az aláírási titokkal.
- Válasz: 10 másodpercen belül 2xx választ várunk. Ha nem érkezik, összesen ötször próbálkozunk, 10 másodperc, 1 perc, 5 perc és 15 perc szünettel.
Példa kérések eseményenként
customer.created
{
"event": "customer.created",
"created_at": "2026-09-01T14:12:03+00:00",
"data": {
"wallet": {
"id": "w_8Kd2Qm",
"name": "Kávé hűségkártya"
},
"customer": {
"id": "c_9YbVt3xQ",
"display_code": "4693",
"stamps_count": 0,
"stamps_required": 10,
"ready_to_redeem": false,
"created_at": "2026-07-14T09:20:11+00:00",
"last_activity_at": "2026-09-01T14:12:03+00:00"
}
}
}stamp.added
{
"event": "stamp.added",
"created_at": "2026-09-01T14:12:03+00:00",
"data": {
"wallet": {
"id": "w_8Kd2Qm",
"name": "Kávé hűségkártya"
},
"customer": {
"id": "c_9YbVt3xQ",
"display_code": "4693",
"stamps_count": 7,
"stamps_required": 10,
"ready_to_redeem": false,
"created_at": "2026-07-14T09:20:11+00:00",
"last_activity_at": "2026-09-01T14:12:03+00:00"
},
"source": "manual"
}
}stamp.removed
{
"event": "stamp.removed",
"created_at": "2026-09-01T14:12:03+00:00",
"data": {
"wallet": {
"id": "w_8Kd2Qm",
"name": "Kávé hűségkártya"
},
"customer": {
"id": "c_9YbVt3xQ",
"display_code": "4693",
"stamps_count": 6,
"stamps_required": 10,
"ready_to_redeem": false,
"created_at": "2026-07-14T09:20:11+00:00",
"last_activity_at": "2026-09-01T14:12:03+00:00"
},
"source": "manual"
}
}reward.ready
{
"event": "reward.ready",
"created_at": "2026-09-01T14:12:03+00:00",
"data": {
"wallet": {
"id": "w_8Kd2Qm",
"name": "Kávé hűségkártya"
},
"customer": {
"id": "c_9YbVt3xQ",
"display_code": "4693",
"stamps_count": 10,
"stamps_required": 10,
"ready_to_redeem": true,
"created_at": "2026-07-14T09:20:11+00:00",
"last_activity_at": "2026-09-01T14:12:03+00:00"
}
}
}reward.redeemed
{
"event": "reward.redeemed",
"created_at": "2026-09-01T14:12:03+00:00",
"data": {
"wallet": {
"id": "w_8Kd2Qm",
"name": "Kávé hűségkártya"
},
"customer": {
"id": "c_9YbVt3xQ",
"display_code": "4693",
"stamps_count": 0,
"stamps_required": 10,
"ready_to_redeem": false,
"created_at": "2026-07-14T09:20:11+00:00",
"last_activity_at": "2026-09-01T14:12:03+00:00"
},
"type": "staff"
}
}pass.updated
{
"event": "pass.updated",
"created_at": "2026-09-01T14:12:03+00:00",
"data": {
"wallet": {
"id": "w_8Kd2Qm",
"name": "Kávé hűségkártya"
},
"customer": {
"id": "c_9YbVt3xQ",
"display_code": "4693",
"stamps_count": 7,
"stamps_required": 10,
"ready_to_redeem": false,
"created_at": "2026-07-14T09:20:11+00:00",
"last_activity_at": "2026-09-01T14:12:03+00:00"
},
"passes": [
"apple",
"google"
]
}
}