توسعه‌دهندگان

Webhooks

Webhook handler باید برای تحویل تکراری و خطاهای موقت downstream systems امن باشد.

نمای کلی

رویدادهای پرداخت، مالی و reconciliation با signatures، retries و پردازش idempotent.

پردازش event

Event را بپذیرید، signature را بررسی کنید، event id را ذخیره کنید، سریع پاسخ دهید و business logic سنگین را به queue منتقل کنید.

خطاها

اگر CRM یا ERP موقتاً در دسترس نیست، event نباید از دست برود: از retry و integration error logs استفاده کنید.

نحوه استفاده از این صفحه

Webhooks به هماهنگ شدن سناریوی پرداخت میان مالک کسب‌وکار، تیم توسعه و عملیات کمک می‌کند. پیش از راه‌اندازی باید کانال فروش، مسیر provider، مسئول webhook، بررسی وضعیت و پشتیبانی مشتری پس از پرداخت مشخص شود.

پرسش‌های متداول

What must a webhook handler do before changing an order?

It must verify the signature, store the event id and payload, confirm that the event was not processed before and only then update orders, invoices, fiscal jobs or CRM status.

Why should heavy business logic go to a queue?

A webhook endpoint should respond quickly. A queue makes it possible to retry CRM, ERP, e-mail or fiscal actions after temporary failures without losing the event.