> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://allianz.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://allianz.ferndocs.com/_mcp/server.

# SmartCircuit

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](/in-path-offers/client-side/documentation/events#azpquoterequest)

Send trip or event details and display the HTML offer.

#### [Purchase](/in-path-offers/client-side/documentation/events#azppurchaserequest)

Send payment details when the customer buys insurance.

#### [Note decline](/in-path-offers/client-side/documentation/events#azpnotedeclinerequest)

Tell AzP the booking finished without insurance.

## How it works

#### 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](/_fern-files/allianz-partner-services.docs.buildwithfern.com/070ec42064bafaa0308b8465ca743e92237fdf2b199e2dd1b81a79eb794fa398/assets/in-path-offers/smartcircuit-auth-flow.png)

#### Load SmartCircuit

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

#### 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](/_fern-files/allianz-partner-services.docs.buildwithfern.com/00f8e237c0183ede03f870b19812cb0f152baf4b7862dbe556f378771772faa0/assets/in-path-offers/smartcircuit-quote-flow.png)

#### 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](/_fern-files/allianz-partner-services.docs.buildwithfern.com/eea16a30247a6bab9e8f7998babb139703a2fc34e5b00338065552ff89a8066f/assets/in-path-offers/smartcircuit-purchase-flow.png)

## 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](/in-path-offers/client-side/documentation/integration)

Bundle, HTML element, access token and events.

#### [Code examples](/in-path-offers/client-side/code-examples)

Full event example and the hosted demo.

#### [Full integration guide (PDF)](https://sandbox.allianzpartnerservices.com/aps-documents/1smartcircuit/SmartCircuit_Travel_Service_Integration_Guide.pdf)

SmartCircuit Travel Service Integration Guide.