تولیدکننده و اعتبارسنج CLABE مکزیک | ابزار آزمایشی رایگان

مولد CLABE مکزیکی برای تست

معرفی

کد CLABE مکزیک (Clave Bancaria Estandarizada یا کد استاندارد بانکی) یک کد عددی ۱۸ رقمی است که در سراسر سیستم بانکی مکزیک برای استانداردسازی انتقالات الکترونیکی وجوه استفاده می‌شود. هنگامی که سیستم‌های پرداخت یا برنامه‌های مالی که با بانک‌های مکزیک تعامل دارند را می‌سازید، به سرعت درمی‌یابید که داشتن شماره‌های CLABE معتبر برای آزمایش بسیار حیاتی است.

آنچه این ابزار را ارزشمند می‌کند این است: کدهای CLABE ساختاری معتبر تولید می‌کند که دقیقاً از فرمت و قوانین اعتبارسنجی تعیین شده توسط انجمن بانکداری مکزیک (ABM) پیروی می‌کند. هر شماره تولید شده شامل یک رقم کنترل محاسبه شده است که از الگوریتم‌های تأیید استاندارد عبور می‌کند. چه نیاز به یک CLABE برای یک آزمون واحد سریع داشته باشید یا ۱۰۰ شماره مختلف برای آزمون یکپارچگی جامع، کدهای با فرمت مناسبی دریافت می‌کنید که مانند CLABE‌های واقعی در محیط آزمایشی شما عمل می‌کنند.

درک شماره‌های CLABE

CLABE چیست؟

CLABE (کلید بانکی استاندارد شده) یک کد بانکی استاندارد مکزیک است که برای تمام انتقالات الکترونیکی وجوه در سیستم بانکی مکزیک استفاده می‌شود. معرفی شده در سال ۲۰۰۴ همزمان با سیستم پرداخت SPEI (سیستم پرداخت الکترونیکی بین بانکی)، CLABEها یک مشکل اساسی را حل کردند: پیش از اجرای آن، هر بانک از فرمت‌های متفاوتی برای شماره حساب استفاده می‌کرد که باعث خطا و کندی در انتقالات بین بانکی می‌شد. اکنون هر حساب بانکی مکزیک دارای یک CLABE منحصر به فرد ۱۸ رقمی است که به طور یکنواخت در تمام مؤسسات کار می‌کند.

ساختار CLABE

هر CLABE دقیقاً از ۱۸ رقم تشکیل شده است که به چهار جزء اصلی تقسیم می‌شود:

1. کد بانک (ارقام ۱-۳): شناسایی بانک خاص در مکزیک
2. کد شعبه (ارقام ۴-۶): شناسایی شعبه خاص بانک
3. شماره حساب (ارقام ۷-۱۷): شناسه منحصر به فرد حساب (۱۱ رقم)
4. رقم کنترل (رقم ۱۸): یک رقم تأیید که با استفاده از یک الگوریتم خاص محاسبه می‌شود

مثال: ۰۱۲ ۳۴۵ ۰۱۲۳۴۵۶۷۸۹۰ ۱

برای مثال، در شماره CLABE ۰۱۲۳۴۵۶۷۸۹۰۱۲۳۴۵۶۷:

• ۰۱۲ کد بانک (BBVA بانکومر)
• ۳۴۵ کد شعبه
• ۶۷۸۹۰۱۲۳۴۵۶ شماره حساب
• ۷ رقم کنترل است

نحوه تولید شماره‌های CLABE

کدهای بانکی

سه رقم اول یک CLABE، کد بانکی را نشان می‌دهد که موسسه مالی خاص در مکزیک را شناسایی می‌کند. این کدها استاندارد شده و توسط انجمن بانکداری مکزیک (ABM) تخصیص داده می‌شوند. تولیدکننده ما شامل تمام کدهای بانکی رسمی از سیستم مالی مکزیک است، از جمله بانک‌های اصلی مانند:

• 002 - BANAMEX
• 012 - BBVA BANCOMER
• 014 - SANTANDER
• 021 - HSBC
• 072 - BANORTE

کدهای شعبه

سه رقم بعدی (موقعیت‌های 4-6) کد شعبه را نشان می‌دهند. در حالی که کدهای شعبه واقعی متناظر با مکان‌های فیزیکی خاص بانک‌ها هستند، برای اهداف آزمایشی، تولیدکننده ما کدهای شعبه تصادفی اما با فرمت معتبر ایجاد می‌کند.

