Отменить инвойс
JSON API v3
POST /api/v3/projects/{projectId}/invoices/{invoiceId}/cancel
Отменяет активный инвойс.
Payload подписи v4: {invoice_id}{client_ip}
Параметры запроса
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
projectId | integer (int32) | да | |
invoiceId | string (uuid) | да |
Тело запроса
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
client_ip | string | — | |
additional_parameters | object | — | Дополнительные параметры счёта — произвольные пары «имя — значение» (JSON-эквивалент блока <AdditionalParameters> из XML API). Через них передаются служебные флаги обработки, например NeedSendNotification, и собственные метки продавца. Имена нечувствительны к регистру и должны быть уникальны: Flag и flag в одном объекте — ошибка запроса (400 BAD_REQUEST), а не два параметра. Блок принимают создание счёта (внутри order), а также авторизация, отмена и возврат (на верхнем уровне тела): переданные значения дописываются к уже сохранённым у счёта, совпадающие по имени — перезаписываются. |
Пример запроса
{}Пример ответа
{
"success": true,
"data": {
"invoice_id": "0d0f3c58-9b1e-4a77-9a0c-000000000001",
"status": "Cancelled"
}
}Коды ответов
| Код | Описание |
|---|---|
200 | Инвойс отменён |
400 | Ошибка валидации или бизнес-ошибка запроса |
401 | Ошибка аутентификации (отсутствует/неверна подпись или временная метка) |
403 | Доступ к проекту запрещён или IP не в белом списке |
404 | Инвойс не найден |
422 | Ошибка бизнес-валидации |
500 | Непредвиденная ошибка платформы |
503 | Сервис временно недоступен |