واجهات API للمصرفية المفتوحة
المصرفية المفتوحة: بيانات الحسابات والمدفوعات عبر واجهات API البنكية
معلومات الحسابات وبدء المدفوعات عبر واجهات API بنكية خاضعة للتنظيم وعبر مجمعي البيانات المصرفية، مع إدارة الموافقات والرموز المميزة.
المخطط
مرر أفقيا لرؤية المخطط كاملا.
المصرفية المفتوحة: البيانات والمدفوعات بموافقة العميل
يمنح العميل موافقته، ويحفظ الموصل الرموز المميزة، وكل استدعاء للبنك مفوض ومسجل. وعندما تنتهي الموافقة أو تسحب، يطلب التطبيق من العميل تجديدها بدلا من أن يتوقف عن العمل دون إشعار.
- التدفق الرئيسي
- غير متزامن
- مسار الاستثناءات
التدفق خطوة بخطوة
- من العميل إلى تطبيقك أو منصتك: يمنح الموافقة (تدفق رئيسي).
- من تطبيقك أو منصتك إلى موصل المصرفية المفتوحة: طلبات الحسابات والمدفوعات، عبر REST/JSON (تدفق رئيسي).
- من موصل المصرفية المفتوحة إلى واجهات API البنكية أو مجمع البيانات: استدعاءات API مفوضة، عبر OAuth 2.0 · FAPI · REST (تدفق رئيسي).
- من واجهات API البنكية أو مجمع البيانات إلى موصل المصرفية المفتوحة: الأرصدة والمعاملات وحالة المدفوعات، عبر REST/JSON · webhook (غير متزامن).
- من موصل المصرفية المفتوحة إلى نظام ERP أو دفتر الأستاذ: معاملات موحدة، عبر REST/JSON (تدفق رئيسي).
- من واجهات API البنكية أو مجمع البيانات إلى موصل المصرفية المفتوحة: موافقة منتهية أو مسحوبة، عبر HTTP 401 · 403 (مسار الاستثناءات).
- من موصل المصرفية المفتوحة إلى تطبيقك أو منصتك: طلب تجديد الموافقة من العميل (مسار الاستثناءات).
نظرة عامة
تتيح المصرفية المفتوحة لأي تطبيق قراءة حسابات العميل وبدء المدفوعات عبر واجهات API بنكية خاضعة للتنظيم، بموافقة العميل. وهي الأساس لتجميع الحسابات، وتقييم القدرة على السداد في التمويل، والدفع المباشر من الحساب البنكي عند الشراء، وعرض أرصدة الخزينة عبر عدة بنوك.
يضع التصميم المرجعي موصلا للمصرفية المفتوحة بين تطبيقك والبنوك، إما مباشرة أو عبر مجمع بيانات مصرفية مرخص. يدير الموصل رحلة الموافقة، ويحفظ الرموز المميزة بأمان، ويستدعي واجهات API البنكية وفق معايير مثل Berlin Group NextGenPSD2 أو UK Open Banking Standard، ويحول بيانات كل بنك إلى نموذج واحد متسق.
الموافقة ليست دائمة، والتصميم يأخذ ذلك في الحسبان. فعندما تنتهي الموافقة أو تسحب، يطلب من العميل تجديدها بدلا من أن يفقد التطبيق البيانات دون أن يلاحظ أحد. وكل استدعاء مفوض ومسجل ومرتبط بالموافقة التي أجازته.
كيف يعمل التدفق
- 01
العميل يمنح موافقته
يختار العميل بنكه، ويرى البيانات التي ستشارك ومدة مشاركتها، ثم يثبت هويته لدى البنك الذي يعيده إلى تطبيقك.
- 02
تطبيقك يطلب
يطلب تطبيقك الأرصدة أو المعاملات أو تنفيذ دفعة عبر واجهة API الخاصة بالموصل، ولا يتصل بالبنك مباشرة أبدا.
- 03
الموصل يستدعي البنك
يستخدم الموصل الرموز المميزة المحفوظة لإجراء استدعاءات مفوضة لواجهة API الخاصة بالبنك أو بمجمع البيانات، وفق ملف الأمان الذي يشترطه البنك.
- 04
البيانات والحالة تعود
تعود الأرصدة والمعاملات وحالة الدفعات في صورة استجابات أو إشعارات webhook، ويوحدها الموصل في نموذج واحد لكل البنوك.
- 05
استخدام البيانات
تغذي المعاملات الموحدة منتجك أو نماذج المخاطر لديك أو نظام ERP لمعرفة المراكز النقدية وإجراء المطابقة.
عند حدوث إخفاق
انتهاء الموافقة أو سحبها
يرفض البنك الاستدعاء، فيوسم الموصل الموافقة بأنها لم تعد سارية، ويطلب تطبيقك من العميل تجديدها مع بيان السبب.
رفض دفعة
تعود حالة الدفعة وسبب الرفض من البنك عبر واجهة API أو إشعار webhook، ويطلع العميل وفريق العمليات لديك على النتيجة فورا.
تقييد البنك للوصول
تحد البنوك من عدد مرات جلب البيانات في غياب العميل. ويجدول الموصل التحديثات ضمن هذه الحدود، ويبطئ وتيرته عندما يشير البنك إلى ذلك.
تعذر الوصول إلى واجهة API لبنك
تعاد محاولة الاستدعاءات على فترات تأخير متزايدة، وتعرض آخر بيانات سليمة مع عمرها، ويطلق تنبيه إذا استمر الانقطاع.
المعايير والأنظمة
- المعايير والقنوات المصرفية
- PSD2
- Berlin Group NextGenPSD2
- UK Open Banking Standard
- FAPI
- التكامل
- REST
- Webhooks
- إدارة الهوية والوصول
- OAuth 2.0
- OpenID Connect
أسئلة وأجوبة
هل نتصل بالبنوك مباشرة أم عبر مجمع بيانات مصرفية؟
يتيح لك مجمع البيانات المصرفية الوصول إلى بنوك كثيرة عبر واجهة API واحدة ويعالج الفروق بينها، مقابل تكلفة لكل استدعاء أو لكل ربط. أما الربط المباشر فيمنحك تحكما أكبر، وقد يناسب عددا قليلا من البنوك المهمة. وتبدأ منتجات كثيرة بمجمع بيانات ثم تضيف روابط مباشرة لاحقا. ونقارن الخيارات وفق البنوك والدول التي تحتاج إليها.
رابط هذا السؤالهل نحتاج إلى ترخيص لاستخدام المصرفية المفتوحة؟
تعد خدمات معلومات الحسابات وبدء الدفع أنشطة خاضعة للتنظيم في دول كثيرة. فإما أن تحمل شركتك الترخيص اللازم، وإما أن تعمل عبر مزود مرخص يحمله. ويتوقف ما ينطبق عليك على دولتك وحالة الاستخدام، وينبغي أن يؤكده مستشاروك القانونيون ومستشارو الامتثال. ونبني التكامل وفق المسار الذي تختاره.
رابط هذا السؤالكيف تدار موافقة العميل؟
يرى العميل البيانات التي ستشارك، والغرض منها، ومدة مشاركتها، ثم يثبت هويته لدى بنكه. ويحفظ الموصل الموافقة ورموزها المميزة مشفرة، ويرتبط كل استدعاء بموافقة سارية. ويستطيع العميل سحب موافقته، وعندها يتوقف الموصل عن استدعاء ذلك البنك نيابة عنه.
رابط هذا السؤالما البنوك والدول المشمولة؟
تتوقف التغطية على أنظمة كل منطقة وعلى واجهات API لدى البنوك. ففي الاتحاد الأوروبي والمملكة المتحدة تغطية واسعة بموجب PSD2 وUK Open Banking Standard، وتتفاوت التغطية في غيرهما، ويسد مجمعو البيانات المصرفية بعض الفجوات. ونتحقق من التغطية للبنوك التي يستخدمها عملاؤك قبل أن تعتمد التصميم.
رابط هذا السؤالهل تحل المصرفية المفتوحة محل الربط البنكي بنظام host-to-host؟
ليس في معظم أعمال الخزينة لدى الشركات. فقنوات host-to-host تتولى ملفات المدفوعات المجمعة وكشوف الحساب الكاملة لحساباتك أنت. أما المصرفية المفتوحة فتناسب المنتجات الموجهة للعملاء، والأرصدة الفورية، والمدفوعات الفردية. وتستخدم شركات كثيرة الاثنين معا: host-to-host لدورات الدفع الخاصة بها، والمصرفية المفتوحة لعملائها.
رابط هذا السؤالكيف تحمى بيانات المصرفية المفتوحة؟
تحفظ الرموز المميزة وسجلات الموافقة مشفرة، ولا يستخدمها إلا الموصل، ويسجل كل استدعاء مع الموافقة التي يستند إليها. ولا نجمع إلا البيانات التي يتطلبها الغرض، ونحدد مدة الاحتفاظ بها. وتنطبق على هذه البيانات قواعد حماية البيانات مثل GDPR، ونصمم الحل بالتعاون مع مسؤول حماية البيانات لديك.
رابط هذا السؤالأخبرنا بما تحتاج إلى بنائه أو ربطه.
صف لنا الأنظمة والجدول الزمني والقيود، وسيتولى المهندسون المناسبون الأمر من هناك.
- سيتصل بك فريقنا خلال 24 ساعة في الفترة الزمنية التي تفضلها
- فريقنا متاح على مدار الساعة طوال أيام الأسبوع