شماره‌های حساب

موقعیت‌های 7-17 شامل شماره حساب 11 رقمی هستند. در سیستم‌های تولیدی، این شماره‌ها منحصر به هر حساب بانکی هستند. تولیدکننده ما شماره‌های حساب تصادفی ایجاد می‌کند که فرمت مناسب را دنبال می‌کنند اما به حساب‌های واقعی متصل نیستند.

محاسبه رقم کنترل

رقم 18 یک رقم کنترل است که با استفاده از الگوریتم مدولو 10 وزنی محاسبه می‌شود. این مکانیسم تأیید، خطاهای رایج ورود داده مانند ارقام جابجا شده یا اشتباهات تایپی را شناسایی می‌کند.

نحوه کار آن به این صورت است:

1. هر یک از 17 رقم اول در مقدار وزنی متناظر ضرب می‌شود
2. وزن‌ها از الگوی 3، 7، 1، 3، 7، 1، ... (تکرار در تمام موقعیت‌ها) پیروی می‌کنند
3. فقط رقم آخر هر نتیجه ضرب استفاده می‌شود
4. این ارقام با هم جمع می‌شوند
5. رقم کنترل به صورت (10 - (مجموع mod 10)) mod 10 محاسبه می‌شود

نکته جالب در مورد این الگوریتم این است که تشخیص خطای قوی ارائه می‌دهد. اگر کسی اتفاقاً دو رقم را جابجا کند یا یک رقم را اشتباه تایپ کند، اعتبارسنجی رقم کنترل شکست می‌خورد و از انتقالات نادرست جلوگیری می‌کند. به همین دلیل، API‌های بانکی CLABE‌های با رقم کنترل نامعتبر را حتی قبل از تلاش برای پردازش تراکنش رد می‌کنند.

1function calculateCheckDigit(clabe17) {
2  // وزن‌ها برای هر موقعیت
3  const weights = [3, 7, 1, 3, 7, 1, 3, 7, 1, 3, 7, 1, 3, 7, 1, 3, 7];
4  
5  // محاسبه مجموع وزنی
6  let sum = 0;
7  for (let i = 0; i < 17; i++) {
8    const digit = parseInt(clabe17[i], 10);
9    const product = digit * weights[i];
10    sum += product % 10; // فقط رقم آخر محصول استفاده می‌شود
11  }
12  
13  // محاسبه رقم کنترل
14  const mod = sum % 10;
15  const checkDigit = (10 - mod) % 10; // اگر mod صفر باشد، رقم کنترل 0 است
16  
17  return checkDigit;
18}
19

استفاده از ابزار تولید CLABE

این ابزار سه کارکرد اصلی طراحی شده برای گردش‌های کاری آزمایشی متداول را ارائه می‌دهد:

۱. تولید یک CLABE واحد

عالی برای آزمون‌های واحد سریع یا زمانی که نیاز به بررسی دستی یک مورد خاص دارید. می‌توانید:

• انتخاب یک بانک خاص (مفید برای آزمون منطق بانک‌خاص) یا اجازه دهید ابزار به طور تصادفی یکی را انتخاب کند
• کپی CLABE تولید شده به کلیپ‌بورد با یک کلیک
• مشاهده جزئیات کامل شامل کد بانک، کد شعبه، شماره حساب و رقم کنترل

زمان استفاده: جلسات اشکال‌زدایی سریع، آزمون دستی API با ابزارهایی مانند Postman یا cURL، یا هنگام نمایش ساختار CLABE به اعضای تیم.

۲. تولید چندین CLABE

ضروری برای سناریوهای آزمون جامع. می‌توانید:

• تعداد را مشخص کنید (تا ۱۰۰ CLABE در یک زمان)
• اختیاراً همه CLABEها را به یک بانک خاص قفل کنید یا بانک‌ها را به طور تصادفی مخلوط کنید
• کپی CLABEهای انفرادی یا دریافت کل مجموعه به عنوان لیست با جداکننده ویرگول
• هر CLABE در دسته تضمین می‌شود که منحصر به فرد باشد

زمان استفاده: بذر پایگاه داده‌های آزمایشی، بارگذاری آزمون APIهای پرداخت، ایجاد مجموعه‌های داده آزمایشی متنوع برای اتوماسیون QA، یا راه‌اندازی سناریوهای آزمون چند کاربره پیچیده.

