التحقق من صحة أرقام IBAN من خلال استدعاء API واحد

يقبل نموذج الدفع الخاص بك التحويلات المصرفية الدولية. يقوم المستخدم بكتابة رقم IBAN المكون من 22 حرفًا. قبل أن ترسل ذلك إلى معالج الدفع الخاص بك وتنتظر الفشل، فأنت تريد اكتشاف الأخطاء المطبعية على مستوى النموذج. يتضمن التحقق من صحة رقم IBAN خوارزمية رقم التحقق modulo-97 الخاصة بكل بلد قواعد الطول، وتحليل بنية BBAN. يمكنك كتابتها بنفسك، أو الحصول على مكتبة، أو السماح لها بذلك تتعامل واجهة برمجة التطبيقات (API) معها.

بوتوي /v1/validate/iban تأخذ نقطة النهاية سلسلة IBAN وترجع ما إذا كانت كذلك صالح، ورمز البلد، واسم البلد، ونسخة منسقة من الرقم. وظيفة واحدة طلب، لا يوجد SDK مصرفي، ولا توجد مجموعة regex للمحافظة عليها.

استدعاء API

إجابة:

الرد يعطيك أربعة حقول. valid هو المنطقي الذي تحتاجه النابضة على مستوى النموذج. country_code و country تتيح لك الكشف التلقائي بلد البنك الخاص بالمستخدم للمنطق النهائي مثل اختيار العملة أو القواعد الضريبية. formatted تقوم بإرجاع رقم IBAN في المجموعة القياسية المكونة من أربعة أحرف للبشر نتوقع أن نرى على الفواتير والبيانات المصرفية.

عندما يفشل رقم IBAN في التحقق من رقم التحقق، ستظل تحصل على الحقول التي تم تحليلها:

ال valid: false العلم هو كل ما تحتاجه. لا توجد استثناءات للقبض، ولا توجد رموز خطأ للبحث عن. تحقق من القيمة المنطقية وأظهر رسالة خطأ.

Node.js

بايثون

تنسيقات IBAN حسب البلد

يختلف طول رقم IBAN حسب البلد. أول حرفين هما دائمًا رمز البلد ISO 3166-1، متبوعًا برقمين اختياريين، ثم رقم الحساب البنكي الأساسي (BBAN). وهنا الخمسة الأكثر التنسيقات الشائعة في المدفوعات الأوروبية:

دولة	شفرة	طول	شكل	مثال
ألمانيا	ل	22	DE + رقمين للفحص + 8 ​​رمز البنك + 10 حسابات	DE89 3704 0044 0532 0130 00
المملكة المتحدة	غيغابايت	22	GB + 2 رقم فحص + 4 بنك + 6 رمز فرز + 8 حساب	GB29 NWBK 6016 1331 9268 19
فرنسا	الاب	27	FR + 2 رقم فحص + 10 بنك + 11 حساب + 2 مفتاح	FR76 3000 6000 0112 3456 7890 189
إسبانيا	إس	24	ES + 2 رقم فحص + 4 بنك + 4 فرع + 2 كنترول + 10 حساب	ES91 2100 0418 4502 0005 1332
هولندا	NL	18	NL + 2 رقم شيك + 4 بنك + 10 حساب	NL91 ABNA 0417 1643 00

تتعامل واجهة برمجة التطبيقات مع جميع البلدان التي يزيد عددها عن 80 دولة في سجل SWIFT IBAN. لا تحتاج إلى الحفاظ على جدول بحث للأطوال والأشكال؛ يتم التحقق من صحة نقطة النهاية وفقًا للقواعد الصحيحة لـ رمز كل بلد.

التحقق من صحة النموذج React/Preact عند التمويه

التكامل الأكثر شيوعًا: التحقق من صحة رقم IBAN عندما يخرج المستخدم من حقل الإدخال. يؤدي استدعاء التمويه (بدلاً من كل ضغطة مفتاح) إلى إبقاء استخدام واجهة برمجة التطبيقات (API) منخفضًا وتجنب الوميض رسائل خطأ بينما لا يزال المستخدم يكتب.

يستدعي المكون واجهة برمجة التطبيقات (API) عندما يفقد الحقل التركيز. إذا كان رقم IBAN صالحًا، فإنه يمرر البيانات التي تم تحليلها (رمز البلد، السلسلة المنسقة) حتى النموذج الأصلي عبر onValidated. يمكن للوالد بعد ذلك ملء العملة تلقائيًا أو ضبط التوجيه أو عرض رقم IBAN المنسق كـ تأكيد.

دفعة التحقق من صحة أرقام IBAN من ملف CSV

غالبًا ما تحتاج فرق الشؤون المالية إلى التحقق من صحة قائمة أرقام IBAN للموردين أو الموظفين قبل تشغيل أي حساب الدفع دفعة واحدة. يقرأ هذا البرنامج النصي ملف CSV، ويتحقق من صحة كل رقم IBAN، ويضع علامة على الإدخالات غير الصالحة.

يخرج البرنامج النصي بالرمز 1 إذا كان أي رقم IBAN غير صالح، مما يجعله قابلاً للاستخدام كخطوة CI أو فحص ما قبل التحميل. بالنسبة للملفات الكبيرة (أكثر من 1000 صف)، قم بإضافة تأخير بسيط بين الطلبات أو استخدم مفتاح API للحصول على حدود أعلى للمعدلات.

تأهيل Stripe Connect

عند تأهيل البائعين أو العاملين لحسابهم الخاص عبر Stripe Connect، فإنك تقوم بجمع التفاصيل المصرفية الخاصة بهم إعداد دفعات. التحقق من رقم IBAN قبل الاتصال stripe.accounts.createExternalAccount يتجنب رحلة ذهابًا وإيابًا إلى واجهة برمجة تطبيقات Stripe والتي قد تفشل على أي حال. كما يتيح لك استخراج رمز البلد لتعيين عملة الدفع الصحيحة.

التدفق واضح ومباشر: التحقق من صحة البلد أولاً، واستخراجه، ثم تعيينه إلى عملة، ثم إنشاء الحساب الخارجي. إذا كان رقم IBAN غير صالح، فسيرى المستخدم خطأ على الفور بدلاً من ذلك من انتظار Stripe لرفضه بعد ثوانٍ.

النقاط الرئيسية

• مشاركة واحدة وأربعة حقول. أرسل سلسلة IBAN إلى /v1/validate/iban واستعادة الصلاحية ورمز البلد واسم البلد والرقم المنسق.
• أكثر من 80 دولة. تغطي نقطة النهاية كل دولة مسجلة في سجل SWIFT IBAN. لا يوجد منطق خاص بكل بلد من جانبك.
• اكتشاف الأخطاء على مستوى النموذج. التحقق من صحة الضبابية في نموذج الدفع الخاص بك ل منع أرقام IBAN غير الصالحة من الوصول إلى البنك أو معالج الدفع الذي تتعامل معه.
• لا يوجد تخزين، لا تسجيل. تتم معالجة رقم IBAN في الذاكرة ويتم التخلص منه. لا شيء مستمر.
• الطبقة المجانية متاحة. وصول مجهول بمعدل 5 طلبات في الدقيقة، 100 في اليوم. لا يوجد مفتاح API مطلوب للتطوير والاختبار.