الأحداث
| القيمة | المعنى | الإجراء |
|---|---|---|
pending | بانتظار التحويل | اعرض تعليمات الدفع. |
observed | رُصد التحويل | انتظر نهائية الشبكة. |
paid | تم الدفع | سلّم الطلب مرة واحدة. |
expired | انتهت المهلة | لا تطلب تحويلاً جديداً. |
payment_exception | تحتاج مراجعة | لا تسلّم تلقائياً. |
التحقق من التوقيع
import { verifyWebhook } from "./verify-webhook";
const rawBody = await request.text();
const valid = verifyWebhook(rawBody, request.headers, webhookSecret);
if (!valid) return new Response("Invalid signature", { status: 401 });
const event = JSON.parse(rawBody);استخدم نص الطلب الخام كما وصل. إعادة تحويل JSON إلى نص تغيّر التوقيع.
الإعادة والتكرار
يصل كل حدث مرة واحدة على الأقل، وقد تصل الأحداث بترتيب مختلف عن ترتيب وقوعها. تجاهل أي حدث عالجته سابقاً بالاعتماد على webhook-id.
- أعد 2xx بعد حفظ الحدث بأمان.
- خزّن webhook-id لمنع المعالجة المكررة.
- ارفض توقيعاً أقدم من خمس دقائق.