۳. تأیید یک CLABE

اعتبارسنجی شماره‌های CLABE موجود بر اساس قوانین فرمت رسمی:

• ورود هر CLABE ۱۸ رقمی که می‌خواهید تأیید کنید
• ابزار سه بررسی انجام می‌دهد: اعتبارسنجی فرمت (۱۸ رقم)، تأیید کد بانک (ثبت رسمی ABM)، و اعتبارسنجی رقم کنترل (الگوریتم مدولو ۱۰ وزنی)
• CLABEهای معتبر جزئیات کامل اجزا را نمایش می‌دهند
• CLABEهای نامعتبر پیام‌های خطای خاصی را نشان می‌دهند که نشان می‌دهد چه چیزی شکست خورده است

زمان استفاده: اشکال‌زدایی علت رد یک CLABE توسط API بانکی، اعتبارسنجی CLABEهای دریافتی از منابع خارجی، آموزش اعضای تیم درباره اعتبارسنجی CLABE، یا تأیید اینکه منطق تولید خودتان ارقام کنترل صحیح تولید می‌کند.

فرآیند تأیید CLABE

هنگام تأیید یک CLABE، ابزار ما چندین بررسی انجام می‌دهد:

1. بررسی فرمت: اطمینان می‌یابد که ورودی دقیقاً شامل ۱۸ رقم است
2. اعتبارسنجی کد بانک: تأیید می‌کند که سه رقم اول متعلق به یک بانک مکزیکی واقعی است
3. اعتبارسنجی رقم کنترل: رقم کنترل را مجدداً محاسبه می‌کند و با رقم ارائه شده مقایسه می‌نماید

1def validate_clabe(clabe):
2    # بررسی اینکه CLABE دقیقاً ۱۸ رقم باشد
3    if not re.match(r'^\d{18}$', clabe):
4        return {"isValid": False, "errors": ["CLABE باید دقیقاً ۱۸ رقم باشد"]}
5    
6    # استخراج اجزا
7    bank_code = clabe[0:3]
8    branch_code = clabe[3:6]
9    account_number = clabe[6:17]
10    provided_check_digit = clabe[17]
11    
12    # اعتبارسنجی کد بانک
13    if bank_code not in MEXICAN_BANKS:
14        return {"isValid": False, "errors": ["کد بانک نامعتبر است"]}
15    
16    # اعتبارسنجی رقم کنترل
17    calculated_check_digit = calculate_check_digit(clabe[0:17])
18    if int(provided_check_digit) != calculated_check_digit:
19        return {"isValid": False, "errors": ["رقم کنترل نامعتبر است"]}
20    
21    # اگر همه بررسی‌ها موفق باشند
22    return {
23        "isValid": True,
24        "bankCode": bank_code,
25        "bankName": MEXICAN_BANKS[bank_code],
26        "branchCode": branch_code,
27        "accountNumber": account_number,
28        "checkDigit": provided_check_digit
29    }
30

کاربردهای عملی برای تولیدکننده CLABE

توسعه نرم‌افزار و تست

ادغام سیستم پرداخت: هنگامی که با درگاه‌های پرداخت مکزیکی مانند Conekta، OpenPay یا API‌های بانکی مستقیم ادغام می‌شوید، به CLABE‌های معتبر برای تست بدون برخورد با سیستم‌های تولید نیاز دارید. سناریوی رایج: در حال ساخت یک ویژگی پرداخت هستید که پول را به حساب‌های بانکی مکزیکی منتقل می‌کند. استفاده از CLABE‌های تولید شده در محیط مرحله‌بندی به شما اجازه می‌دهد تا تأیید کنید که فراخوانی‌های API شما به درستی فرمت می‌شوند، منطق اعتبارسنجی شما کار می‌کند و مدیریت خطای شما موارد حاشیه‌ای را می‌گیرد - همه اینها بدون خطر انتقال پول واقعی.

تست اعتبارسنجی فرم: آیا فرم وب‌ای می‌سازید که CLABE را می‌پذیرد؟ دسته‌ای از اعداد معتبر را تولید کنید تا اعتبارسنجی frontend خود را تست کنید. سپس آنها را عمداً خراب کنید (رقمی را تغییر دهید، طول را تغییر دهید) تا تأیید کنید پیام‌های خطای شما به درستی نمایش داده می‌شوند. یک نکته حرفه‌ای: با CLABE‌های بانک‌های مختلف تست کنید تا مطمئن شوید اعتبارسنجی شما تصادفاً فرمت یک بانک را بر دیگری ترجیح نمی‌دهد.

