---
title: معاملات الدفع
description: مرجع REST API لإنشاء معاملات الدفع، والتحقق من الحالة، واسترداد الإثباتات، وإعادة إرسال الإشعارات في التحقق من البطاقة غير الحاضرة.
canonical: https://developer.unico.io/ar/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference/payment-transactions
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)
- معاملات الدفع

**في هذه الصفحة# معاملات الدفع

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

تتم مصادقة طلبات 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`

### إنشاء معاملة​

`POST /credit/transaction` — ينشئ معاملة جديدة.
خطرلضمان تحويل أفضل، قم بإنشاء المعاملة **فقط بعد** إكمال أي مصادقة مسبقة أو تحقق قد ينهي العملية قبل تجربة التحقق من البطاقة غير الحاضرة.
خطريجب تعبئة حقل `orderNumber` برقم الطلب **الفريد** لتلك العملية الشرائية في نظام التجارة الإلكترونية — استخدام معرّف معاملة مختلف أمر غير صحيح. قد يؤدي إعادة استخدامه إلى انخفاض معدل التحويل (رقم الطلب يساعد المستخدم النهائي على إكمال المسار) وإلى أخطاء API مثل `replicated transaction` إذا تم استخدام نفس رقم الطلب و CPF و BIN وآخر 4 أرقام.
Headers
Headerالقيمة`Authorization``Bearer {token}` — رمز وصول صالح.
Body
```
{  "identity": { "key": "cpf", "value": "12345678900" },  "orderNumber": "order-98765",  "company": "company-id",  "redirectUrl": "https://yourapp.com/checkout/return",  "card": {    "binDigits": "12345678",    "lastDigits": "1234",    "expirationDate": "12/2028",    "name": "John Doe"  },  "value": 199.90,  "mainContacts": [    { "key": "phone", "value": "5543999999999" }  ],  "additionalInfo": {    "externalUserID": "YOUR_EXTERNAL_USER_ID"  }}
```

الحقلالنوعإلزاميالوصف`identity`objectنعمبيانات تعريف المستخدم.`identity.key`stringنعمنوع مفتاح تعريف المستخدم. يُوصى باستخدام `cpf` — معدل تحويل أعلى.`identity.value`stringنعمقيمة مفتاح تعريف المستخدم، بدون نقاط أو شرطات.`orderNumber`stringنعمرقم الطلب المرتبط بالمعاملة. يُستخدم كفهرس في البوابة وكمفتاح خارجي بين نظامك والتحقق من البطاقة غير الحاضرة.`company`stringنعممعرّف الشركة المسؤولة عن المعاملة، مُقدَّم من Unico.`redirectUrl`stringلاعنوان URL لإعادة توجيه المستخدم بعد إكمال المعاملة (عنوان URL بصيغة HTTPS للويب، أو مخطط URL لتطبيقات الجوال الأصلية).`card`objectنعممعلومات حول البطاقة المُستخدمة في المعاملة.`card.binDigits`stringنعمأول 8 أرقام من البطاقة.`card.lastDigits`stringنعمآخر 4 أرقام من البطاقة.`card.expirationDate`stringلاتاريخ انتهاء صلاحية البطاقة.`card.name`stringنعماسم حامل البطاقة. أرسله بشكل صحيح، متجنبًا مشكلات الترميز — تُستخدم هذه البيانات في تجربة المس تخدم والتواصل.`value`numberنعمالقيمة الإجمالية للشراء.`mainContacts`arrayلاقائمة جهات الاتصال الرئيسية (بريد إلكتروني و/أو هاتف) المُستخدمة لإشعار المستخدم، عندما يكون التحقق من البطاقة غير الحاضرة مسؤولاً عن الإشعار.`fallbackContacts`arrayلاقائمة جهات الاتصال الاحتياطية، التي يتم تفعيلها في حال فشلت محاولات إشعار جهات الاتصال الرئيسية.`additionalInfo`objectلاأرسل هذا الكائن مع `externalUserID` لتفعيل [التحقق الصامت](/ar/developers/regional-solutions/card-not-present-verification/integration/silent-verification) لهذه المعاملة.`additionalInfo.externalUserID`stringنعم (إذا تم إرسال `additionalInfo`)نفس المعرّف الذي تم تكوينه عبر `externalUserId` في SDK عند جمع بيانات تعريف الجهاز. مطلوب لتفعيل التحقق الصامت — بدونه، يتم إنشاء المعاملة بشكل طبيعي لكنها تتبع دائمًا التدفق البصري القياسي.
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...",  "expiresAt": "2026-07-22T15:30:00Z"}
```

