Saudi Openbanking

الخدمات المصرفية المفتوحة السعودية

دليل التكامل مع إطار الخدمات المصرفية المفتوحة في المملكة العربية السعودية (SAMA Open Banking).

إطار عمل البنك المركزي (SAMA Open Banking)

الموقع: https://openbanking.sa

أطلق البنك المركزي السعودي (ساما) إطار الخدمات المصرفية المفتوحة لتمكين مشاركة البيانات المالية بشكل آمن.

الخدمات الأساسية

آلية العمل

1. التسجيل: الحصول على رخصة TSP من ساما
2. الموافقة: العميل يوافق على مشاركة بياناته عبر البنك
3. الوصول: استخدام Access Token للوصول للبيانات
4. التجديد: تجديد الصلاحية عبر Refresh Token

Lean Technologies -- أول مزود خدمة مرخص

أول مزود خدمة طرف ثالث (TSP) مرخص من ساما.

التوثيق: https://docs.leantech.me/v2.0-KSA/ بيئة الاختبار: https://sandbox.sa.leantech.me

الإعداد

export LEAN_APP_TOKEN="your-lean-app-token"

المصادقة

جميع الطلبات تتطلب lean-app-token في الهيدر.

ربط حساب العميل (Link)

curl -X POST "https://sandbox.sa.leantech.me/v2/customers" \
  -H "lean-app-token: ${LEAN_APP_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "app_user_id": "user-123"
  }'

جلب حسابات العميل

curl -X GET "https://sandbox.sa.leantech.me/v2/customers/{customer_id}/accounts" \
  -H "lean-app-token: ${LEAN_APP_TOKEN}" \
  -H "Content-Type: application/json"

الاستجابة:

{
  "accounts": [
    {
      "account_id": "acc_xxx",
      "iban": "SA0000000000000000000000",
      "currency": "SAR",
      "balance": 15000.50,
      "type": "current",
      "bank": "Al Rajhi Bank"
    }
  ]
}

جلب المعاملات

curl -X GET "https://sandbox.sa.leantech.me/v2/customers/{customer_id}/accounts/{account_id}/transactions?from_date=2025-01-01&to_date=2025-03-01" \
  -H "lean-app-token: ${LEAN_APP_TOKEN}" \
  -H "Content-Type: application/json"

التحقق من الهوية

curl -X GET "https://sandbox.sa.leantech.me/v2/customers/{customer_id}/identity" \
  -H "lean-app-token: ${LEAN_APP_TOKEN}" \
  -H "Content-Type: application/json"

الاستجابة:

{
  "full_name": "...",
  "national_id": "1000000000",
  "date_of_birth": "1990-01-01"
}

تنفيذ عملية دفع (Payouts)

curl -X POST "https://sandbox.sa.leantech.me/v2/payouts" \
  -H "lean-app-token: ${LEAN_APP_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "source_account_id": "acc_xxx",
    "destination_iban": "SA0000000000000000000000",
    "amount": 500.00,
    "currency": "SAR",
    "description": "تحويل"
  }'

بوابات مطوري البنوك السعودية

بنك الراجحي (Al Rajhi Bank)

بوابة المطورين: https://developer.alrajhibank.com.sa/open-banking/

curl -X GET "https://api.alrajhibank.com.sa/open-banking/v1/accounts" \
  -H "Authorization: Bearer ${ALRAJHI_TOKEN}" \
  -H "Content-Type: application/json"

الخدمات: معلومات الحسابات، المعاملات، بدء الدفع

بنك الإنماء (Alinma Bank)

صفحة الخدمات المصرفية المفتوحة: https://alinma.com/en/Retail/Digital-Channels/Open-Banking

curl -X GET "https://api.alinma.com/open-banking/v1/accounts" \
  -H "Authorization: Bearer ${ALINMA_TOKEN}" \
  -H "Content-Type: application/json"

البنك العربي الوطني (ANB)

بوابة المطورين: https://developer.anb.com.sa

curl -X GET "https://api.anb.com.sa/open-banking/v1/accounts" \
  -H "Authorization: Bearer ${ANB_TOKEN}" \
  -H "Content-Type: application/json"

عرض النتيجة

بيانات مصرفية
البنك: {{ bankName }}
الحساب: {{ accountType }}
IBAN: {{ iban }}
الرصيد: {{ balance }} {{ currency }}
آخر تحديث: {{ lastUpdated }}

متى تستخدم

استخدم هذه المهارة عندما يسأل المستخدم عن:

• واجهات مصرفية سعودية أو Open Banking
• الوصول لبيانات الحسابات البنكية (AIS)
• بدء عمليات الدفع (PIS)
• Lean Technologies أو مزودي الخدمات المالية
• بوابات مطوري البنوك السعودية (الراجحي، الإنماء، العربي الوطني)
• إطار ساما للخدمات المصرفية المفتوحة
• Saudi banking APIs or financial data access

المراجع

• إطار ساما: https://openbanking.sa
• توثيق Lean: https://docs.leantech.me/v2.0-KSA/
• بيئة Lean التجريبية: https://sandbox.sa.leantech.me
• الراجحي للمطورين: https://developer.alrajhibank.com.sa/open-banking/
• الإنماء: https://alinma.com/en/Retail/Digital-Channels/Open-Banking
• العربي الوطني: https://developer.anb.com.sa