Dokümantasyon

Webhook'lar

İmzalı, idempotent iletimle olaylara abone olun.

Webhook'lar, iadeler durum değiştirdiğinde veya sinyaller yakalandığında sistemlerinizi bilgilendirir. İletim, yeniden deneme ve bir dead-letter queue ile HMAC imzalıdır.

Olaylar

  • return.submitted · return.approved · return.closed
  • fit.signal.captured
  • instantcredit.granted · instantcredit.clawback

İmzaların doğrulanması

ts
const sig = req.headers['x-resreturn-signature'];
const expected = hmacSHA256(rawBody, process.env.RR_WEBHOOK_SECRET);
if (!timingSafeEqual(sig, expected)) return res.status(401).end();

Her zaman hızlıca 2xx döndürün ve işlemi asenkron olarak yürütün — yavaş handler'lar yeniden denemeleri tetikler.

Önceki
REST API