بذر پایگاه داده: هنگام پر کردن پایگاه‌های داده آزمایشی با داده‌های مشتری مکزیکی واقعی، CLABE‌های تولید شده تصادفی باعث می‌شوند داده‌های تست شما اصیل به نظر برسند. این به‌ویژه برای محیط‌های نمایشی مفید است که در آن مشتریان نیاز به دیدن داده‌های نماینده دارند. فقط به یاد داشته باشید که به وضوح این محیط‌ها را به عنوان محیط‌های تست علامت‌گذاری کنید تا از سردرگمی جلوگیری شود.

بارگذاری تست: نیاز به استرس‌تست یک سیستم پردازش پرداخت دارید؟ 100 CLABE منحصر به فرد تولید کنید و تراکنش‌های همزمان را شبیه‌سازی کنید. این به شناسایی شرایط مسابقه یا مشکلات قفل پایگاه داده کمک می‌کند که ممکن است با یک حساب تست واحد ظاهر نشوند.

تست برنامه‌های مالی

سیستم‌های پرداخت فرامرزی: اگر پلتفرم‌های حواله یا خدمات پرداخت بین‌المللی که به مکزیک انتقال می‌دهند را می‌سازید، در مراحل مختلف با اعتبارسنجی CLABE مواجه خواهید شد: اعتبارسنجی سمت مشتری، بررسی‌های سمت سرور و در نهایت در سطح API بانکی. داشتن منبعی از CLABE‌های معتبر تست، اطمینان می‌دهد که برنامه شما کل جریان را قبل از راه‌اندازی به درستی مدیریت می‌کند.

سناریوهای مدیریت خطا: اشتباهی که بارها دیده‌ام: توسعه‌دهندگان فقط "مسیر خوشحال" را با CLABE‌های معتبر تست می‌کنند. چه اتفاقی می‌افتد وقتی کاربر 17 رقم وارد می‌کند؟ یا 19؟ یا خط تیره یا فاصله را شامل می‌کند؟ از این ابزار برای تولید CLABE‌های معتبر استفاده کنید، سپس نسخه‌های نامعتبر ایجاد کنید تا مدیریت خطای خود را به طور کامل تست کنید. کاربران شما زمانی که برنامه شما پیام‌های خطای واضح و مفید به جای شکست‌های عمومی ارائه می‌دهد، از شما تشکر خواهند کرد.

تست انطباق و حسابرسی: برنامه‌های مالی اغلب نیاز به ردپای حسابرسی دارند که نشان می‌دهد اعتبارسنجی تراکنش چگونه است. CLABE‌های تولید شده به شما اجازه می‌دهند سوابق تست جامعی ایجاد کنید که نشان می‌دهد منطق اعتبارسنجی شما الزامات انطباق را برآورده می‌کند بدون اینکه داده‌های مشتری واقعی را افشا کنید.

اهداف آموزشی و تمرینی

یادگیری استانداردهای بانکداری مکزیک: درک ساختار CLABE برای هر کسی که با سیستم‌های مالی مکزیک کار می‌کند، ضروری است. از این ابزار برای تولید مثال‌ها، تجزیه و تحلیل اجزای آنها و درک عملی نحوه کار الگوریتم رقم بررسی استفاده کنید.

برنامه‌های آموزشی فین‌تک: هنگام آموزش توسعه‌دهندگان جدید در مورد سیستم‌های پرداخت مکزیک، داشتن CLABE‌های معتبر در دسترس، کارگاه‌ها را مؤثرتر می‌کند. شرکت‌کنندگان می‌توانند بر درک منطق کسب و کار تمرکز کنند، نه اینکه در تلاش برای یافتن داده‌های تست گیر کنند.

محدودیت‌ها و ملاحظات مهم

تولیدکننده CLABE ما اعداد فنی معتبری ایجاد می‌کند که از بررسی‌های استاندارد عبور می‌کنند، اما مرزهای مهمی وجود دارد که باید درک شوند:

