ForHosting KIT · البيانات والملفات: تحويل وتنظيف

التحقق من تنسيق IBAN وطوله والمجموع الاختباري

قد يبدو رقم الحساب المصرفي الدولي صحيحًا رغم احتوائه على عدد غير صحيح من المحارف أو رقم تحقق منسوخ بصورة خاطئة.

● Betaمجاني · داخل متصفحك
استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

توحّد هذه الأداة المسافات والواصلات المعتادة، وتحدد رمز الدولة، وتفحص الطول الرسمي المخصص لها، ثم تطبق قاعدة المجموع الاختباري mod-97 وفق ISO 7064. تعرض الأداة كل قرار على حدة، ولذلك يمكنكم استخدامها لفحص حساب واحد أو لتمكين برنامجكم من تقرير ما إذا كان سجل الدفع جاهزًا للمرحلة التالية.

ابدؤوا برقم IBAN كامل وواضح البنية

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

افهموا فحص طول الدولة وقاعدة mod-97

لا تتساوى أرقام IBAN في عدد موحّد من المحارف. تحدد كل دولة مشاركة طولًا ثابتًا، ولذلك يختلف الطول المتوقع للرقم الألماني عن الرقم النرويجي أو المالطي. تبحث الأداة عن الطول المرتبط برمز الدولة في البداية وتقارنه بالقيمة الموحّدة. ثم تنفذ إجراء المجموع الاختباري المحدد لرقم IBAN في ISO 7064: تنقل المحارف الأربعة الأولى إلى النهاية، وتحوّل الأحرف إلى قيم رقمية من A الذي يساوي 10 حتى Z الذي يساوي 35، ثم تقيّم السلسلة العشرية الناتجة وفق modulo 97. يترك المجموع الاختباري الصحيح باقيًا يساوي واحدًا. تحسب الخوارزمية الباقي تدريجيًا رقمًا بعد رقم بدلًا من إنشاء عدد صحيح هائل قد يتجاوز النطاق الرقمي الآمن للغة البرمجة. تعرض الاستجابة `length_valid` و`checksum_valid` كلًا على حدة، ولا تضبط `valid` إلا إذا نجح الفحصان. يمنع الطول الخاطئ نجاح المجموع الاختباري، وبذلك يبقى القرار النهائي متحفظًا وسهل التفسير ضمن مسارات العمل المؤتمتة.

استخدموا التحقق في الموضع المناسب من مسار الدفع

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

التحقق من نموذج المستفيد

اكتشفوا خطأ طول الدولة أو رقم التحقق قبل إرسال سجل المستفيد.

فحص بيانات الدفع المستوردة

وحّدوا حقول IBAN وتحققوا منها ضمن دفعة واحدة مع الاحتفاظ بسبب الرفض الدقيق.

مراجعة رقم الحساب

افحصوا رقم IBAN المنسوخ يدويًا قبل إدخاله في مسار الموافقة على الدفع.

ما تكلفة عملية تحقق واحدة عبر API؟

تبلغ تكلفة كل طلب $0.002. ويمكن لأداة المتصفح تنفيذ الفحص الحتمي نفسه محليًا.

هل تثبت النتيجة الصحيحة وجود الحساب؟

لا. فهي تؤكد طول الدولة المسجل والمجموع الاختباري فقط، ولا تتصل ببنك ولا تتحقق من ملكية الحساب.

هل يُسمح بالمسافات والواصلات؟

نعم. تُزال قبل التحقق، وتُحوّل الأحرف اللاتينية الصغيرة إلى أحرف كبيرة.

لماذا ينتج رمز الدولة غير المعروف خطأ؟

لا يمكن تحديد طول IBAN الإلزامي بثقة من دون تعريف معترف به للدولة.

كيف يُحسب المجموع الاختباري بأمان؟

تُوسّع القيمة الأبجدية الرقمية بعد إعادة ترتيبها وتُختزل تدريجيًا وفق modulo 97 لتجنب الأعداد الصحيحة الهائلة.

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

POSThttps://api.kit.forhosting.com/data/iban-validate

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

curl -X POST https://api.kit.forhosting.com/data/iban-validate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"iban":"DE89 3704 0044 0532 0130 00"}'
{
  "iban": "DE89 3704 0044 0532 0130 00"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "data.iban_validate",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

max_mb25
HTTPالرمزالمعنى
401unauthorizedمفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
402insufficient_balanceرصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
404unknown_typeنوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
429rate_limitedتجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

اطّلع على توثيق KIT الكامل ←