Introduction

Welcome to the Vignetim Partner API. This API enables you to integrate vignette purchases, eSIM data packages, and travel insurance products directly into your platform.

Base URL

All API requests are made to:

https://api.vignetim.com/v2/partners

The API follows RESTful conventions and returns JSON responses. All requests must be authenticated using HMAC-SHA256 request signing.

What You Can Do

• Sell Vignettes -- Browse available highway vignette tickets across European countries and create orders on behalf of your customers.
• Sell eSIM Packages -- Offer mobile data packages for travelers, covering local, regional, and global destinations.
• Sell Travel Insurance -- Provide travel insurance products with various coverage options.
• Manage Orders -- Track order status, filter order history, and receive real-time webhook notifications.

Versioning

The Partner API is versioned via the URL path (/v2/). Breaking changes will only be introduced in new major versions. Non-breaking additions (new fields, new endpoints) may be added to the current version without notice.

Developer Resources

Tip: Import the OpenAPI spec into Postman, Insomnia, or any API client to get pre-built request templates with all endpoints and schemas ready to go.

Quick Start

1. Get your API credentials -- Sign up for a partner account and retrieve your API key and secret from the dashboard.
2. Use the sandbox -- Start in sandbox mode to test your integration with simulated payments and no real charges.
3. Authenticate requests -- Sign every request using HMAC-SHA256 with the required headers.
4. Browse products -- Fetch available vignettes, eSIM packages, or insurance products.
5. Create an order -- Submit an order with product selection, payment details, and customer information.
6. Set up webhooks -- Register webhook endpoints to receive real-time notifications about order status changes.