Vignetim

Детайли на поръчка

Извлечете пълните детайли на конкретна поръчка или проверете текущия й статус.

Получаване на детайли на поръчка

GET /orders/:id

Параметри на пътя

NameTypeRequiredОписание
idstringYesID на поръчката (напр. ord-a1b2c3d4-e5f6-7890-abcd-ef1234567890)

Отговор

{
	"id": "ord-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
	"status": "COMPLETED",
	"products": [
		{
			"productId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
			"productTypeId": 1,
			"productName": "Austria 10-Day Vignette",
			"quantity": 1,
			"status": "COMPLETED",
			"vehiclePlate": "AB123CD",
			"vehicleCountryIsocode": "AT",
			"startAt": "2026-04-01T00:00:00.000Z",
			"endAt": "2026-04-10T23:59:59.000Z"
		}
	],
	"payment": {
		"type": "CARD",
		"status": "CAPTURED",
		"paidAt": "2026-03-20T14:31:10.000Z"
	},
	"customer": {
		"email": "john.doe@example.com",
		"firstName": "John",
		"lastName": "Doe"
	},
	"total": {
		"amount": 11.5,
		"currency": "EUR"
	},
	"externalReference": "YOUR-ORDER-REF-001",
	"idempotencyKey": "unique-order-key-12345",
	"createdAt": "2026-03-20T14:30:00.000Z",
	"completedAt": "2026-03-20T14:31:15.000Z"
}

Получаване на статус на поръчка

Олекотена крайна точка, която връща само текущия статус на поръчката, полезна за периодично запитване (polling).

GET /orders/:id/status

Параметри на пътя

NameTypeRequiredОписание
idstringYesID на поръчката

Отговор

{
	"id": "ord-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
	"status": "COMPLETED",
	"updatedAt": "2026-03-20T14:31:15.000Z"
}

Статуси на поръчки

СтатусОписание
PENDINGПоръчката е създадена, очаква потвърждение на плащането
PROCESSINGПлащането е потвърдено, продуктите се предоставят
COMPLETEDВсички продукти са доставени успешно
FAILEDПлащането е неуспешно или грешка при предоставяне на продукт
CANCELLEDПоръчката е отменена
REFUNDEDПоръчката е възстановена