متصل به حساب‌های واقعی نیست: این نکته بسیار مهم است - CLABEهای تولید شده از نظر ساختاری معتبر هستند اما به حساب‌های بانکی واقعی متصل نیستند. آنها را مانند آدرس‌های درست فرمت‌شده برای خانه‌هایی که وجود ندارند تصور کنید. آنها از اعتبارسنجی فرمت عبور می‌کنند، اما نمی‌توانید به آنها پول ارسال کنید. APIهای بانکی این شماره‌ها را هنگام پردازش تراکنش واقعی رد خواهند کرد.

فقط برای محیط‌های تست: از این CLABEها فقط در محیط‌های توسعه، مرحله‌بندی و کنترل کیفیت استفاده کنید. هرگز CLABEهای تست تولید شده را در کد یا فایل‌های پیکربندی تولید سخت‌کد نکنید. اشتباه رایج، باقی گذاشتن CLABEهای تست در پیکربندی تولید است که می‌تواند باعث شکست‌های خاموش هنگام تلاش سیستم برای انتقال‌های واقعی شود.

ارز کد بانک: انجمن بانکداری مکزیک گاهی اوقات کدهای بانکی رسمی را به‌روز می‌کند زیرا مؤسسات ادغام، بازاریابی مجدد یا مجوزهای جدید دریافت می‌کنند. ما فهرست کد بانکی خود را به‌طور منظم به‌روز می‌کنیم، اما ممکن است تأخیر کوتاهی وجود داشته باشد. اگر روی پروژه‌ای با محدودیت زمانی برای یک بانک مکزیکی خاص کار می‌کنید، کد بانک را در مقابل مستندات رسمی CLABE بانک مکزیک تأیید کنید.

مرزهای تست امنیتی: CLABEهای تولید شده برای تست عملکردی کار می‌کنند اما نباید جایگزین تست امنیتی مناسب شوند. برای مثال، تست محافظت از تزریق SQL نیاز به داده‌های تست متفاوتی دارد. همچنین در ثبت CLABEهای تولید شده محتاط باشید - اگرچه آنها جعلی هستند، برچسب‌گذاری واضح از سردرگمی در طول ممیزی‌های امنیتی جلوگیری می‌کند.

تنوعات منطقه‌ای: سیستم بانکداری مکزیک قوانین خاصی دارد که با سایر کشورهای آمریکای لاتین متفاوت است. فرض نکنید که منطق اعتبارسنجی CLABE برای کلیدهای PIX برزیل، شماره‌های CBU آرژانتین یا سایر شناسه‌های پرداخت منطقه‌ای کار خواهد کرد. هر کشور استانداردهای متمایزی دارد.

جایگزین‌های CLABE

در حالی که CLABE استاندارد انتقالات بین‌بانکی مکزیک است، سیستم‌های شناسایی دیگری در دنیای مالی وجود دارند:

1. IBAN (شماره حساب بانکی بین‌المللی): عمدتاً در اروپا و برخی کشورهای دیگر استفاده می‌شود، اما نه در مکزیک.

2. کدهای SWIFT/BIC: برای انتقالات بین‌المللی استفاده می‌شوند، اغلب همراه با CLABE برای انتقالات به مکزیک.

3. شماره‌های مسیریابی ABA: در سیستم بانکداری ایالات متحده استفاده می‌شوند.

4. شماره‌های حساب: شماره‌های ساده حساب بانکی بدون فرمت استاندارد CLABE.

برای آزمایش سیستم‌های مالی مکزیک به طور خاص، CLABE استاندارد مورد نیاز است.

تاریخچه CLABE در مکزیک

سیستم CLABE در سال ۲۰۰۴ توسط انجمن بانکداری مکزیک (Asociación de Bancos de México، ABM) معرفی شد تا انتقال الکترونیکی وجوه بین بانک‌های مکزیک را استاندارد کند. پیش از CLABE، هر بانک سیستم شماره‌گذاری حساب خود را داشت که انتقالات بین بانکی را پیچیده و مستعد خطا می‌کرد.

اجرای CLABE همزمان با توسعه سیستم پرداخت الکترونیکی بین بانکی (Sistema de Pagos Electrónicos Interbancarios، SPEI) بود که یک سیستم تسویه ناخالص آنی توسط بانک مرکزی مکزیک، بانکو دِ مکزیکو، اداره می‌شود.

