Webhooks موقّعة
كل حدث موقّع بـ HMAC-SHA256 وطابع زمني — تحقق منه، دون استطلاع متكرر.
البنية نفسها التي تشغّل المحافظ والبطاقات والمدفوعات والتحويلات الصادرة، متاحة كواجهة REST API — بنموذج أخطاء واحد، وعقد واحد لعدم التكرار، وWebhooks موقّعة. ابنِ على بيئة الاختبار، واتبع التوثيق، ثم أطلق منتجك.
curl https://binkpay.net/api/v1/developer/ping \
-H "Authorization: Bearer sk_test_51H..."{
"ok": true,
"companyId": "co_4b7e21",
"livemode": false,
"scopes": ["analytics:read", "payments:read"]
}نقطة فحص المطور — نقطة النهاية الوحيدة التي تقبل مفتاح API اليوم. للعرض والنسخ فقط؛ لا يُرسل أي طلب فعلي.
المرجع والأدوات والواجهات التشغيلية — كلٌّ منها مسار حقيقي في البوابة.
موارد REST وعقد الطلب والاستجابة.
مكتبات عميل بأنواع بيانات صريحة للـ API.
مفاتيح اختبار وأحداث محاكاة، معزولة عن الإنتاج.
تسليم أحداث موقّعة، مع إعادة المحاولة وإعادة الإرسال.
أدلة وبدايات سريعة وأنماط تكامل.
الحالة المباشرة للأنظمة.
ملاحظات الإصدارات والتغييرات الجذرية.
/api/v1أنشئ مفاتيح بيئة اختبار لتبني عليها، دون أي مخاطرة ببيانات الإنتاج.
أرسل مفتاحك كرمز Bearer. كل استجابة تحمل requestId.
استدعِ نقطة فحص المطور لتتأكد من المفتاح وترى بيئتك.
تحقق من توقيع كل Webhook واستجب له — دون حاجة إلى استطلاع متكرر.
انتقل من الاختبار إلى التشغيل الفعلي حين يصبح تكاملك جاهزًا.
REST عبر HTTPS، وJSON في الطلب والاستجابة، وبادئة واحدة. كل الموارد تتشارك شكل الطلب نفسه، وغلاف الأخطاء نفسه، وعقد عدم التكرار نفسه — تعلّمه مرة واحدة.
تعتمد BINK في التفويض على الجلسة + مفتاح API. يعمل مفتاح sk_ اليوم على نقطة فحص المطور؛ أما نقاط نهاية الموارد فتعتمد على جلسة لوحة التحكم. أرسل المفتاح كرمز Bearer — التفاصيل الكاملة في المصادقة.
أنشئ المدفوعات واعرضها واسترجعها وألغِها.
المرجعالرصيد المتاح والتحويلات خارج الدورة.
المرجعأصدر المبالغ المستردة على المدفوعات المسددة واعرضها.
المرجعأصدر البطاقات واعرضها وموّلها وجمّدها وتحكّم بها.
المرجعسجلات مستخلصة من نشاط المدفوعات.
المرجعفواتير مفصّلة البنود للدفع خارج المنصة.
المرجعتسليم الأحداث الموقّعة وكتالوج الأحداث.
المرجعغلاف الأخطاء الموحّد ورموز الحالة.
المرجعحدود الطلبات وIdempotency-Key ورموز 429.
المرجعليست وعودًا — بل هو العقد. هذه سلوكيات هندسية يوثّقها الـ API، ليعمل تكاملك بالطريقة نفسها يوم الإطلاق وكل يوم بعده.
كل حدث موقّع بـ HMAC-SHA256 وطابع زمني — تحقق منه، دون استطلاع متكرر.
مرّر Idempotency-Key مع POST /merchant/payments لتصبح إعادة المحاولة آمنة.
كل استجابة — ناجحة أو خاطئة — تحمل requestId للرجوع إليه عند التواصل مع الدعم.
{ ok, statusCode, message } لأخطاء التحقق والمصادقة والخادم على حد سواء.
سقف افتراضي قدره 600 طلب/دقيقة لكل مستخدم، وأضيق على نقاط النهاية الحساسة.
جلسة + مفتاح API. يعمل مفتاح sk_ اليوم على نقطة فحص المطور.
اقرأ المرجع، واختبر على بيئة الاختبار، وضع البنية نفسها تحت منتجك.