🔍واجهة برمجة تطبيقات حالة الفاتورة
تسمح لك واجهة برمجة تطبيقات حالة الفاتورة باسترداد الحالة الحالية لفاتورة معينة. يمكن لواجهة برمجة التطبيقات هذه إرجاع تفاصيل مثل حالة الفاتورة والمبلغ والعملة والبروتوكول والمزيد.
ملحوظة:
تأكد من اجتياز صالحةinvoice_idعند تقديم الطلب. إذا كانت الفاتورة غير موجودة أو لم يتم العثور عليها، فسوف تتلقى رسالة404 Not Foundخطأ.
- 🔹 تتطلب واجهة برمجة التطبيقاتمفتاح واجهة برمجة التطبيقاتللمصادقة.
- 🔹 الinvoice_idيجب أن يتم تمريرها كمعلمة استعلام في الطلب.
💡 طلب مثال
GET https://core.dinakel.com/api/gateway/v1/invoices/<invoice_id>/status
Headers:
Authorization: Bearer <your_api_key>
Path Parameters:
- invoice_id (required, UUID): The unique identifier of the invoice you wish to check.
🔍 الرد المثالى
{
"status": true,
"statusCode": 200,
"data": {
"invoiceStatus": "paid",
"amount": "1000.000000000000",
"symbol": "USDT",
"protocol": "TRC20",
"reference_id": "abc123",
"created_at": "2025-02-16T12:00:00Z"
}
}
⚠️ معالجة الأخطاء
توفر واجهة برمجة التطبيقات استجابات الخطأ التالية:
{
"status": false,
"statusCode": 400,
"message": "Invalid invoice_id parameter"
}
400 Bad Request:المعلمة bill_id غير صالحة. تأكد من استخدام تنسيق المعرف الصحيح.
{
"status": false,
"statusCode": 404,
"message": "Invoice not found"
}
404 Not Found:الفاتورة بالمعرف المقدم غير موجودة في النظام. تحقق مرة أخرى من معرف الفاتورة.
{
"status": false,
"statusCode": 500,
"message": "Internal server error"
}
500 Internal Server Error:حدث خطأ غير متوقع على الخادم. حاول مرة أخرى لاحقًا أو اتصل بالدعم.