التحقق من حالة CPF في البرازيل عبر واجهة برمجة التطبيقات (AR)

تتطلب عملية ضم المستخدمين في البرازيل التأكد من هويتهم الحقيقية. تُرجع هذه الخدمة حالة CPF (عادي، معلق، ملغى)، الاسم وتاريخ الميلاد من Receita Federal عبر SERPRO. أي مستند أو تفاصيل مكتوبة تثبت فقط أن البيانات موجودة — لا أنها حقيقية أو تخص الشخص الذي أمامك. يغلق التحقق من حالة CPF في البرازيل هذه الفجوة عن طريق التحقق من البيانات مقابل سلطة الضرائب الوطنية. يشرح هذا الدليل ما يقوم به هذا التحقق، التفاصيل التقنية الدقيقة، وكيفية دمجه في دقائق.

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

• ما الذي يتم التحقق منه — يتحقق التحقق من حالة CPF في البرازيل من هوية دافعي الضرائب مقابل سلطة الضرائب الوطنية.
• ما الذي تحصل عليه — match_type موحد بالإضافة إلى نتائج على مستوى الحقل يمكنك توجيهها مباشرة إلى منطق الموافقة / المراجعة / الرفض.
• لماذا هو مهم — يربط التحقق من هوية دافعي الضرائب مقدم الطلب بهوية مالية قابلة للتحقق، مما يقلل من الاحتيال بالهوية الاصطناعية والاحتيال من الطرف الأول.
• كيفية استخدامه — POST واحد إلى نقطة نهاية التحقق من قاعدة بيانات Didit، أو وحدة سير عمل بدون تعليمات برمجية. 0.20 دولار لكل استعلام مؤكد، والنتائج في ثوانٍ.

ما الذي يتحقق منه التحقق من حالة CPF في البرازيل

تُرجع هذه الخدمة حالة CPF (عادي، معلق، ملغى)، الاسم وتاريخ الميلاد من Receita Federal عبر SERPRO. تعرض Didit هذه الخدمة من خلال نقطة نهاية واحدة حتى تتمكن من التحقق من البيانات المقدمة مقابل سلطة الضرائب الوطنية وتلقي نتيجة منظمة وموحدة — وليس تفريغًا خامًا للسجل عليك تحليله بنفسك.

تُرجع الاستجابة المؤكدة source_data المطابقة وكتلة validation على مستوى الحقل، بحيث تحصل محرك المخاطر الخاص بك على حكم واضح وقابل للقراءة آليًا.

لماذا هو مهم

يربط التحقق من هوية دافعي الضرائب مقدم الطلب بهوية مالية قابلة للتحقق، مما يقلل من الاحتيال بالهوية الاصطناعية والاحتيال من الطرف الأول.

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

التفاصيل التقنية

تعرض Didit هذه الخدمة من خلال نقطة نهاية التحقق من قاعدة البيانات الموحدة. إنها POST واحدة — لا يلزم وجود SDK.

نقطة النهاية

POST /v3/database-validation/

معلمات الطلب

المعلمة	النوع	مطلوب	الوصف
issuing_state	سلسلة	نعم	رمز البلد ISO 3166-1 alpha-3. استخدم BRA.
services	سلسلة	نعم	معرف الخدمة. استخدم bra_cpf.
tax_number	سلسلة	نعم	الرقم الضريبي.
first_name	سلسلة	لا	الاسم الأول (تحقق اختياري).
last_name	سلسلة	لا	اسم العائلة (تحقق اختياري).
date_of_birth	سلسلة	لا	تاريخ الميلاد (تحقق اختياري).

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

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=BRA" \
  -F "services=bra_cpf" \
  -F "tax_number=1111111"

مثال على الاستجابة (مطابقة مؤكدة)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "BRA",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "bra_cpf",
      "service_name": "Brazil - CPF status check",
      "source_data": {
        "date_of_birth": "1990-01-01",
        "first_name": "John",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe",
        "lgpd_minor": "sample_value",
        "minor_under_16": "sample_value",
        "minor_under_18": "sample_value"
      },
      "validation": {
        "date_of_birth": "full_match",
        "full_name": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}

الأداء والفوترة

• الكمون: عادة بضع ثوانٍ.
• التكلفة: 0.20 دولار لكل استعلام مؤكد. يتم محاسبتك فقط على النتائج المؤكدة — لا توجد رسوم على تعطل المصدر، الحقول المفقودة، أو الرفض قبل المصدر.
• الموثوقية: يعمل على بنية Didit التحتية مع هدف وقت تشغيل ربع سنوي بنسبة 99.9%.

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

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

كيفية التكامل مع Didit

يمكنك تشغيل التحقق من حالة CPF في البرازيل بطريقتين:

1. سير عمل بدون تعليمات برمجية. في Didit Business Console، افتح Workflow Builder، أضف وحدة Database Validation، حدد Brazil → Brazil CPF status check Verification، وقم بتنشيطها. يتم توجيه المستخدمين المطابقين تلقائيًا — لا يلزم وجود هندسة.
2. واجهة برمجة تطبيقات مباشرة. استدعِ نقطة النهاية /v3/database-validation/ الموضحة أعلاه باستخدام services=bra_cpf. اقرأ match_type وكتلة validation على مستوى الحقل لتشغيل منطق الموافقة / المراجعة / الرفض الخاص بك.

يتضمن كل حساب Didit 500 عملية تحقق مجانية شهريًا، حتى تتمكن من اختبار التدفق بالكامل من البداية إلى النهاية قبل أن تدفع مقابل استعلام واحد.

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

ما الذي يؤكده التحقق من حالة CPF في البرازيل؟

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

ماذا يحدث إذا كان المصدر غير متاح مؤقتًا؟

لا يتم تحصيل رسوم منك. تنطبق الفوترة فقط على النتائج المؤكدة — تعطل المصدر، الحقول المفقودة، والرفض قبل المصدر مجانية.

ما هي سرعة التحقق؟

يعود التحقق من قاعدة البيانات عادة في بضع ثوانٍ، لذلك يتناسب مع تدفق ضم العملاء في الوقت الفعلي.

هل أحتاج إلى SDK؟

لا. التحقق هو POST واحد لـ HTTPS إلى نقطة نهاية واحدة. يمكنك أيضًا ربطه بسير عمل بدون تعليمات برمجية في Business Console.

هل أنت مستعد للبدء؟

تحقق من أول هوية دافع ضرائب برازيلية اليوم.

• اقرأ مرجع واجهة برمجة التطبيقات: التحقق من حالة CPF في البرازيل
• اطلع على جميع عمليات التحقق من قاعدة البيانات: تسعير وتغطية التحقق من قاعدة البيانات
• ابدأ البناء: أنشئ حساب Didit مجاني — 500 عملية تحقق شهريًا، مجانًا.