Dinakel

🔍API وضعیت فاکتور

Invoice Status API به شما امکان می دهد وضعیت فعلی یک فاکتور خاص را بازیابی کنید. این API می تواند جزئیاتی مانند وضعیت فاکتور، مبلغ، ارز، پروتکل و موارد دیگر را برگرداند.

توجه:

اطمینان حاصل کنید که یک معتبر را پاس کرده ایدinvoice_idهنگام درخواست در صورتی که فاکتور وجود نداشته باشد یا یافت نشود، یک عدد دریافت خواهید کرد404 Not Foundخطا

🔹 API به یک نیاز داردکلید APIبرای احراز هویت
🔹 را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"
  }
}

⚠️ رسیدگی به خطاها

API پاسخ های خطای زیر را ارائه می دهد:


{
  "status": false,
  "statusCode": 400,
  "message": "Invalid invoice_id parameter"
}

400 Bad Request:پارامتر invoice_id نامعتبر است. اطمینان حاصل کنید که از قالب شناسه صحیح استفاده شده است.


{
  "status": false,
  "statusCode": 404,
  "message": "Invoice not found"
}

404 Not Found:فاکتور با شناسه ارائه شده در سیستم وجود ندارد. شناسه فاکتور را دوباره چک کنید.


{
  "status": false,
  "statusCode": 500,
  "message": "Internal server error"
}

500 Internal Server Error:یک خطای غیرمنتظره در سرور رخ داد. بعداً دوباره امتحان کنید یا با پشتیبانی تماس بگیرید.

🔍API وضعیت فاکتور

💡 درخواست نمونه

🔍 نمونه پاسخ

⚠️ رسیدگی به خطاها

📖 مستندات بیشتر