vinieta.md Developer Docs

Sell road vignettes from your own product. There are two ways to integrate, and you can use both on the same site.

Pick your integration

	Embed Widget	REST API
What it is	A <script> tag and a <div>. The widget renders itself.	Six signed JSON endpoints you call from your backend.
You build	Nothing — the form, pricing, checkout and PDF are ours.	Your own UI and checkout, end to end.
Payment	Handled by vinieta.md	You collect payment, then confirm the order.
Backend needed	No	Yes — the request signature must never reach the browser.
Time to ship	Minutes	A day or two
Best for	Marketing sites, landing pages, CMS pages	Marketplaces, agent portals, POS and mobile apps

Not sure? Start with the widget. If you later need to own the checkout flow, the REST API is there and both sell the same products.

Products

Product	Name	Notes
vignette:md	Moldova road vignette	Quoted from validity period + vehicle category
vignette:ro	Romania vignette (rovinietă)	Quoted from a vehicle certificate
vignette:eu	EU multi-country vignette	Pick a destination country; issuance is asynchronous

API at a glance

• Base URL: https://api.vinieta.md
• Endpoints: 6, all POST, all under /v1
• Content type: application/json
• Currency: every price / amount is in Moldovan Lei (MDL) unless a field says otherwise.
• Auth: an X-Hmac-Signature header on every request — see Authentication.

There are no GET endpoints — even reads (get-order, get-offers) are POST with a JSON body, because the body is what gets signed.

The order lifecycle is the same either way:

quote  →  draft  →  paid  →  (processing)  →  completed

Get access

Your Partner ID, secret key and sandbox base URL are issued individually. Contact vinieta.md to become a partner.

Building with an AI agent?

Point your assistant at llms.txt (a concise index) or llms-full.txt (the complete spec in a single file) — both are written for LLMs to scaffold an integration end-to-end.