वेबहुक: वाणिज्य घटनाओं की तुरंत सूचना

वेबहुक वास्तविक एकीकरण की रीढ़ हैं। नए ऑर्डर के लिए हर 30 सेकंड API पूछने के बजाय URL पंजीकृत करें; घटना होते ही LetBuyy आपको भेजता है।

उपलब्ध घटना प्रकार

• order.created, order.updated, order.fulfilled, order.cancelled
• payment.captured, payment.failed, payment.refunded
• product.created, product.updated, product.deleted
• inventory.low_stock, inventory.out_of_stock
• customer.created, customer.updated
• checkout.abandoned, checkout.completed

वेबहुक पंजीकरण

POST /v1/webhooks
{
  "url": "https://yourapp.com/webhooks/letbuyy",
  "events": ["order.created", "payment.captured"],
  "secret": "your_webhook_secret"
}

हस्ताक्षर सत्यापन—अत्यंत जरूरी

हर वेबहुक में X-LetBuyy-Signature हेडर है। संसाधित करने से पहले जाँचें। LetBuyy आपके वेबहुक गोपनीय मान और HMAC-SHA256 से मूल अनुरोध बॉडी पर हस्ताक्षर करता है।

import { createHmac, timingSafeEqual } from "crypto"

function verifyWebhook(body: string, signature: string, secret: string): boolean {
  const expected = createHmac("sha256", secret)
    .update(body)
    .digest("hex")
  const signatureBuffer = Buffer.from(signature, "hex")
  const expectedBuffer = Buffer.from(expected, "hex")
  return signatureBuffer.length === expectedBuffer.length &&
    timingSafeEqual(signatureBuffer, expectedBuffer)
}

विश्वसनीयता के तरीके

• 5 सेकंड में HTTP 200 दें—भारी काम असिंक्रोनस करें
• विफल डिलीवरी पर LetBuyy फिर प्रयास करता है: 1 मिनट, 5 मिनट, 30 मिनट, 2 घंटे, 24 घंटे
• X-LetBuyy-Webhook-ID हेडर की ID से इडेम्पोटेंसी बनाएँ
• संसाधन से पहले मूल वेबहुक डेटा रखें—त्रुटि पर फिर चलाने में मदद होगी
• निगरानी के लिए /webhooks/health एंडपॉइंट दें