الحقلالوصف`id`معرّف المعاملة التي تم إنشاؤها.`status`حالة المعاملة الحالية.`link`الرابط المرتبط بالمعاملة.`token`رمز موقّع يحتوي على المعلمات اللازمة لتهيئة SDK الويب الخاص بالتحقق من البطاقة غير الحاضرة.`expiresAt`تاريخ ووقت انتهاء صلاحية المعاملة، بصيغة ISO 8601 (UTC).
تحذيرإذا حدد التحقق أن الالتقاط البيومتري غير مطلوب، تكون الاستجابة بحالة مختلفة ولا يتم إنشاء رابط التقاط:```
{    "id": "6ab1771e-dfab-4e47-8316-2452268e5481",    "status": "fast-inconclusive"}
```

يحدث هذا عند استخدام وحدتي Pre أو Super Pre لصفحة الدفع (Checkout)، وفقًا لـ [الميزة](/ar/developers/regional-solutions/card-not-present-verification/about-idpay/feature).
ملاحظةإذا تم إرسال `additionalInfo.externalUserID` وتمت الموافقة على المعاملة بشكل صامت، فإن الاستجابة تتخطى أيضًا رابط الالتقاط:```
{    "id": "6ab1771e-dfab-4e47-8316-2452268e5481",    "status": "approved"}
```

راجع [التحقق الصامت](/ar/developers/regional-solutions/card-not-present-verification/integration/silent-verification) للاطلاع على التدفق الكامل، بما في ذلك إعداد SDK ومتطلبات التوقيت.
للاطلاع على استجابات الأخطاء، راجع [الأخطاء — إنشاء المعاملة](/ar/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/errors#transaction-creation).
### الحصول على حالة المعاملة​

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

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

`GET /credit/transactions/{transaction_id}/probative` — يسترجع مجموعة الإثباتات لمعاملة محددة.
تحذيرلا يمكن إنشاء مجموعة الإثباتات إلا للمعاملات التي **تمت الموافقة عليها**.
خطرالرابط المُعاد لمجموعة الإثباتات صالح لمدة **خمس دقا ئق** بعد الحصول عليه — لا تقم بحفظه، استخدمه لتنزيل مجموعة الإثباتات فورًا.
Headers
Headerالقيمة`Authorization``Bearer {token}` — رمز وصول صالح.
200 OK
```
{  "link": "https://unico.io/probative.pdf"}
```

الحقلالوصف`link`عنوان URL لملف الإثبات.
للاطلاع على استجابات الأخطاء، راجع [الأخطاء — استرداد مجموعة الإثباتات الخاصة بالمعاملة](/ar/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/errors#recovery-of-the-evidentiary-set-of-the-transaction).
### إعادة إرسال إشعار المعاملة​

`POST /credit/transactions/{transaction_id}/notify` — يعيد إرسال الإشعارات عبر البريد الإلكتروني و/أو الهاتف لمعاملة محددة.
ملاحظةمن الممكن أيضًا تهيئة إعادة إرسال الإشعارات عبر البوابة، دون تنفيذها عبر API. تحدث مع نقطة الاتصال الخاصة بمشروعك لفهم الإمكانيات المتاحة.
Headers
Headerالقيمة`Authorization``Bearer {token}` — رمز وصول صالح.
Body
```
{  "phone": "NOTIFICATION_PHONE",  "email": "NOTIFICATION_EMAIL"}
```

الحقلالنوعإلزاميالوصف`phone`stringنعمرقم الهاتف لإرسال الإشعار إليه.`email`stringنعمعنوان البريد الإلكتروني لإرسال الإشعار إليه.
200 OK
```
{  "id": "b50ee24c-71eb-4a5d-ade1-41c48b44c240",  "link": "https://aces.so/example"}
```

الحقلالوصف`id`المعرّف الفريد للإشعار الذي تم إنشاؤه.`link`الرابط الذي تم إنشاؤه للإشعار.
للاطلاع على استجابات الأخطاء، راجع [الأخطاء — إعادة إرسال إشعار المعاملة](/ar/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/errors#resending-the-transaction-notification).آخر تحديث في 8 أكتوبر 2026**