💳Создать API счета
The Create Invoice API allows you to generate an invoice for a specific merchant. This API handles parameters like the merchant's information, reference ID, currency, and amount to create an invoice for a given transaction.
Убедитесь, что вы передали действительныйmerchant_id, reference_id, иколичествопри оформлении запроса. Если продавец или ссылка не найдены или сумма недействительна, будет возвращена ошибка.
📝 Входные параметры
| Параметр | Тип | Необходимый | Описание |
|---|---|---|---|
| merchant_id | string | ✔️ | Уникальный идентификатор продавца. Это необходимо для создания счета-фактуры. |
| reference_id | string | ✔️ | The `reference_id` is a unique string used to track the user's order in the issuer's database. It can be the order ID from the issuer's database table. |
| currency_id | string | ✔️ | UUID of the enabled currency configured in the gateway. |
| количество | string | ✔️ | The transaction amount. Must be a valid string representation of the amount (e.g., "10.50"). |
| описание | string | ❌ | Необязательное описание счета (например, цель транзакции). |
- 🔹 API требуетAPI-ключдля аутентификации.
- 🔹 merchant_idдолжен быть передан в теле запроса.
- 🔹 количестводолжно быть допустимым строковым представлением числа и быть больше 1.
💡 Пример запроса
POST https://core.dinakel.com/api/gateway/v1/invoices
Headers:
Authorization: Bearer <your_api_key>
Body:
{
"merchant_id": "<merchant_id>",
"reference_id": "<reference_id>",
"currency_id": "<currency_id>",
"amount": "<amount>",
"description": "<description>"
}
🔍 Пример ответа
{
"status": true,
"statusCode": 201,
"invoice_id": "<invoice_id>",
"data": {
"invoice_id": "<invoice_id>"
}
}
⚠️ Обработка ошибок
API предоставляет следующие ответы об ошибках:
{
"status": false,
"statusCode": 400,
"message": "Amount must be a valid decimal number."
}
400 Bad Request:Параметр суммы недействителен. Убедитесь, что сумма представляет собой допустимое десятичное число и больше 1.
{
"status": false,
"statusCode": 404,
"message": "Merchant or reference not found"
}
404 Not Found:Указанный идентификатор продавца или ссылочный идентификатор не существует в системе. Дважды проверьте идентификатор продавца и ссылку.
{
"status": false,
"statusCode": 500,
"message": "Internal server error"
}
500 Internal Server Error:На сервере произошла непредвиденная ошибка. Повторите попытку позже или обратитесь в службу поддержки.