Skip to main content

أضف نقطة نهاية

لوحة التحكم → Webhooks → أضف عنوان HTTPS الخاص بك واختر الأحداث (ابدأ بـ payment.confirmed). ستحصل على سر توقيع (whsec_…).

الحمولة

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

تحقق دائمًا قبل الوثوق بأي شيء:

الأحداث

تتضمن حمولات wallet.* وbridge.* walletId/bridgeTransferId، chain/route، amount، وتجزئات المعاملة ذات الصلة — بنفس الشكل الموجود في استجابات واجهة برمجة التطبيقات في Wallets و Bridge.

النزاعات

يُفتح نزاع عندما يُبلغ عميل، من صفحة الدفع الخاصة بك، عن إرسال أموال لم تتأكد تلقائيًا — مبلغ خاطئ، عنوان خاطئ، أو إرسال متأخر. الأمر ذاتي الخدمة من جهة العميل (يحصلون فورًا على نتيجة matchedWallet / amountCovered / lateByMinutes)، ويمنحك payment.dispute_opened نفس التفاصيل لمتابعتها يدويًا إذا لم يحل التحقق الآلي المشكلة — على سبيل المثال، اعتماد طلب رغم نقص طفيف في المبلغ المدفوع، وفق تقديرك الخاص.

التسليم وإعادة المحاولة

  • استجب بـ 2xx خلال 10 ثوانٍ؛ أي شيء آخر يُعد فشلًا.
  • نعيد المحاولة حتى 3 مرات مع تأخير تصاعدي؛ عمليات التسليم ورموز الحالة مرئية في لوحة التحكم.
  • يجب أن تكون المعالجات غير قابلة للتكرار (idempotent) — استخدم paymentIntentId كمفتاح.