> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# إثراء عنوان IP للمعاملات: الدولة وASN وVPN

> يُثري Didit كل معاملة بسياق عنوان IP: الدولة وASN وVPN وTor ومركز البيانات والمشغل. 1,000 شهرياً مجاناً، ثم $0.001 لكل استدعاء.

تُثرى كل معاملة تتضمن عنوان IP للجهاز من جهة الخادم في الوقت الفعلي قبل أن تُقيَّم القواعد عليها. يضيف الإثراء الدولة والمدينة، وعلامات VPN وTor ومراكز البيانات، وASN، وشركة الاتصالات، وكلها متاحة كشروط للقواعد.

## متى يعمل الإثراء

يعمل الإثراء بشكل مضمَّن أثناء إنشاء المعاملة:

1. ترسل `POST /v3/transactions/` مع `subject.device_context.network_context.ip_address` (أو عنوان IP لجهاز أي طرف).
2. يبحث Didit عن عنوان IP في ذاكرة التخزين المؤقت داخل الذاكرة (TTL مدته 24 ساعة).
3. إذا لم يكن العنوان مخزنًا مؤقتًا، يتحقق من جدول الإثراء المشترك لعناوين IP (حداثة البيانات نحو 30 يومًا).
4. إذا كانت البيانات قديمة أو غير موجودة، يحل Didit عنوان IP عبر خط الإثراء الخاص به، مع التبديل التلقائي إلى مزود آخر عند الفشل.
5. تُكتب الحقول المُثراة في سجل المعاملة وتصبح متاحة للقواعد.

الإثراء **مضمَّن**: يكتمل قبل تشغيل القواعد، لكنه **غير مانع عند الفشل**. إذا تعذر إكمال الإثراء، تستمر المعاملة، ويظهر عنوان IP دون بيانات الإثراء.

## الحقول المُثراة

| الحقل | الوصف |
| - | - |
| `ip_country` | اسم الدولة |
| `ip_country_code` | رمز ISO 3166-1 alpha-2 عندما يحله Didit (القيمة التي أرسلتها تُحفظ كما أرسلتها)؛ تُوحّد شروط القواعد الشكلين معًا |
| `ip_state` | التقسيم الإداري (الولاية أو المنطقة) |
| `ip_city` | اسم المدينة |
| `latitude`, `longitude` | الإحداثيات الجغرافية |
| `isp` | اسم مزود خدمة الإنترنت |
| `organization` | اسم المؤسسة المسجلة |
| `is_vpn_or_tor` | قيمة منطقية (Boolean): عنوان IP هو نقطة خروج معروفة لشبكة VPN أو Tor |
| `is_data_center` | قيمة منطقية (Boolean): عنوان IP ينتمي إلى نطاق استضافة أو مركز بيانات |
| `time_zone` | المنطقة الزمنية وفق IANA (مثل `America/New_York`) |
| `time_zone_offset` | الفارق عن التوقيت العالمي المنسّق (UTC) |
| `asn_number` | رقم نظام الإنترنت المستقل (ASN) |
| `asn_organization` | المؤسسة المسجلة للـ ASN |
| `connection_type` | `mobile`, `broadband`, `dialup`, `corporate`, ... |
| `carrier` | شركة الاتصالات (لعناوين IP للهاتف المحمول) |
| `proxy_type` | `VPN`, `TOR`, `PUBLIC_PROXY`, أو null |

## استخدام الحقول المُثراة في القواعد

يمكن استخدام أي حقل من الحقول المُثراة كـ[شرط قاعدة](https://docs.didit.me/ar/transaction-monitoring/rules.md). من الأنماط الشائعة:

**الولاية القضائية عالية المخاطر حسب عنوان IP**

```
condition: applicant.ip_country_code IN ['IRN', 'PRK', 'SYR']
action: add_score(35), add_tags(['high_risk_ip_country'])
```

**استخدام VPN أو Tor**

```
condition: applicant.is_vpn_or_tor == true
action: change_status('IN_REVIEW'), add_tags(['anonymization'])
```

**مركز بيانات أو مصدر غير سكني**

```
condition: applicant.is_data_center == true AND amount > 10000
action: add_score(30)
```

**دولة عنوان IP ≠ دولة KYC**

```
condition: applicant.ip_country_code != applicant.country_code
action: add_score(15), add_tags(['geo_mismatch'])
```

## طبقات التخزين المؤقت

| الطبقة | TTL | الغرض |
| - | - | - |
| ذاكرة التخزين المؤقت داخل الذاكرة | 24 ساعة | بحث في أقل من ميلي ثانية لعناوين IP النشطة |
| جدول الإثراء المشترك لعناوين IP | نحو 30 يومًا | مشترك بين المثيلات؛ أقل تكلفة من إعادة الحل |
| خط الإثراء | لا ينطبق | بيانات حديثة عندما لا تتوفر في أي مكان آخر |

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

## سلوك الفشل

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

## تصفية العناوين بحسب الصلاحية

تُتخطى عناوين IP غير القابلة للتوجيه قبل الإثراء:

* الخاصة (10/8، 172.16/12، 192.168/16)
* الاسترجاعية (127/8)
* المحلية للارتباط (169.254/16)
* الإرسال المتعدد وغير المحددة

هذا يوفر حصة المزود ويتجنب بيانات إثراء غير منطقية.

## فحص الإثراء لمعاملة

**عبر الواجهة البرمجية.** لا توجد كتلة إثراء منفصلة. تُكتب الحقول المُثراة داخل كائن `device.network_context` الخاص بالطرف نفسه، بجوار `ip_address` الذي أرسلته، في العنصر المطابق من المصفوفة `parties`:

```json theme={null}
"parties": [
  {
    "role": "APPLICANT",
    "vendor_data": "user-42",
    "device": {
      "network_context": {
        "ip_address": "203.0.113.5",
        "ip_country": "United States",
        "ip_country_code": "US",
        "ip_state": "California",
        "ip_city": "San Francisco",
        "is_vpn_or_tor": false,
        "is_data_center": false,
        "asn_number": 64496,
        "asn_organization": "Example ISP",
        "proxy_type": null
      }
    }
  }
]
```

تُحفظ الحقول التي أرسلتها في الطلب. يملأ الإثراء المفاتيح التي تركتها فقط، ولا تُدرج المفاتيح التي أعادها المُحلِّل فارغة. راجع [مخطط الاستجابة](https://docs.didit.me/ar/transaction-monitoring/response-schema.md#device) للاطلاع على بنية `device` الكاملة.

**في الكونسول.** تعرض صفحة تفاصيل المعاملة الإثراء في تبويب **IP & Device** مع دبوس على خريطة جغرافية.

## اعتبارات الخصوصية

* تُخزَّن عناوين IP الخام مع المعاملة.
* بيانات الإثراء موجودة في جدول مشترك مفتاحه عنوان IP، وليست خاصة بكل مستخدم.
* يؤدي الحذف بموجب الحق في النسيان إلى إزالة عناوين IP من المعاملة، ويبقى إدخال التخزين المؤقت المشترك (لأنه لا يحدد هوية شخص بعينه).

## الخطوات التالية

> [card] [القواعد](https://docs.didit.me/ar/transaction-monitoring/rules.md)
>
> استخدم الحقول المُثراة في الشروط.

> [card] [مكتبة القواعد](https://docs.didit.me/ar/transaction-monitoring/rules-library.md)
>
> قواعد جاهزة تعتمد على عنوان IP.

> [card] [مخطط الاستجابة](https://docs.didit.me/ar/transaction-monitoring/response-schema.md)
>
> المكان الذي يظهر فيه إثراء IP.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.