از زمان معرفی، CLABE برای تمام انتقالات الکترونیکی بین بانکی در مکزیک اجباری شده و به طور قابل توجهی کارایی و اعتمادپذیری سیستم بانکداری مکزیک را بهبود بخشیده است.

بهترین شیوه‌ها برای تست با CLABEs

ایجاد کتابخانه داده‌های تست: به جای تولید CLABEs در هر تست، مجموعه‌ای از CLABEs تأیید شده را در فیکسچرهای تست خود نگهداری کنید. این کار باعث تکرارپذیری تست‌ها و اشکال‌زدایی آسان‌تر می‌شود. زمانی که یک تست شکست می‌خورد، می‌توانید CLABE دقیقی که باعث مشکل شده است را بررسی کنید.

تست با بانک‌های متعدد: فقط با CLABEs یک بانک تست نکنید. بانک‌های مختلف ممکن است ریزه‌کاری‌های متفاوتی در APIهای خود داشته باشند. CLABEs را از حداقل ۳-۴ بانک اصلی مکزیک (مانند BBVA Bancomer، Banamex، Santander و Banorte) تولید کنید تا مطمئن شوید که ادغام شما همه موارد را پوشش می‌دهد.

مستندسازی منابع CLABE تست: هنگام به اشتراک‌گذاری محیط‌های تست با اعضای تیم، به وضوح مشخص کنید که کدام CLABEs تولید تست هستند و کدام (در صورت وجود) از APIهای بانکی سندباکس می‌آیند. این کار از سردرگمی در طول تست ادغام جلوگیری می‌کند و از اشتباه گرفتن اعتبارنامه‌های سندباکس با داده‌های تولید جلوگیری می‌کند.

پیاده‌سازی پاسخ‌های ماک مناسب: هنگام تست اعتبارسنجی CLABE در برنامه خود، نه تنها اعتبارسنجی‌های موفق را ماک کنید، بلکه پاسخ‌های خطای واقعی را نیز شبیه‌سازی کنید: ارقام بررسی نامعتبر، کدهای بانکی ناشناخته و ورودی‌های نامناسب. APIهای بانکی واقعی کدهای خطای خاصی را برای هر نوع شکست برمی‌گردانند.

کنترل نسخه داده‌های تست: اگر از مجموعه خاصی از CLABEs برای تست رگرسیون استفاده می‌کنید، آنها را به کنترل نسخه کامیت کنید. این اطمینان می‌دهد که همه توسعه‌دهندگان و خط‌های CI/CD از داده‌های تست یکسان استفاده می‌کنند و شکست‌های ساخت را قابل بازتولید می‌کند.

اشتباهات رایجی که باید از آنها اجتناب کرد

هنگام کار با شماره‌های CLABE در برنامه‌های خود، به این خطاهای متداول توجه کنید:

پذیرش CLABEهای دارای کاراکترهای فرمت‌بندی: کاربران اغلب CLABEها را با فاصله یا خط تیره وارد می‌کنند (مثلاً "012-345-67890123456-7" یا "012 345 67890123456 7"). اعتبارسنجی شما باید این کاراکترها را قبل از اعتبارسنجی حذف کند، نه اینکه آنها را به طور کامل رد کند. برنامه‌های بانکی مکزیک معمولاً ورودی فرمت‌بندی شده را برای خوانایی بهتر مجاز می‌دانند.

نادیده گرفتن تغییرات کد بانک: بانک‌ها ادغام، بازاریابی مجدد یا تحصیل می‌شوند. برای مثال، زمانی که اسکوشیابانک گروه مالی ING را در مکزیک تحصیل کرد، کدهای بانکی تغییر کردند. اگر برنامه شما کدهای بانکی را ذخیره می‌کند، یک مکانیزم به‌روزرسانی پیاده‌سازی کنید در غیر این صورت CLABEهای جدید معتبر را رد خواهید کرد.

آزمایش ناکافی رقم کنترل: الگوریتم رقم کنترل خاص و غیرقابل مذاکره است. موارد حاشیه‌ای مانند CLABEهایی که رقم کنترل محاسبه شده آنها 0 است را آزمایش کنید (الگوریتم 0 را برمی‌گرداند، نه 10). همچنین اجرای خود را در عملیات مدولو 10 زمانی که مجموع دقیقاً بر 10 تقسیم می‌شود، تأیید کنید.

