BIC / SWIFT التحقق من صحة الرمز API

كيفية دمج API التحقق من صحة BIC في برنامجك

1. ما هو API التحقق من صحة BIC?

عند معالجة الدفعات البنكية والتعامل مع المعاملات المتعلقة بـ IBAN ، يعد توفير رمز SWIFT / BIC الصحيح أمرًا ضروريًا للمدفوعات الناجحة.
قامت شركتنا بترخيص دليل BIC الرسمي من S.W.I.F.T SCRL لتوفير وسيلة قوية وبسيطة للتحقق من صحة BIC تلقائيًا. تتيح لك هذه الخدمة دمج بحث دليل رمز BIC في برنامجك لأغراض داخلية

يحتوي BIC Validation API على بيانات SWIFTRef من الداخل. بيانات BIC المستخدمة بإذن من S.W.I.F.T. SCRL. حقوق قاعدة البيانات محفوظة 2019

2. ميزات

BIC التحقق من صحة الميزات الرئيسية API:

  • استرجع معلومات عن البنك بناءً على BIC.
  • ابحث في دليل BIC عن طريق جزء من اسم البنك والبلد.
  • ابحث في دليل BIC عن السجلات التاريخية.
  • استخدم كلا من استجابة API الكاملة والمبسطة لتسهيل التكامل.


3. API استخدام

تعتمد واجهة برمجة تطبيقات التحقق من صحة BIC على طلبات HTTP GET أو POST البسيطة.

يتم سرد المعلمات المقبولة في الجدول أدناه:

اسم الحقل الطول النوع الوصف
bic 11 String BIC / SWIFT رمز للبحث. يمكن أن يكون 8 أو 11 حرفا
اسم البنك 256 String جزء من اسم البنك لإجراء البحث في دليل BIC.
البلد 2 String حرفين كود البلد. مطلوب عند البحث عن طريق اسم البنك.
api_key 128 String مفتاح API الشخصي الخاص بك.
بنية 4 String مطلوب لتحديد تنسيق البيانات التي تم إرجاعها. القيم المدعومة حاليا: json ، xml
حد عدد صحيح اختياري: يمكن استخدامه للحد من عدد النتائج عند البحث عن طريق اسم البنك.
hist عدد صحيح اختياري: يمكن استخدامه لعرض السجلات التاريخية من قاعدة البيانات لكل من البحث البنكي و BIC.
داخل البوابة الإلكترونية الخاصة بك ، يمكنك العثور على مفتاح API وعنوان URL الخاص بطلب نقطة النهاية ، والذي يُستخدم لتأمين طلبات البحث.


4. API XML هيكل الاستجابة

يمكنك تحميل XSD Schema API لتجاوب ال.
يمكن الاطلاع على وصف تفصيلي للحقول التي تم إرجاعها في الجدول أدناه:

