Skip to navigation

SmartCircuit

Show Allianz insurance offers in your booking path with a client-side web component

SmartCircuit™ is a web component hosted by Allianz Partners (AzP). Your web application sends it booking events from client-side JavaScript, and SmartCircuit renders the insurance offer and completes the purchase. A typical integration covers three exchanges:

Quote

Send trip or event details and display the HTML offer.

Purchase

Send payment details when the customer buys insurance.

Note decline

Tell AzP the booking finished without insurance.

How it works

1

Authenticate server-side

Your server exchanges partner credentials for an access token (valid for 1 hour) and a refresh token (valid for 24 hours).

Partner requests a token from the Allianz Partners auth service, which returns it
SmartCircuit authentication
2

Load SmartCircuit

The page includes the SmartCircuit bundle and an allianz-insurance element carrying the access token.

3

Exchange events

After azpComponentReady, the page sends azpQuoteRequest. SmartCircuit shows the offer and reports the customer’s choice with azpInsuranceSelected or azpInsuranceDeclined.

Event flow between customer, partner web application and SmartCircuit
SmartCircuit event interaction
4

Complete the booking

At checkout, the page sends azpPurchaseRequest if insurance was selected, or azpNoteDeclineRequest if it was declined.

Purchase and note decline event flow
SmartCircuit purchase and note decline

Assumptions and dependencies

  • The partner provides credit card information, and AzP is merchant of record for insurance purchases.
  • The partner displays AzP’s full HTML offer in the agreed page placement.
  • SmartCircuit is hosted by AzP. UAT and production use separate bundles, distinguished by file name, and changes ship as new versioned bundles.
  • The partner uses the provided events to update the cart with the insurance cost and to send a purchase or note decline request.
  • If SmartCircuit can’t return an optimized offer in time, it renders a default offer.
  • AzP must be told about planned changes to fields or standard values before they go live.
  • AzP and the partner test the integration together, usually on the partner’s test site.

Browser support

Chrome, Safari, Firefox, Edge and Internet Explorer are supported. Angular integrations are tested on Internet Explorer; pure JavaScript or non-Angular integrations may need extra libraries for it.

Documentation

Bundle, HTML element, access token and events.

Code examples

Full event example and the hosted demo.

Full integration guide (PDF)

SmartCircuit Travel Service Integration Guide.