فرض اینکه همه اعداد 18 رقمی CLABE هستند: هر عدد 18 رقمی یک CLABE معتبر نیست. همیشه کد بانک را در برابر ثبت رسمی اعتبارسنجی کنید و رقم کنترل را تأیید نمایید. یک عدد 18 رقمی تصادفی کمتر از 0.1 درصد شانس عبور از اعتبارسنجی CLABE را دارد.

کدگذاری ثابت نام بانک‌ها: کدهای بانکی ثابت هستند، اما نام‌های بانک‌ها به دلیل بازاریابی مجدد تغییر می‌کنند. کدهای بانکی را در پایگاه داده خود ذخیره کنید، اما هنگام نمایش به کاربران، نام‌های بانک‌های فعلی را از یک مرجع یا API به‌روز دریافت کنید.

ثبت کامل CLABEها در محیط تولید: حتی اگر CLABEهای آزمایشی واقعی نیستند، ایجاد رویه‌های خوب مهم است. در سیستم‌های تولیدی، فقط بخشی از CLABEها (مثلاً 6 رقم اول و 2 رقم آخر) را ثبت کنید تا استانداردهای حریم خصوصی را حفظ کرده و با مقررات محافظت از داده‌های مالی مطابقت داشته باشید.

سؤالات متداول

شماره CLABE برای چه چیزی استفاده می‌شود؟

شماره CLABE برای شناسایی حساب‌های بانکی در سیستم بانکداری مکزیک برای انتقال وجوه الکترونیکی استفاده می‌شود. این اطمینان می‌دهد که پول به حساب صحیح در بانک و شعبه درست ارسال می‌شود.

چگونه می‌توانم تشخیص دهم که یک CLABE به کدام بانک تعلق دارد؟

سه رقم اول شماره CLABE، بانک را شناسایی می‌کند. برای مثال، 012 نشان‌دهنده BBVA Bancomer، 072 نشان‌دهنده Banorte، و 002 نشان‌دهنده Banamex است.

آیا شماره‌های CLABE تولید شده به حساب‌های واقعی متصل هستند؟

خیر. شماره‌های CLABE ایجاد شده توسط این ابزار از نظر ساختاری معتبر هستند اما به هیچ حساب بانکی واقعی متصل نیستند. آنها فقط باید برای اهداف آزمایشی استفاده شوند.

چگونه می‌توانم بفهمم که یک شماره CLABE معتبر است؟

یک CLABE معتبر سه بررسی اساسی را طی می‌کند:

1. اعتبارسنجی طول: دقیقاً 18 رقم (نه بیشتر، نه کمتر)
2. تأیید کد بانک: سه رقم اول باید با کد بانک رسمی مکزیک که توسط ABM ثبت شده مطابقت داشته باشد
3. اعتبارسنجی رقم کنترل: رقم 18 باید با مقدار محاسبه شده با استفاده از الگوریتم مدولو 10 وزنی مطابقت داشته باشد

ابزار تأیید ما همه سه معیار را بررسی می‌کند. توجه داشته باشید که این اعتبارسنجی ساختار و فرمت است - تأیید نمی‌کند که حساب در پایگاه داده واقعی بانک وجود دارد.

آیا می‌توانم از این CLABE‌های تولید شده برای معاملات واقعی استفاده کنم؟

خیر. این فقط CLABE‌های آزمایشی هستند و هرگز نباید برای معاملات مالی واقعی استفاده شوند. آنها به حساب‌های واقعی هدایت نخواهند شد.

کدهای بانکی چه زمانی به‌روز می‌شوند؟

ما پایگاه داده کدهای بانکی خود را با ثبت رسمی انجمن بانکداری مکزیک (ABM) به صورت سه‌ماهه همگام می‌کنیم، اگرچه تغییرات عمده (بانک‌های جدید، ادغام‌ها، تملک‌ها) ظرف چند روز منعکس می‌شوند. تغییرات کد بانکی نسبتاً نادر هستند - مکزیک در طول چند سال گذشته کم و بیش همان مجموعه اصلی مؤسسات را داشته است. اگر با یک بانک مکزیکی خاص ادغام می‌شوید و نیاز به اطلاعات دقیق کد بانکی دارید، با مستندات رسمی CLABE بانک مکزیک مطابقت دهید.

چرا اپلیکیشن بانکی من یک CLABE را که ابزار شما می‌گوید معتبر است، رد می‌کند؟

