BINK · المطورون

ابنِ منتجات مالية
على BINK.

البنية نفسها التي تشغّل المحافظ والبطاقات والمدفوعات والتحويلات الصادرة، متاحة كواجهة REST API — بنموذج أخطاء واحد، وعقد واحد لعدم التكرار، وWebhooks موقّعة. ابنِ على بيئة الاختبار، واتبع التوثيق، ثم أطلق منتجك.

/api/v1REST · JSONWebhooks موقّعةآمن من التكرار
الطلب
curl https://binkpay.net/api/v1/developer/ping \
  -H "Authorization: Bearer sk_test_51H..."
الاستجابة200 OK
{
  "ok": true,
  "companyId": "co_4b7e21",
  "livemode": false,
  "scopes": ["analytics:read", "payments:read"]
}

نقطة فحص المطور — نقطة النهاية الوحيدة التي تقبل مفتاح API اليوم. للعرض والنسخ فقط؛ لا يُرسل أي طلب فعلي.

بوابة المطورين

كل شيء على بُعد نقرة واحدة.

المرجع والأدوات والواجهات التشغيلية — كلٌّ منها مسار حقيقي في البوابة.

ابدأ من هنا

من الصفر حتى أول حدث.

  1. احصل على الوصول

    أنشئ مفاتيح بيئة اختبار لتبني عليها، دون أي مخاطرة ببيانات الإنتاج.

  2. المصادقة

    أرسل مفتاحك كرمز Bearer. كل استجابة تحمل requestId.

  3. أرسل طلبك الأول

    استدعِ نقطة فحص المطور لتتأكد من المفتاح وترى بيئتك.

  4. تعامل مع الأحداث

    تحقق من توقيع كل Webhook واستجب له — دون حاجة إلى استطلاع متكرر.

  5. انتقل إلى الإنتاج

    انتقل من الاختبار إلى التشغيل الفعلي حين يصبح تكاملك جاهزًا.

الواجهة البرمجية

موارد REST يمكن التنبؤ بها.

REST عبر HTTPS، وJSON في الطلب والاستجابة، وبادئة واحدة. كل الموارد تتشارك شكل الطلب نفسه، وغلاف الأخطاء نفسه، وعقد عدم التكرار نفسه — تعلّمه مرة واحدة.

المصادقة

تعتمد BINK في التفويض على الجلسة + مفتاح API. يعمل مفتاح sk_ اليوم على نقطة فحص المطور؛ أما نقاط نهاية الموارد فتعتمد على جلسة لوحة التحكم. أرسل المفتاح كرمز Bearer — التفاصيل الكاملة في المصادقة.

مصممة للتكامل معها

سلوك يمكنك الاعتماد عليه في الإنتاج.

ليست وعودًا — بل هو العقد. هذه سلوكيات هندسية يوثّقها الـ API، ليعمل تكاملك بالطريقة نفسها يوم الإطلاق وكل يوم بعده.

Webhooks موقّعة

كل حدث موقّع بـ HMAC-SHA256 وطابع زمني — تحقق منه، دون استطلاع متكرر.

عدم التكرار (Idempotency)

مرّر Idempotency-Key مع POST /merchant/payments لتصبح إعادة المحاولة آمنة.

معرّفات الطلبات

كل استجابة — ناجحة أو خاطئة — تحمل requestId للرجوع إليه عند التواصل مع الدعم.

نموذج أخطاء واحد

{ ok, statusCode, message } لأخطاء التحقق والمصادقة والخادم على حد سواء.

حدود المعدل

سقف افتراضي قدره 600 طلب/دقيقة لكل مستخدم، وأضيق على نقاط النهاية الحساسة.

المصادقة

جلسة + مفتاح API. يعمل مفتاح sk_ اليوم على نقطة فحص المطور.

الدليل

كل ما يحتاجه المطورون.

المطورون

ابدأ البناء مع BINK.

اقرأ المرجع، واختبر على بيئة الاختبار، وضع البنية نفسها تحت منتجك.