Әзірлеушілерге

Webhooks

Webhook handler қайталанған жеткізуге және downstream жүйелердің уақытша қатесіне қауіпсіз болуы керек.

Сипаттама

Қолтаңба, retries және idempotent өңдеуі бар төлем, фискалдық және reconciliation оқиғалары.

Оқиғаны өңдеу

Event қабылдаңыз, signature тексеріңіз, event id сақтаңыз, тез жауап беріңіз және ауыр бизнес логиканы queue-ға шығарыңыз.

Қателер

CRM немесе ERP уақытша қолжетімсіз болса, event жоғалмауы керек: retry және integration error logs қолданыңыз.

Бетті қалай қолдану керек

Webhooks бизнес иесі, әзірлеуші және операциялық командаға бір төлем сценарийін келісуге көмектеседі. Іске қосу алдында sales channel, provider route, webhook жауаптысы, status verification және клиент қолдауы бекітілуі керек.

Жиі сұрақтар

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.