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

التحقق من رقم بطاقة الائتمان بخوارزمية Luhn

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

● Betaمجاني · داخل متصفحك

شغّل الأداة مجانًا اطّلع على الـAPI

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

كما تعرض شبكة البطاقة المرجحة بالاعتماد على بادئات Visa وMastercard وAmerican Express وDiscover المعروفة. تساعد النتيجة على اكتشاف أخطاء الإدخال الشائعة قبل طلب الدفع، لكنها لا تثبت وجود الحساب أو نشاطه أو ملكيته للعميل أو قدرته على إتمام عملية شراء.

آلية توحيد الإدخال وفحصه

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

المعنى الدقيق لنتيجة Luhn

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

كيفية تحديد شبكة البطاقة المرجحة

تُستنتج الشبكة من بادئة تعريف الجهة المصدرة، ولا تُجلب من سجل بعيد. يُصنف الرقم الذي يبدأ بـ 4 على أنه Visa. تشمل Mastercard المجال التقليدي من 51 إلى 55 والمجال الأحدث من 2221 إلى 2720. تستخدم American Express البادئتين 34 و37. وتشمل Discover البادئتين 6011 و65، والمجال من 644 إلى 649، والمجال المخصص من 622126 إلى 622925. إذا لم تتطابق أي قاعدة، تعاد الشبكة بوصفها غير معروفة مع استمرار حساب Luhn بصورة طبيعية. وصف الشبكة بالمرجحة مهم لأن التخصيصات تتغير وتوجد منتجات مشتركة، ولأن هذه الأداة تتعرف عمداً على الشبكات الأربع المطلوبة فقط. كشف البادئة ومجموع التحقق مستقلان؛ فقد يطابق الرقم شبكة معروفة ويفشل في Luhn، أو يجتاز Luhn وتظل شبكته مجهولة. يستخدم كل طلب السعر الأساسي المنشور $0.002، ولا توجد رسوم متغيرة حسب طول الرقم أو الشبكة المكتشفة.

حالات الاستخدام

تنبيه أثناء إدخال بيانات الدفع

اكتشفوا رقماً يُرجح أنه كُتب خطأ قبل تسليم بيانات الدفع إلى معالج ملتزم لإجراء التفويض.

فحص جودة السجلات المستوردة

افحصوا سلامة بنية أرقام السجلات القديمة من دون الادعاء بأن الحسابات المرتبطة بها ما زالت نشطة.

اختبار نماذج الدفع

تأكدوا من قبول فواصل التنسيق المسموحة ورفض المحارف غير الصحيحة بصورة متسقة.

الأسئلة الشائعة

هل اجتياز Luhn يثبت أن البطاقة حقيقية؟

لا. إنه يثبت فقط أن الأرقام تحقق مجموع التحقق. أما الوجود والملكية والحالة والرصيد والتفويض فتتطلب استجابة معالج الدفع والجهة المصدرة.

ما محارف التنسيق التي يمكن استخدامها؟

يمكنكم استخدام المسافات والواصلات؛ إذ تُحذف قبل الفحص. ويتسبب أي محرف آخر غير رقمي في خطأ إدخال.

ما شبكات البطاقات التي يمكن تحديدها؟

تتعرف قواعد البادئات على Visa وMastercard وAmerican Express وDiscover بصورة مرجحة، وتعيد البادئات الأخرى بوصفها غير معروفة.

هل يمكن أن تفشل بادئة معروفة في مجموع التحقق؟

نعم. تصنيف البادئة وحساب Luhn مستقلان، ولذلك لا تضمن بادئة تشبه Visa اجتياز الفحص.

هل تتصل الأداة بمصرف أو شبكة بطاقات؟

لا. تعتمد النتيجة على حساب حتمي وقواعد للبادئات، من دون استعلام بعيد أو محاولة تفويض.

للمطوّرين — الوصول عبر API

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

الـEndpoint

POSThttps://api.kit.forhosting.com/data/credit-card-luhn-validate

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

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/data/credit-card-luhn-validate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"number":"4111 1111 1111 1111"}'

const res = await fetch("https://api.kit.forhosting.com/data/credit-card-luhn-validate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "number": "4111 1111 1111 1111"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/data/credit-card-luhn-validate",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "number": "4111 1111 1111 1111"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/data/credit-card-luhn-validate", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"number":"4111 1111 1111 1111"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"number":"4111 1111 1111 1111"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/data/credit-card-luhn-validate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "number": "4111 1111 1111 1111"
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "data.credit_card_luhn_validate",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

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

الأسعار

لكل طلب$0.002

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

الحدود

max_mb 25

الأخطاء

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

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