ألغِ فاتورة

نظرة عامة

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

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

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

الطلب

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	نعم

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

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