اسم الحقل نوع طول دائما موجود وصف
تعديل العلم ابجدي 1 نعم في ملفات دلتا:
• A (إضافة)
• M (تعديل)
• D (حذف) في ملفات كاملة في ملفات كاملة:
• A (اضافي)
حقل متغير رقمية 186 لا يسجل الحقل (أو TAG) الذي تغير إما كنتيجة لتعديل سجل أو كنتيجة لحدث جديد.
Oneتتم الإشارة إلى أو أكثر من الأعمدة كسلسلة من الأرقام مع تغيير كل رقم يمثل العمود من مثيل السجل السابق أو حدث السابق.
Example "6,7,8,9"
هذا يعني أن نوع الحدث ، وتاريخ الحدث ، و BIC8 ، وفرع BIC لديهم
تغير.
يتم استبعاد الحقول التالية من التسجيل في حقل متغير:
• مقتاح التسجيل
• الحقل المتغير
• علم التعديل
مفتاح التسجيل أبجدية رقمية 12 نعم المفتاح الفريد للسجل في الملف
يمثل كل سجل حدثًا في دورة حياة BIC.
بمجرد تعيينه ، لا يتغير سجل المفتاح أبدًا.
السجل السابق أبجدية رقمية 12 لا سجل أهم الأحداث المرتبطة سابقا
جميع الأحداث المرتبطة ويمكن تحديد موقعها باستخدام هذه المعلومات.
سجل المفتاح المقبل ابجدية رقمية 12 لا سجل المفتاح للحدث المرتبط التالي
جميع الأحداث المرتبطة ويمكن تحديد موقعها باستخدام هذه المعلومات
نوع الحدث ابجدية 32 نعم وصف الحدث أو التغيير المتعلق بـ BIC الذي حدث في الماضي ، في الوقت الحاضر ، أو سيحدث في المستقبل.
انواع الحدث:
• BIC منشور
• BIC منتهي الصالحية
• BIC متاح علي FIN
• BIC متاح علي FA
• BIC متاح علي IA
• BIC غير متاح علي FIN
• BIC غير متاح علي FA
• BIC غير متاح علي IA
• BIC غير متاح
• BIC موقوف
• BIC اعادت اتاحته
• BIC نشر
• BIC تغير الاسم القانوني
• BIC تغيير اسم المؤسسة
• BIC العنوان تغير
• FIN تغيير رمز الخدمة
تاريخ التحديث الأخير هو السطر الأخير من تسلسل BIC (أي ، الإدخال الأحدث).
عند إضافة حدث جديد ، يتم تغيير علامة التعديل وتغييره
سيتم تحديث عمود الحقل في الحدث السابق ذي الصلة المباشر.
تاريخ الحدث ابجدية رقمية 8 نعم تاريخ الحدث
BIC8 ابجدية رقمية 8 نعم BIC (المؤسسة ، الدولة ، لاحقة الحزب) أين:
• بادئة الحزب (4 احرف)
• رمز البلد (2 احرف)
• لاحقة الحزب (2 احرف)
فرع BIC ابجدية رقمية 3 نعم معرف فرع BIC المرتبط بـ 8 أحرف BIC. في حالة عدم وجود معرف فرع ، فسيتم استخدام XXX.
BIC ابجدية رقمية 11 نعم الكامل BIC: 8 أحرف BIC ومعرف الفرع
سجل الحالة ابجدية 1 نعم يشير إلى حالة السجل:
• [C] = الحالي يمثل الحدث الأخير في السلسلة حتى تاريخ النشر ، باستثناء [الأحداث المستقبلية
• [H] = السجلات التاريخية في سلسلة الأحداث
• [F] = Futureالحدث الذي سيحدث بعد تاريخ نشر الدليل. سيكون الحدث السابق [C] المشار إليه ساري المفعول حتى التاريخ المحدد في الحدث [F] المثالي.
بالنسبة إلى الأحداث المستقبلية ، يشير التاريخ إلى متى سيكون التغيير صالحًا.
سجل تشغيلي فعال ابجدية 1 نعم هناك سجلات متعددة لنفس BIC. يشير هذا الحقل إلى أي من سجلات نفس BIC هي BIC النشطة من الناحية التشغيلية وينبغي استخدامها.
• [Y] نشط تشغيليا
• [N] غير نشط تشغيليا
لكل BIC فريدة من نوعها ، هناك إدخال سجل واحد يشير إلى حالة ACTIVE (Y).
السجلات التي بها [H]وضع تاريخي سو تشير دائما الي [N].
السجلات الحالية [C]قد تشير الي [Y] or [N].
سجلات ال [F] سوف تشير دائما الي [N].
مؤشر النوع الفرعي اي نوع 4 نعم نوع النشاط التجاري للكيان. يتم توفير مؤشر النوع الفرعي فقط للسجلات ذات BIC.
SWIFT FIN ابجدية 1 نعم حالة اتصال الكيان بـ FIN:
• [Y] متصل ب FIN
• [N] غير متصل ب FIN
SWIFT FA ابجدية 1 نعم حالة قابلية الوصول للكيان من خلال FileAct:
• [Y] متصل ب FileAct
• [N] غير متصل ب FileAct
SWIFT IA ابجدية 1 نعم حالة قابلية الوصول للكيان من خلال InterAct:
• [Y] متصل ب InterAct
• [N] غير متصل ب InterAct
اسم قانوني اي 105 لا الاسم القانوني للمؤسسة
اسم المؤسسة اي 105 نعم الاسم التجاري للمؤسسة (الاسم المنشور)
نوع المؤسسة ابجدية 12 نعم المنظمة التي تعمل بشكل أساسي في الوساطة المالية و / أو في الأنشطة المالية المساعدة
نوع المؤسسة:
• مالية
• غير مالية
نوع الكيان ابجدية 16 نعم يحدد نوع الكيان المالي:
• الكيان القانوني
• فرع
• جاهز للعمل
RE عنوان الشارع 1 اي 35 لا [تسجيل] اسم الشارع
RE عنوان الشارع 2 اي 35 لا [التسجيل] رقم الشارع
RE عنوان الشارع 3 اي 35 لا [تسجيل] مبني, اسم المبني, الطابق
RE عنوان الشارع 4 اي 35 لا [تسجيل] منطقة
RE مدينة اي 35 لا [منطقة] اسم مدينة المؤسسة / الفرع
RE القانون الجنائي اي 90 لا [منطقة] المقاطعة أو اقليم أو الولاية أو أي منطقة إدارية أخرى للمؤسسة / الفرع المالك
RE رمز zip اي 15 لا [منطقة] Zip رمز المؤسسة / الفرع
RE رقم البريد اي 35 لا حقل مفصول بفواصل مع رقم صندوق البريد للمؤسسة / الفرع والرمز البريدي ذي الصلة.
مثال
"POB 103352, 40024"
هذا يسمح للعملاء باستخدام عنوان البريد الإلكتروني الكامل:
POB 103352
40024, DUESSELDORF (مدينة)
OP عنوان الشارع 1 اي 35 لا [جاهز للعمل] اسم الشارع
OP عنوان الشارع 2 اي 35 لا [جاهز للعمل] رقم الشارع
OP عنوان الشارع 3 اي 35 لا [جاهز للعمل] المبني, اسم المبني, الطابق
OP عنوان الشارع 4 اي 35 لا [جاهز للعمل] منطقة
OP مدينة اي 35 لا [جاهز للعمل] اسم مدينة المؤسسة / الفرع
OP القانون الجنائي اي 90 لا [جاهز للعمل] اقليم أو المقاطعة أو الولاية أو أي منطقة إدارية أخرى للمؤسسة / الفرع المالك
OP ZIP رمز اي 15 لا [جاهز للعمل] Zip رمز المؤسسة / الفرع
OP رقم البريد اي 35 لا حقل مفصول بفواصل مع رقم صندوق البريد للمؤسسة / الفرع والرمز البريدي ذي الصلة.
مثال
"POB 103352, 40024"
هذا يسمح للعملاء باستخدام عنوان البريد الإلكتروني الكامل:
POB 103352
40024, DUESSELDORF (مدينة)
BR عنوان الشارع 1 اي 35 لا [فرع] اسم الشارع
BR عنوان الشارع 2 اي 35 لا [فرع] رقم الشارع
BR عنوان الشارع 3 اي 35 لا [فرع] Building, building name, floor
BR عنوان الشارع 4 اي 35 لا [فرع] Area
BR CITY اي 35 لا [فرع] City name of the institution/ فرع
BR CPS اي 90 لا [فرع] اقليم أو المقاطعة أو الولاية أو أي منطقة إدارية أخرى تابعة لمؤسسة المالك/فرع
BR ZIP رمز اي 15 لا [فرع] Zip رمز للمؤسسة/ فرع
BR رقم البريد اي 35 لا حقل مفصول بفواصل مع رقم صندوق البريد للمؤسسة / الفرع ورمز الرمز البريدي ذي الصلة.
مثال
"POB 103352, 40024"
هذا يسمح للعملاء باستخدام عنوان البريد الإلكتروني الكامل:
POB 103352
40024, DUESSELDORF (مدينة)
فرع معلومات اي 70 لا فرع معلومات
هذا وصف نصي مجاني للفرع كما هو مقدم من المؤسسة المالية التي ينتمي إليها. في الوقت الحالي ، سيتم توفير هذا فقط للإدخالات مع BIC وفقط عندما ترغب المؤسسة المالية المعنية في تقديم هذه المعلومات الإضافية. يتم الحصول على المعلومات من دليل BI.
اسم البلد اي 70 نعم اسم بلد المؤسسة / فرع كما هو موضح في ISO 3166
ISO للبلد رمز ابجدية 2 نعم رمز ISO 3166-1 ابجدية-2 لدولة المؤسسة/فرع
المكان رمز اي نوع 1 نعم يحتوي على الموقع (رسميًا في الموضع 7 من معيار BIC: 2009)
امثلة:
• In FR, BICs فى باريس = P
• In BE, BICs فى بروكسل = B
• In US, BICs في الساحل الشرقي = 3
FIN خدمات رمزS اي نوع 60 لا رمز خدمة FIN (يُسمى أيضًا رمز خدمة القيمة المضافة). يتم توفير رمز الخدمة فقط للسجلات التي تحتوي على BIC.
يمكن أن يحتوي الحقل على ما يصل إلى 20 رمزًا من ثلاثة أحرف في ترتيب ابجدية al.
مفتاح سجل BDP ابجدية رقمية 12 لا المفتاح الفريد للدليل المصرفي Plus سجل في الملف.
حقل A اي 1 لا محجوزة للاستخدام في المستقبل
حقل B اي 64 لا محجوزة للاستخدام في المستقبل
حقل C اي 128 لا محجوزة للاستخدام في المستقبل
حقل D اي 256 لا محجوزة للاستخدام في المستقبل
حقل E اي 11 لا محجوزة للاستخدام في المستقبل
حقل F اي 12 لا محجوزة للاستخدام في المستقبل
يقوم نظام API بإرجاع النتائج بتنسيق XML ، وهو سهل التحليل بمجموعة متنوعة من لغات البرمجة والأنظمة الأساسية.

سيكون رد XML عينة من API لبحث BIC:


<result>
<bicdata>
<row>
<modification_flag>A</modification_flag>
<changed_حقل>34</changed_حقل>
<record_key>BP0000004OQQ</record_key>
<previous_record_key>BP00000030XZ</previous_record_key>
<next_record_key/>
<event_type>BIC ADDRESS CHANGED</event_type>
<event_date>20150606</event_date>
<bic8>BARCGB22</bic8>
<فرع_bic>XXX</فرع_bic>
<bic>BARCGB22XXX</bic>
<record_status>C</record_status>
<operationally_active_record>Y</operationally_active_record>
<subtype_indicator>SUPE</subtype_indicator>
<swift_fin>Y</swift_fin>
<swift_fa>N</swift_fa>
<swift_ia>N</swift_ia>
<legal_name>BARCLAYS BANK PLC</legal_name>
<institution_name>BARCLAYS BANK PLC</institution_name>
<institution_type>FINANCIAL</institution_type>
<entity_type>Legal Entity</entity_type>
<re_street_address_1>1, CHURCHILL PLACE</re_street_address_1>
<re_street_address_2/>
<re_street_address_3/>
<re_street_address_4/>
<re_city>LONDON</re_city>
<re_cps/>
<re_zip_رمز>E14 5HP</re_zip_رمز>
<re_pob_number/>
<op_street_address_1>1 CHURCHILL PLACE</op_street_address_1>
<op_street_address_2/>
<op_street_address_3/>
<op_street_address_4/>
<op_city>LONDON</op_city>
<op_cps>LONDON E14 5HP</op_cps>
<op_zip_رمز/>
<op_pob_number/>
<br_street_address_1/>
<br_street_address_2/>
<br_street_address_3/>
<br_street_address_4/>
<br_city/>
<br_cps/>
<br_zip_رمز/>
<br_pob_number/>
<فرع_information>(ALL U.K. OFFICES)</فرع_information>
<country_name>UNITED KINGDOM</country_name>
<iso_country_رمز>GB</iso_country_رمز>
<location_رمز>2</location_رمز>
<fin_service_رمزs>EBAERPFINSCOSTGTGT</fin_service_رمزs>
<record_key_bdp>BD00000006FO</record_key_bdp>
<حقل_a/>
<حقل_b/>
<حقل_c/>
<حقل_d/>
<حقل_e/>
<حقل_f></حقل_f>
</row>
</bicdata>
<errors/>
</result>




5. API اخطاء

في حالة حدوث خطأ ، تقوم واجهة برمجة التطبيقات بإرجاع استجابة XML تحتوي على رسالة الخطأ

ال XML يتم إرجاع العلامات دون أي حقل آخر في استجابة XML.

يمكنك العثور أدناه على وصف لجميع رسائل الخطأ المحتملة التي يمكن إرجاعها:

رمزالحالة نوع وصف
301 خطأ في الحساب API المفتاح غير صالح
302 خطأ في الحساب صلاحية الاشتراك
303 خطأ في الحساب لا يوجد استفسارات متاحة
304 خطأ في الحساب لا يمكنك الوصول إلى واجهة برمجة التطبيقات هذه
401 خطأ في إدخال البيانات تم قبول SWIFT بطول 8 أو 11 حرفًا'
402 خطأ في الحساب اسم البنك غير صالح! يجب ألا يقل حجم البحث المصرفي عن 4 أحرف.
الحروف المسموح بها a-z, A-Z, 0-9, [space]!
403 خطأ في الحساب رمز البلد غير صحيح! المسموح به هو 2 بلد رمز مثال: UK، DE، FR