---
title: Onboarding بطاقة الائتمان
description: مرجع REST API للتحقق من صحة بطاقة ائتمان والتحقق من حالة التحقق في ميزة Onboarding بطاقة الائتمان الخاصة بالتحقق من البطاقة غير الحاضرة.
canonical: https://developer.unico.io/ar/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference/credit-card-onboarding
locale: ar
generated_by: markdown-export
---

- [/ar/](/ar/)
- الحلول الإقليمية
- [التحقق من البطاقة غير الحاضرة](/ar/dual-api/developers/regional-solutions/card-not-present-verification)
- [التكامل](/ar/dual-api/developers/regional-solutions/card-not-present-verification/integration/overview)
- [واجهات API](/ar/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis)
- [مرجع API](/ar/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference)
- Onboarding بطاقة الائتمان

**في هذه الصفحة# Onboarding بطاقة الائتمان

### قبل أن تبدأ​

تتم مصادقة طلبات API الخاصة بك باستخدام رمز وصول. أي طلب لا يتضمن رمز وصول صالحًا سيُعيد خطأ. تعرف على المزيد في [المصادقة](/ar/developers/regional-solutions/card-not-present-verification/integration/authentication).
Base URL
**UAT**: `https://transactions.transactional.uat.unico.app/api/public/v1`
**الإنتاج (Production)**: `https://transactions.transactional.unico.app/api/public/v1`

هاميمكن إجراء Onboarding بطاقة الائتمان إم ا بطلب صورة سيلفي من المستخدم النهائي وإكمال التسجيل الكامل، **أو** بإعادة استخدام الالتقاطات البيومترية من العمليات التي نفّذتها منتجات أخرى ضمن منصة Unico IDCloud:
لإعادة استخدام العمليات التي أنشأتها منتجات IDCloud الأخرى، قدّم معرّف العملية المرجعية في `additionalInfo.processID`؛
يجب ألا يكون قد مضى على اكتمال العملية المرجعية المُستخدمة أكثر من **ساعة واحدة**.

### التحقق من صحة بطاقة الائتمان​

`POST /walletid/transaction` — يتحقق من صحة بطاقة ائتمان.
Headers
Headerالقيمة`Authorization``Bearer {token}` — رمز وصول صالح.
Body
```
{  "identity": { "key": "cpf", "value": "12345678900" },  "orderNumber": "onboarding-98765",  "company": "company-id",  "redirectUrl": "https://yourapp.com/wallet/return",  "card": {    "binDigits": "12345678",    "lastDigits": "1234",    "expirationDate": "12/2028",    "name": "John Doe"  },  "value": 5000.00,  "additionalInfo": {    "externalUserID": "YOUR_EXTERNAL_USER_ID"  }}
```

الحقلالنوعإلزاميالوصف`identity`objectنعممعلومات هوية المستخدم.`identity.key`stringنعمنوع مفتاح تعريف المستخدم.`identity.value`stringنعمقيمة مفتاح تعريف المستخدم.`orderNumber`stringنعمالرقم المرتبط بعملية التأهيل. يُستخدم كفهرس في البوابة وكمفتاح خارجي بين نظامك والتحقق من البطاقة غير الحاضرة.`company`stringنعممعرّف الشركة المسؤولة عن المعاملة، مُقدَّم من Unico.`redirectUrl`stringلاعنوان URL لإعادة توجيه المستخدم بعد إكمال المعاملة (عنوان URL بصيغة HTTPS للويب، أو عنوان URL بصيغة Schema لتطبيقات الجوال الأصلية).`card`objectنعممعلومات البطاقة المُستخدمة في المعاملة.`card.binDigits`stringنعمأول 8 أرقام من البطاقة.`card.lastDigits`stringنعمآخر 4 أرقام من البطاقة.`card.expirationDate`stringلاتاريخ انتهاء صلاحية البطاقة.`card.name`stringنعماسم حامل البطاقة — تأكد من صحته لتجنب مشكلات الترميز أو مشكلات الموافقة.`value`numberلاالحد الأقصى للقيمة المضمونة.`additionalInfo`objectلاأرسل هذا الكائن مع `processID` لإعادة استخدام الالتقاطات البيومترية من منتجات أخرى ضمن منصة Unico IDCloud، و/أو `externalUserID` لتفعيل [التحقق الصامت](/ar/developers/regional-solutions/card-not-present-verification/integration/silent-verification) لهذه المعاملة.`additionalInfo.processID`stringلامعرّف العملية المرجعية من منصة IDCloud.`additionalInfo.externalUserID`stringلانفس المعرّف الذي تم تكوينه عبر `externalUserId` في SDK عند جمع بيانات تعريف الجهاز. مطلوب فقط لتفعيل التحقق الصامت — بدونه، يتم إنشاء المعاملة بشكل طبيعي لكنها تتبع دائمًا التدفق البصري القياسي.
خطريجب تعبئة حقل `orderNumber` برقم الطلب **الفريد** لتلك العملية الشرائية في نظام التجارة الإلكترونية — استخدام معرّف معاملة مختلف أمر غير صحيح، وقد تؤدي إعادة استخدام القيم إلى أخطاء `replicated transaction`.
200 OK
```
{  "id": "6ab1771e-dfab-4e47-8316-2452268e5481",  "status": "processing",  "link": "https://developers/regional-solutions/card-not-present-verification.unico.app/t/6ab1771e-dfab-4e47-8316-2452268e5481",  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."}
```

الحقلالوصف`id`معرّف المعاملة التي تم إنشاؤها.`status`حالة المعاملة الحالية.`link`الرابط المرتبط بالمعاملة. يُعاد فقط إذا **لم يتم** تقديم `additionalInfo.processID`.`token`رمز موقّع لتهيئة SDK الويب الخاص بالتحقق من البطاقة غير الحاضرة. يُعاد فقط إذا **لم يتم** تقديم `additionalInfo.processID`.
ملاحظةإذا تم إرسال `additionalInfo.externalUserID` وتمت الموافقة على المعاملة بشكل صامت، فإن الاستجابة تتخطى أيضًا رابط الالتقاط:```
{    "id": "6ab1771e-dfab-4e47-8316-2452268e5481",    "status": "approved"}
```

راجع [التحقق الصامت](/ar/developers/regional-solutions/card-not-present-verification/integration/silent-verification) للاطلاع على التدفق الكامل، بما في ذلك إعداد SDK ومتطلبات التوقيت.
### التحقق من حالة التحقق​

`GET /walletid/transactions/{transaction_id}` — يتحقق من الحالة الحالية لمعاملة محددة.
Headers
Headerالقيمة`Authorization``Bearer {token}` — رمز وصول صالح.
200 OK
```
{  "status": "processing",  "hasIdentityChanged": false}
```

الحقلالوصف`status`الحالة الحالية للمعاملة.`hasIdentityChanged`اختياري. ما إذا كان قد حدث تبديل هوية في المعاملة.
راجع [القيم التعدادية](/ar/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/enumerated) للاطلاع على جميع الحالات الممكنة. لتحسين الأداء، نفّذ Webhook بدلاً من الاستقصاء المتكرر (polling) لهذه النقطة النهائية.
للاطلاع على استجابات الأخطاء، راجع [الأخطاء — Onboarding بطاقة الائتمان](/ar/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/errors#credit-card-onboarding).آخر تحديث في 8 أكتوبر 2026**