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

# دليل البدء السريع لبيانات البنك: ربط بنك اختبار وقراءة المعاملات

> من التطبيق في البيئة التجريبية إلى حسابات Didit Test Bank وأرصدته ومعاملاته: أنشئ مفتاحاً ورابطاً، واربط، واقرأ، وزامن، واحذف.

تتوفّر بيانات البنك للتطبيقات في البيئة التجريبية.
تُرجع استدعاءات تطبيق الإنتاج الرمز `404` إلى أن يُعلَن عن إتاحة الوصول إلى بيئة الإنتاج، ولا تُحتسب أي رسوم في البيئة التجريبية.
يأخذك هذا الدليل السريع من تطبيق في البيئة التجريبية إلى الحسابات والأرصدة والمعاملات الخاصة بـ Didit Test Bank، عبر طلبات جاهزة للنسخ واللصق.

> [!NOTE]
>
> كل استجابة معروضة أدناه مقتصرة على الحقول المهمة.
> احتفظ بمفتاح API على خادمك، فهو لا يصل إلى المتصفح أو التطبيق أبدًا.

## الخطوة 1: إنشاء مفتاح API بصلاحية Bank data

لا تُعدّ صلاحية Bank data جزءاً من الوصول الكامل.
يُرفض المفتاح ذو الوصول الكامل، بما فيه السر الأساسي للتطبيق، في كل استدعاء لـ Bank data مع الخطأ `403 bank_data_access_denied`.

