واجهة REST API واحدة.
لكل مسارات الدفع في BINK.
المدفوعات والتحويلات الصادرة والمبالغ المستردة والبطاقات والعملاء والفواتير — شكل طلب واحد، وغلاف أخطاء واحد، وعقد واحد لعدم التكرار. وتُبقي Webhooks الموقّعة نظامك متزامنًا دون استطلاع متكرر.
كل ما تحتاجه قبل أول استدعاء.
الحقائق التي يحتاجها كل تكامل منذ البداية — عنوان URL الأساسي، والمصادقة، وعدم التكرار، وشكل الأخطاء والحدود.
binkpay.net/api/v1
كل مسار في مرجع API يُقدَّم تحت هذه البادئة الواحدة.
الجلسة + مفتاح API
تعتمد المدفوعات والتحويلات الصادرة والمبالغ المستردة والبطاقات والعملاء والفواتير اليوم على جلسة لوحة التحكم في التفويض؛ أما مفاتيح API من نوع sk_/pk_ فتعمل بالفعل على نقطة فحص المطور.
requestId
كل استجابة — ناجحة أو خاطئة — تحمل requestId للرجوع إليه عند التواصل مع الدعم.
Idempotency-Key
مرّر هذه الترويسة مع POST /merchant/payments لتصبح إعادة المحاولة آمنة.
{ ok, statusCode, message }
غلاف أخطاء واحد لكل نقاط النهاية — لأخطاء التحقق والمصادقة والخادم على حد سواء.
600 req / min
سقف افتراضي لكل مستخدم، مع حدود أضيق على نقاط النهاية الحساسة مثل تسجيل الدخول.
تأكّد من مفتاحك.
واطّلع على بيئتك.
نقطة فحص المطور هي نقطة النهاية الوحيدة في هذا المرجع التي تقبل اليوم مفتاح API من نوع sk_ — فهي تؤكد أن المفتاح يعمل وتوضح الشركة والبيئة اللتين ينتمي إليهما.
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"]
}تسعة موارد. عقد واحد متماسك.
كل الموارد تتشارك نموذج المصادقة نفسه، وغلاف الأخطاء نفسه، وعقد عدم التكرار نفسه — اقرأ المرجع الكامل لمعرفة المعاملات والطلبات والاستجابات.
أنشئ المدفوعات واعرضها واسترجعها وألغِها — الكائن الذي تقوم عليه صفحة الدفع المستضافة وروابط الدفع.
اقرأ المرجعاطّلع على الرصيد المتاح واطلب تحويلًا خارج الدورة إلى حسابك البنكي المرتبط.
اقرأ المرجعأصدر المبالغ المستردة على المدفوعات المسددة واعرضها.
اقرأ المرجعأصدر البطاقات واعرضها وموّلها وجمّدها وتحكّم بها.
اقرأ المرجعسجلات عملاء تُستخلص تلقائيًا من نشاط المدفوعات.
اقرأ المرجعفواتير مفصّلة البنود للدفع اليدوي خارج المنصة.
اقرأ المرجعتسليم الأحداث الموقّعة، وسياسة إعادة المحاولة، وكتالوج الأحداث الكامل.
اقرأ المرجعغلاف الأخطاء الموحّد ورموز حالة HTTP.
اقرأ المرجعحدود الطلبات، وترويسة Idempotency-Key، والتعامل مع رمز 429.
اقرأ المرجعبقية المنظومة.
كل ما تحتاجه أيضًا لبناء التكامل واختباره وتشغيله.
نقاط نهاية REST، والموارد، وعقد الطلب والاستجابة.
حزم SDKمكتبات عميل بأنواع بيانات صريحة مولّدة من المنصة.
بيئة الاختبارمفاتيح اختبار وأحداث محاكاة — دون أي مخاطرة ببيانات الإنتاج.
Webhooksتسليم موقّع، وسياسة إعادة المحاولة، وكتالوج الأحداث.
التوثيقأدلة وبدايات سريعة وأنماط تكامل.
حالة APIالحالة المباشرة للأنظمة.
سجل التغييراتملاحظات الإصدارات والتغييرات الجذرية.