A weboldal tesztüzemben működik. Az EasyCoupon ingyenes próbája hamarosan indul.

Súgó / Fejlesztőknek

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

  1. A Beállítások menü Integrációk fülén, a Webhookok részben kattintson a Végpont hozzáadása gombra.
  2. Adja meg a HTTPS URL címet, és válassza ki az Események közül, amelyeket kérni szeretne.
  3. 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 egy webhook.test esemé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 (mindig false: 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>).

  1. Vegye a titkot a whsec_ előtag nélkül, és dekódolja base64-ből: ez a kulcs.
  2. 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).
  3. Az eredmény base64-e egyezzen a webhook-signature v1, 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-id alapján szűrje az ismétlést.

Kapcsolódó cikkek