Get Order

Endpoint

POST /v1/get-order

Fetches the current state of an order by ID. Use this to poll until an order is completed and to retrieve the issued vignette file(s).

Body Parameters

Name	Type	Required	Description
id	string	yes	Order ID

Response

Base response fields (always present):

Name	Type	Description
id	string	Order ID
status	string	Order status
description	string	Order description
price	number	Order price in MDL
currency	string	Currency code (default "MDL")

Order statuses: draft, paid, processing, failed, completed, refunded or expired.

Merchant should accept payments only for orders with draft status.

Once an order is completed, the response additionally includes start_date, end_date (where applicable), and a products[] array. Each product object contains the issued vignette under file (a downloadable PDF URL) plus product-specific issuance details (plate number, car model, validity, reference price/exchange rate, transaction/document numbers, etc.).

Request Body Examples

JSON

{
  "id": "EUV001002ABC"
}

Response Body Examples

draft (minimal)

JSON

{
  "id": "MDV517529SEW",
  "status": "draft",
  "description": "Vinieta MD",
  "price": 77.08,
  "currency": "MDL"
}

draft with dates

JSON

{
  "id": "EUV001002ABC",
  "status": "draft",
  "description": "Vinietă Europa, BG, 7 zile, BMW X7 ISG313",
  "start_date": "2026-06-10",
  "end_date": "2026-06-16",
  "price": 179.15,
  "currency": "MDL"
}

paid

JSON

{
  "id": "EUV001002ABC",
  "status": "paid",
  "description": "Vinietă Europa, BG, 7 zile, BMW X7 ISG313",
  "start_date": "2026-06-10",
  "end_date": "2026-06-16",
  "price": 179.15,
  "currency": "MDL"
}

completed — Vignette (RO)

JSON

{
  "id": "ROV0000123ABC",
  "status": "completed",
  "description": "Rovinieta, 10 zile, Categoria A, BMX X7 ISG123",
  "start_date": "2024-01-14",
  "price": 69.98,
  "products": [
    {
      "product": "vignette:ro",
      "vignette_series": "1234567890",
      "plate_number": "ISG123",
      "vehicle_category": "A-Autoturisme",
      "vin_code": "TMBAB6NP00000000000",
      "country": "Moldova(MD)",
      "transaction_id": "CNADNR0000000000",
      "start_date": "2024-01-14 00:00:00",
      "end_date": "2024-01-23 23:59:59",
      "validity": "10 zile",
      "reference_price": "26.37 RON",
      "reference_exchange_rate": "1 RON = 4.1236 MDL",
      "supplier_exchange_rate": "1EUR = 4.9769RON (2024-01-31)",
      "price": 69.98,
      "currency": "MDL",
      "file": "https://firebasestorage.googleapis.com...."
    }
  ]
}

completed — Vignette (EU)

JSON

{
  "id": "EUV000123ABC",
  "status": "completed",
  "description": "Vinietă Europa, BG, 7 zile, BMW X7 ISG313",
  "start_date": "2026-06-10",
  "end_date": "2026-06-16",
  "price": 179.15,
  "currency": "MDL",
  "products": [
    {
      "product": "vignette:eu",
      "country": "bg",
      "validity": "bg-7d",
      "plate_number": "ISG313",
      "car_model": "BMW X7",
      "vin": "WVWZZZ1JZXW000001",
      "registration_country": "md",
      "document_number": "ORD-0000000000",
      "transaction_id": "ORD-0000000000",
      "start_date": "2026-06-10",
      "end_date": "2026-06-16",
      "reference_price": "8.82 EUR",
      "reference_exchange_rate": "1 EUR = 19.27 MDL",
      "price": 179.15,
      "currency": "MDL",
      "file": "https://firebasestorage.googleapis.com...."
    }
  ]
}

EU vignette completion is asynchronous. After payment the order is processing while we purchase the vignette from the provider and re-host the vignette PDF; it flips to completed (with the file URL) once the PDF is ready — typically within a minute. Poll get-order or rely on the completion webhook.

Status Codes

Code	Description
200	Order found
404	Order not found
401	Unauthorized
403	Forbidden
500	Internal server error