🔍API статуса счета
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:На сервере произошла непредвиденная ошибка. Повторите попытку позже или обратитесь в службу поддержки.