أضف نقطة نهاية
لوحة التحكم → 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كمفتاح.