> ## 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.

# الربط البنكي المستضاف: أرسل رابطاً دون كود في صفحتك

> أنشئ رابطاً على خادمك وأرسل المستخدم إلى عنوانه URL. تستضيف Didit كل الشاشات وتعيده إلى `redirect_url` عند الانتهاء.

رابط Bank Link المستضاف من Didit هو الطريقة المتاحة حاليًا لربط حساب بنكي: تنشئ رابطًا، وترسل الشخص إلى `url` الخاص به، ويعرض Didit كل الشاشات في صفحته الخاصة.
تتوفر بيانات البنوك لتطبيقات البيئة التجريبية. أما استدعاءات التطبيق في بيئة الإنتاج فتُرجع `404` إلى أن يُعلن عن إتاحة الوصول إلى الإنتاج.

## إنشاء الرابط وإرساله إلى الشخص

```bash theme={null}
curl -X POST https://verification.didit.me/v3/bank/links/ \
  -H "x-api-key: $DIDIT_API_KEY" -H "content-type: application/json" \
  -d '{
    "access": "ongoing",
    "country": "ESP",
    "data": ["accounts", "balances", "transactions"],
    "end_user": { "reference": "client-7731" },
    "vendor_data": "client-7731"
  }'
```

وجّه المتصفح إلى `url` الموجود في الاستجابة، أو ضعه في بريد إلكتروني أو رسالة.
يُعاد `url` فقط عند إنشاء الرابط، ويتوقف الرابط عن العمل عند انتهاء صلاحيته (60 دقيقة افتراضياً، ومن 5 دقائق إلى 24 ساعة باستخدام `expires_in`).

## ما الذي يحدث في النهاية

* مع `redirect_url` يقبله Didit، يعود المتصفح إليه. راجع [العودة إلى موقعك](https://docs.didit.me/ar/integration/bank-link/return-to-your-site.md).
* ومن دونه، تنتهي العملية في صفحة نتائج Didit.
* في كلتا الحالتين، يخبرك كلٌّ من webhook ‏`bank.link.completed` و`GET /v3/bank/links/{id}/` بالنتيجة.

## تأكيد على خادمك

عند وصول `bank.link.completed`، استدعِ `GET /v3/bank/links/{id}/` باستخدام معرّف الرابط الذي خزّنته لهذا المستخدم.
ويُعيد `status: completed` مع `connection_id`، أو فشلاً نهائياً مع `error.code`.
ثم تابع إلى [البدء السريع](https://docs.didit.me/ar/core-technology/bank-verification/quickstart.md#الخطوة-4-استقبال-الـ-webhooks-والتأكيد).


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