Skip to main content

Warranty Service

The Warranty Service is a standalone OpenHive application that lets your customers subscribe to a used-vehicle warranty through a guided, multi-step form. Your SaaS initiates the session by providing the vehicle context; the customer selects their warranty; OpenHive registers the subscription with the integrated warranty provider and returns the contract details.

info

To activate the Warranty Service for your software, please contact us at https://openhive.eu/contact.

How It Works​

Integration Steps​

  1. Contact OpenHive to activate the service and get your credentials.
  2. When a customer is ready to subscribe, create a session — pass the vehicle info and customer details. You'll receive a one-time URL.
  3. Display the URL to the customer.
Open the link with window.open()

The warranty app closes its own tab at the end of the tunnel. Browsers only allow a page to call window.close() if the tab was opened programmatically. You must open the URL via window.open() — not a plain <a target="_blank"> link — otherwise the close button will have no effect.

window.open(url, '_blank');
  1. The customer selects and confirms their warranty autonomously.
  2. OpenHive registers the subscription with the warranty provider and notifies your SaaS via webhook.
  3. Upon receiving the webhook, retrieve the subscription document using the warrantySubscriptionId.

The webhook payload, delivery guarantees and timeout are documented as a callback on the Create a warranty session endpoint.