1. في [Business Console](https://business.didit.me)، افتح تطبيق البيئة التجريبية الخاص بك وانتقل إلى **API keys**.
2. أنشئ مفتاحاً بوصول مخصص وأضف **Bank data**: **Read** للقراءات، و**Write** للاستدعاءات التي تنشئ شيئاً أو تعدّله أو تحذفه.
3. انسخ المفتاح وصدّره:

```bash theme={null}
export DIDIT_API_KEY="your-sandbox-key"
```

راجع [مفاتيح API](https://docs.didit.me/ar/console/api-keys.md) للاطلاع على القائمة الكاملة للموارد.

## الخطوة 2: إنشاء رابط

الرابط هو تشغيل واحد لمجموعة الشاشات يتصل فيها الشخص ببنك.
أنشئ رابطًا مستمرًا لـ Test Bank:

```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"],
    "history_days": 90,
    "vendor_data": "client-7731"
  }'
```

`country` هو رمز الدولة المكوّن من ثلاثة أحرف للبنك الذي يتعامل معه الشخص، وهو اختياري.
أرسله عندما تعرفه، فيرى الشخص بنوك تلك الدولة فقط. وإن لم ترسله، يختار الشخص من بين كل الدول التي يمكنك تقديم الخدمة لها.
للوصول لمرة واحدة، أرسل `"access": "one_time"` (وهي القيمة الافتراضية).

```json theme={null}
{
  "id": "0b9c4f1e-6a2d-4e8b-9f31-7c5d2e1a8b40",
  "mode": "connect",
  "access": "ongoing",
  "status": "created",
  "url": "https://verify.didit.me/bank/link/...",
  "expires_at": "2026-11-22T13:00:00Z",
  "connection_id": null
}
```

اربط المعرّف `id` الخاص بالرابط بالمستخدم لديك.
تُعاد `url` و`client_token` مرة واحدة فقط، عند إنشاء الرابط.

## الخطوة 3: افتح الرابط واربط Didit Test Bank

افتح `url` في المتصفح، أو أرسله إلى الشخص عبر البريد الإلكتروني أو الدردشة.
يرى الشخص شاشة الموافقة، ويختار **Didit Test Bank**، ويسجّل الدخول بأحد العملاء التجريبيين، ثم يختار الحسابات التي يريد مشاركتها.
تسرد [صفحة البيئة التجريبية](https://docs.didit.me/ar/core-technology/bank-verification/sandbox.md) العملاء التجريبيين، وما يمنحك إياه كل منهم.

لإعادة الشخص إلى موقعك بعد ذلك، راجع [العودة إلى موقعك](https://docs.didit.me/ar/integration/bank-link/return-to-your-site.md).
إذا لم تُحدِّد `redirect_url`، ينتهي الشخص على صفحة نتيجة Didit، وتعرف النتيجة من webhook أو من قراءة البيانات.

## الخطوة 4: استقبال الـ webhooks والتأكيد

اشترك بوجهة webhook في أحداث `bank.*` من وحدة التحكم، كما هو الحال مع أي [webhook](https://docs.didit.me/ar/integration/webhooks.md).
عندما ينتهي المستخدم، يصل الحدث `bank.link.completed` مع `link_id` و`connection_id`، ثم يصل الحدث `bank.connection.created` بعد أن تُخزّن أول مزامنة الحسابات.

لا تثق أبدًا بمعرّف رابط يرسله لك المتصفح.
اقرأ الرابط بنفسك:

```bash theme={null}
curl https://verification.didit.me/v3/bank/links/$LINK_ID/ -H "x-api-key: $DIDIT_API_KEY"
```

```json theme={null}
{ "id": "0b9c4f1e-6a2d-4e8b-9f31-7c5d2e1a8b40", "status": "completed", "connection_id": "5e1d2a70-3b4c-4d5e-8f60-71829304a5b6" }
```

تكون قيمة `status` إما `completed` أو قيمة نهائية أخرى (`cancelled` أو `expired` أو `failed`). الرابط الذي تكون حالته `failed` يحمل `error.code`، أما الرابط الذي تكون حالته `cancelled` فيكون `error: null`.

## الخطوة 5: قراءة الحسابات والأرصدة والمعاملات

```bash theme={null}
curl https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/accounts/ -H "x-api-key: $DIDIT_API_KEY"
curl https://verification.didit.me/v3/bank/accounts/$ACCOUNT_ID/balances/ -H "x-api-key: $DIDIT_API_KEY"
curl "https://verification.didit.me/v3/bank/accounts/$ACCOUNT_ID/transactions/?date_from=2026-01-01" -H "x-api-key: $DIDIT_API_KEY"
```

المبالغ سلاسل نصية عشرية، وتكون سالبة للأموال الخارجة.
تتضمن صفحة المعاملات الحقل `next_page_token` طالما بقي المزيد لقراءته.
راجع [الحسابات والأرصدة والمعاملات](https://docs.didit.me/ar/core-technology/bank-verification/accounts-balances-transactions.md).

## الخطوة 6: متابعة خلاصة التغييرات

تُعيد خلاصة التغييرات ما تغيّر فقط منذ قراءتك الأخيرة.
قراءتك الأولى، دون مؤشر، هي اللقطة الكاملة: كل معاملات الاتصال، وكل معاملة منها بالحالة `added` مع `reset: true`.
قد تتضمن الصفحة الأولى `has_more: true` مع `next_page_token`، دون وجود `next_cursor` بعد.
واصل القراءة باستخدام `page_token` ما دامت قيمة `has_more` هي `true`، واحفظ `next_cursor` الخاص بالصفحة الأخيرة (تلك التي يكون فيها `has_more: false`) للمرة القادمة:

```bash theme={null}
curl "https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/transactions/sync/" -H "x-api-key: $DIDIT_API_KEY"
curl "https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/transactions/sync/?page_token=$NEXT_PAGE_TOKEN" -H "x-api-key: $DIDIT_API_KEY"
curl "https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/transactions/sync/?cursor=$NEXT_CURSOR" -H "x-api-key: $DIDIT_API_KEY"
```

تعني `reset: true` أن الاستجابة لقطة كاملة، فاستبدل نسختك بها بدلًا من إضافتها إليها.
يُعلمك الحدث `bank.data.updated` متى خزّنت مزامنةٌ بيانات جديدة.

## الخطوة 7: المزامنة الآن

تتم مزامنة الاتصال المستمر تلقائياً.
لقراءة بيانات البنك الآن، اطلب مزامنة:

```bash theme={null}
curl -X POST https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/refresh/ -H "x-api-key: $DIDIT_API_KEY"
```

يسمح البنك بعدد محدود من القراءات غير المراقبة في اليوم.
يُبيّن الحقلان `sync.live_syncs_left_today` و`sync.budgets` في الاتصال عدد القراءات المتبقية وموعد إعادة ضبطها، ويرد الاستدعاء الذي يتجاوز الحد بالرمز `429 refresh_limit_reached` مع وقت إعادة الضبط.
راجع [تحديث بيانات البنك عند الطلب](https://docs.didit.me/ar/use-cases/refresh-bank-data-on-demand.md).

## الخطوة 8: إيقاف الوصول والحذف

إيقاف الوصول والحذف استدعاءان منفصلان.

```bash theme={null}
# Stop access at the bank. The connection keeps its data until you delete it.
curl -X POST https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/revoke/ -H "x-api-key: $DIDIT_API_KEY"

# Delete the connection and its data. Irreversible.
curl -X DELETE https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/ -H "x-api-key: $DIDIT_API_KEY"
```

لا تحتوي استجابة الاتصال المحذوف إلا على الحقول `id` و`status` و`status_reason` و`created_at` و`erasure`.
راجع [البيانات والموافقة والحذف](https://docs.didit.me/ar/core-technology/bank-verification/data-consent-and-deletion.md).

## Next steps

* [الاتصالات](https://docs.didit.me/ar/core-technology/bank-verification/connections.md): الوصول لمرة واحدة والوصول المستمر، والموافقة والتجديد.
* [webhook الخاصة بالبنوك](https://docs.didit.me/ar/core-technology/bank-verification/webhooks.md)
* [الأسعار](https://docs.didit.me/ar/getting-started/bank-verification-pricing.md)
* [مرجع API](https://docs.didit.me/ar/standalone-apis/bank-data.md)


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