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

- [/ar/](/ar/)
- الحلول الإقليمية
- [التحقق من البطاقة غير الحاضرة](/ar/developers/regional-solutions/card-not-present-verification)
- [التكامل](/ar/developers/regional-solutions/card-not-present-verification/integration/overview)
- [واجهات API](/ar/developers/regional-solutions/card-not-present-verification/integration/apis)
- [مرجع API](/ar/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/transactions/{transaction_id}/chargeback` — يُبلغ Unico بأنه تم تلقي مرتجع لمعاملة محددة.
الإبلاغ ليس اعتراضًاتقتصر نقطة النهاية هذه على الإبلاغ عن المرتجع. ولا تفتح تحليل مرتجع ولا تُفعّل [ضمان المسؤولية](/ar/developers/regional-solutions/card-not-present-verification/about-idpay/chargeback). لكي تحلّل Unico المرتجع، افتح اعتراضًا على المعاملة في البوابة.
Headers
Headerالقيمة`Authorization``Bearer {token}` — رمز وصول صالح.
Body
```
{  "datetime": "2023-01-05T03:00:00.000Z",  "requestor": { "key": "cpf", "value": "USER_CPF" },  "name": "USER_NAME",  "reason": "REQUEST_REASON",  "observation": "GENERAL_OBSERVATIONS"}
```

الحقلالنوعإلزاميالوصف`datetime`stringنعمتاريخ ووقت تلقي المرتجع، بصيغة ISO 8601.`requestor`objectنعممعلومات مقدّم الطلب.`requestor.key`stringنعمنوع مفتاح تعريف مقدّم الطلب (مثل `cpf`).`requestor.value`stringنعمقيمة مفتاح تعريف مقدّم الطلب.`name`stringنعماسم مقدّم الطلب.`reason`stringنعمسبب المرتجع.`observation`stringلاملاحظات عامة حول المرتجع.
201 Created
```
{  "id": "8263a268-5388-492a-bca2-28e1ff4a69f0"}
```

الحقلالوصف`id`معرّف المرتجع.
تحتوي المعاملة على مرتجع واحد فقط. يؤدي الإبلاغ عن معاملة لديها مرتجع بالفعل إلى إرجاع `200 OK` مع `id` المرتجع الموجود، دون تغييره.
للاطلاع على استجابات الأخطاء، راجع [الأخطاء — إنشاء المعاملة](/ar/developers/regional-solutions/card-not-present-verification/integration/apis/errors#transaction-creation).
### الحصول على حالة المرتجع​

`GET /credit/transactions/{transaction_id}/chargeback/{chargeback_id}` — يتحقق من حالة مرتجع محدد.
Headers
Headerالقيمة`Authorization``Bearer {token}` — رمز وصول صالح.
200 OK
```
{  "id": "8263a268-5388-492a-bca2-28e1ff4a69f0",  "status": "waiting"}
```

الحقلالوصف`id`معرّف المرتجع.`status`الحالة الحالية للمرتجع.
يبقى المرتجع المُبلَّغ عنه في الحالة `waiting`. إذا تم الاعتراض على المعاملة في البوابة، فإن `id` نفسه يعرض تقدّم التحليل ونتيجته. راجع [القيم التعدادية — نتيجة المرتجع](/ar/developers/regional-solutions/card-not-present-verification/integration/apis/enumerated#chargeback-result) للاطلاع على جميع الحالات الممكنة. لتحسين الأداء، نفّذ [Webhook](/ar/developers/regional-solutions/card-not-present-verification/integration/webhook) بدلاً من الاستقصاء المتكرر (polling) لهذه النقطة النهائية.آخر تحديث في 23 أكتوبر 2026**