Webhookok
Az EasyCoupon aláírt JSON üzenetet küld (HTTP POST) a megadott címre, amikor kód kiosztásra kerül, valaki pörget, egy kupont felhasználnak vagy e-mail címet gyűjtünk. Zapierrel, Make-kel vagy saját rendszerrel használható.
Végpont hozzáadása
- A Beállítások menü Integrációk fülén, a Webhookok részben kattintson a Végpont hozzáadása gombra.
- Adja meg a HTTPS URL címet, és válassza ki az Események közül, amelyeket kérni szeretne.
- Mentés után másolja ki az Aláíró titok: értékét (
whsec_…), ha a fogadó ellenőrzi az aláírást. A Teszt küldése gombbal egywebhook.testeseményt küldhet.
Legfeljebb 5 végpont adható meg. Csak https:// cím használható, belső hálózatra (privát IP-címre) mutató cím nem. Zapierben a „Webhooks by Zapier → Catch Hook” trigger, Make-ben a „Custom webhook” URL-jét illessze be.
Események
coupon.issued– egy vásárló kuponkódot kapott.wheel.spun– egy vásárló megpörgette a kereket (nyert vagy nem).coupon.redeemed– egy kupont felhasználtak.email.captured– egy vásárló megadta az e-mail címét.webhook.test– a Teszt küldése gombbal küldött próbaesemény.
Csak a szerveren megtörtént eseményekről küldünk webhookot; a kirakat böngészőjéből érkező jelzésekről nem.
A kérés felépítése
Minden üzenet ugyanabban a burkolóban érkezik; a data tartalma eseményenként más (a mezők snake_case írásmódúak). Példa:
{
"id": "evt_6f1d2c9a0b7e4c3f8a1d5e2b9c0f4a7d",
"type": "coupon.issued",
"created_at": "2026-11-12T09:30:00.000Z",
"tenant_id": "…",
"data": {
"coupon_id": "…", "code": "WELCOME-L9LHGLVE",
"pool_id": "…", "pool_name": "Üdvözlő 10%",
"discount_type": "percent", "discount_value": 10,
"expires_at": null, "sync_mode": "proxy", "sid": "…"
}
}
wheel.spun:wheel_pool_id,sid,won,segment,segment_label,prize_pool_id.coupon.redeemed:coupon_id,code,pool_id,pool_name,order_id,order_total,currency,email,source,sid.email.captured:email,verified(mindigfalse: a vásárló gépelte be),consent_at,consent_text,privacy_url,pool_id,pool_name,coupon_id,code,sid.
A discount_type értéke percent, fixed vagy free_shipping; a sync_mode értéke proxy vagy api.
Mit tartalmaz a coupon.redeemed boltonként?
- Shoprenter proxy mód: amikor a kódot a kosárban érvényesítik; rendelésszám, összeg és e-mail nélkül.
- Shoprenter bolt API mód: a sikeres rendelés oldalán, rendelésszámmal; összeg és e-mail nélkül.
- Shopify: a rendelésből, rendelésszámmal, összeggel, pénznemmel és e-mail címmel (ha a Shopify átadja).
Az aláírás ellenőrzése
Az aláírás a Standard Webhooks szabványt követi. Minden kérésben három fejléc van: webhook-id, webhook-timestamp (Unix másodperc) és webhook-signature (v1,<base64>).
- Vegye a titkot a
whsec_előtag nélkül, és dekódolja base64-ből: ez a kulcs. - Számolja ki a HMAC-SHA256-ot erre:
webhook-id + "." + webhook-timestamp + "." + nyers törzs(a törzset úgy, ahogy megérkezett, újraformázás nélkül). - Az eredmény base64-e egyezzen a
webhook-signaturev1,utáni részével. Utasítsa el a régi időbélyeget (például 5 percnél régebbit).
import crypto from 'node:crypto';
// secret: "whsec_…" az adminból; rawBody: a kérés törzse pontosan úgy, ahogy megérkezett
export function verify(secret, headers, rawBody) {
const id = headers['webhook-id'];
const ts = headers['webhook-timestamp'];
if (Math.abs(Date.now() / 1000 - Number(ts)) > 300) return false;
const key = Buffer.from(secret.replace(/^whsec_/, ''), 'base64');
const expected = crypto.createHmac('sha256', key).update(`${id}.${ts}.${rawBody}`).digest('base64');
return headers['webhook-signature'].split(' ').some((part) => {
const sig = part.split(',')[1] ?? '';
return sig.length === expected.length && crypto.timingSafeEqual(Buffer.from(sig), Buffer.from(expected));
});
}
Az Új titok gombbal új aláíró titkot generálhat; ezután a fogadónak az újat kell használnia.
Kézbesítés és újrapróbálás
- Sikeresnek a 2xx válasz számít; a fogadónak 10 másodperce van válaszolni.
- Hiba esetén összesen 8 próbálkozás van, egyre hosszabb szünetekkel (1 perc, 5 perc, 30 perc, 2, 6, 12 és 24 óra): ez kb. 2 nap.
- Ha egy végpont 50 egymás utáni kézbesítése hibás, és legalább 24 órája hibázik, a rendszer kikapcsolja: Ismételt hibák miatt kikapcsolva.
- A kézbesítési napló 30 napig látható a végpont alatt (Kézbesítve, Folyamatban, Sikertelen).
- Ugyanaz az esemény többször is megérkezhet: a
webhook-idalapján szűrje az ismétlést.