ابزار ما اعتبار ساختاری را تأیید می‌کند - طول صحیح، کد بانک معتبر، محاسبه صحیح رقم کنترل. با این حال، برنامه‌های بانکی بررسی‌های اضافی انجام می‌دهند: آنها تأیید می‌کنند که حساب در پایگاه داده آنها وجود دارد، فعال بودن حساب (مسدود یا بسته نشده) را تأیید می‌کنند و مجوزها را بررسی می‌کنند. یک CLABE کاملاً ساختاری با این بررسی‌های دنیای واقعی شکست می‌خورد زیرا به یک حساب واقعی متصل نیست. این رفتار مورد انتظار است و دقیقاً همان دلیلی است که این CLABE‌ها فقط برای آزمایش هستند.

آیا می‌توانم CLABE‌ها را برای یک بانک خاص تولید کنم؟

بله، ابزار ما به شما اجازه می‌دهد هنگام تولید CLABE‌ها یک بانک خاص را انتخاب کنید، اطمینان می‌دهد که بخش کد بانک با مؤسسه انتخابی شما مطابقت دارد.

رقم کنترل چگونه محاسبه می‌شود؟

رقم کنترل از یک الگوریتم مدولو 10 وزنی که در استاندارد CLABE رسمی تعریف شده استفاده می‌کند. هر یک از 17 رقم اول در یک الگوی وزنی تکرار شونده (3، 7، 1، 3، 7، 1، ...) ضرب می‌شود، فقط آخرین رقم هر محصول نگه داشته می‌شود. این ارقام جمع می‌شوند و رقم کنترل به عنوان (10 - (مجموع mod 10)) mod 10 محاسبه می‌شود. این الگوریتم کشف خطای قوی ارائه می‌دهد - تمام خطاهای تک رقمی و اکثر خطاهای جابجایی را که رایج‌ترین اشتباهات ورود داده هستند، می‌گیرد.

آیا محدودیتی برای تعداد CLABE‌هایی که می‌توانم یکجا تولید کنم وجود دارد؟

ابزار تا 100 CLABE در هر دسته تولید می‌کند که برای اکثر سناریوهای آزمایش کافی است. اگر برای آزمایش بار گسترده به هزاران CLABE نیاز دارید، ژنراتور را چندین بار اجرا کنید یا الگوریتم رقم کنترل را مستقیماً در کارخانه‌های داده آزمایشی خود ادغام کنید. الگوریتم به اندازه کافی ساده است که بتوان آن را مستقیماً در چارچوب آزمایش خود پیاده‌سازی کرد.

مراجع

1. بانک مکزیک. "کلابه - کلید بانکی استاندارد شده." https://www.banxico.org.mx/servicios/clabe-estandarizada.html

2. انجمن بانک‌های مکزیک (ABM). "فهرست کدهای موسسات اعتباری." https://www.abm.org.mx/

3. سیستم پرداخت‌های الکترونیکی بین بانکی (SPEI). "قوانین عملیاتی." https://www.banxico.org.mx/sistemas-de-pago/servicios/sistema-de-pagos-electronicos-interbancarios-spei/

4. کمیسیون ملی بانکی و اوراق بهادار (CNBV). "مقررات عمومی قابل اجرا برای موسسات اعتباری." https://www.gob.mx/cnbv

---

آماده آزمایش یکپارچگی پرداخت مکزیک هستید؟ از این تولیدکننده کلابه برای ایجاد داده‌های آزمایشی معتبر که دقیقاً با فرمت و قوانین اعتبارسنجی بانک‌های مکزیکی مطابقت دارد استفاده کنید. برای آزمایش‌های سریع، یک کلابه تولید کنید، یا تا 100 عدد را برای سناریوهای آزمایش جامع بسازید، یا کلابه‌های موجود را تأیید کنید تا دلیل شکست اعتبارسنجی آنها را درک کنید.

برای سیستم‌های تولیدی، به یاد داشته باشید که تمام کلابه‌های آزمایشی را با شماره حساب‌های واقعی ارائه شده توسط شرکای بانکی مکزیکی یا به دست آمده از محیط‌های سندباکس رسمی جایگزین کنید. این اعداد تولید شده خاصاً برای محیط‌های توسعه و کنترل کیفیت طراحی شده‌اند که به داده‌های آزمایشی واقع‌بینانه بدون اتصال به حساب‌های بانکی واقعی نیاز دارید.