# ألغِ فاتورة

## نظرة عامة

تستطيع إلغاء فاتورة كي لا يعود المشتري قادرًا على دفعها. يفيد ذلك عندما تحتوي الفاتورة على خطأ. يتطلب الإلغاء شرطين:

* حالة الفاتورة: غير مدفوعة (Unpaid)
* مشاهدات صفحة الدفع: 0

إذا كانت الفاتورة تابعة لمشروع آخر والمفتاح مقيَّدًا بمشروع، تستجيب الطريقة بالرد `Restricted project`. وإذا لم تكن لديك فاتورة بهذا المعرّف — `Invoice not found`. وإذا وُجدت الفاتورة لكن شروط الإلغاء غير مستوفاة — `Invoice cannot be canceled`.

## الطلب

```bash
curl -X POST https://api.bitsby.app/invoices/cancel \
  -H "Authorization: Token MSvL2ltaDZdWVjmZURURMVWhqSJLT2NURjhL2Fla1Z1T1IxQTltKs1T3Ay" \
	-F "invoiceId=ade9550d-3dc7-4fd3-b94e-3b4c12aaaa0c"
```

## معطيات الطلب

| المعطى      | نوع البيانات | الوصف                  | مثال                                 | إلزامي؟   |
| ----------- | --------- | ------------------------- | ------------------------------------ | --------- |
| `invoiceId` | UUID      | معرّف الفاتورة بصيغة UUID | ade9550d-3dc7-4fd3-b94e-3b4c12aaaa0c | نعم       |

## مثال على الاستجابة

```json
{
   "result":"success",
   "data":"Invoice canceled"
}
```