تخطَّ إلى المحتوى
افتح بيئة اختبار API

05التكامل

استقبل النتيجة بثقة

أحداث موقّعة تصل مرة واحدة على الأقل. تحقّق من التوقيع قبل تحديث طلبك.

في هذه الصفحة

الأحداث

القيمةالمعنىالإجراء
pendingبانتظار التحويلاعرض تعليمات الدفع.
observedرُصد التحويلانتظر نهائية الشبكة.
paidتم الدفعسلّم الطلب مرة واحدة.
expiredانتهت المهلةلا تطلب تحويلاً جديداً.
payment_exceptionتحتاج مراجعةلا تسلّم تلقائياً.

التحقق من التوقيع

Bun / Node: verify-webhook.ts
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 لمنع المعالجة المكررة.
  • ارفض توقيعاً أقدم من خمس دقائق.