Direct iframe integration
Use the hosted quote flow without the SDK, in your own iframe or a mobile webview.
Everything the SDK does is built on one hosted page:
https://embed.coverport.io/embed/quote?pk=<publishable key>&host=<your origin>&product=<slug>You can load that URL in any iframe or webview and talk to it with postMessage. This is the supported path for iOS and Android apps today; native SDKs are planned.
URL parameters
Prop
Type
Embedding
<iframe
src="https://embed.coverport.io/embed/quote?pk=pk_test_…&host=https%3A%2F%2Fshop.example.com"
title="CoverPort insurance quote"
allow="payment"
style="width:100%;max-width:480px;height:min(720px,92vh);border:0;border-radius:12px"
></iframe>allow="payment"is required for wallet payments (Apple Pay, Google Pay, Link) to work inside the frame.- The flow is responsive down to 320px wide. 480 by 720 is the layout the SDK uses.
- The page sends the key's Allowed origins as
Content-Security-Policy: frame-ancestors, so only those sites can frame the flow, andcompleteis posted only whenhostis one of them. Every key, test or live, must have allowed origins; a key without them shows a "no allowed origins" message instead of the flow. See Keys.
Messages from the flow
The flow posts messages to window.parent. Every message is an object with __coverport: true and a type.
type | Payload | When |
|---|---|---|
ready | none | The flow has loaded and rendered its first screen. Use it to hide a spinner. |
complete | sale: CoverportSale | Payment succeeded. sale.purchaseId is the Stripe PaymentIntent id (pi_…) and sale.amountTotalCents the amount charged in cents. Fires once. |
close | none | The buyer asked to leave the flow from inside it: Cancel, Done, or the Escape key while focus is in the frame. Remove the iframe. |
CoverportSale is documented in the Reference.
Listening safely
Always check event.origin and event.source before trusting a message. The SDK does exactly this:
const iframe = document.querySelector('#coverport-frame');
const EMBED_ORIGIN = 'https://embed.coverport.io';
window.addEventListener('message', (event) => {
if (event.origin !== EMBED_ORIGIN) return;
if (event.source !== iframe.contentWindow) return;
const data = event.data;
if (!data || data.__coverport !== true) return;
switch (data.type) {
case 'ready':
spinner.hidden = true;
break;
case 'complete':
recordSale(data.sale);
break;
case 'close':
iframe.remove();
break;
}
});Mobile webviews
Load the same URL in a WKWebView (iOS) or WebView (Android) and bridge messages back to native code. A key still needs at least one allowed origin (your website is fine); the shim below receives the messages whatever their target origin.
The flow calls window.parent.postMessage, and in a top-level webview window.parent === window, so the flow does not post. Inject a shim that forwards to a WKScriptMessageHandler instead:
let shim = """
window.parent = { postMessage: function (msg) {
window.webkit.messageHandlers.coverport.postMessage(msg);
}};
"""
let script = WKUserScript(source: shim, injectionTime: .atDocumentStart, forMainFrameOnly: true)
config.userContentController.addUserScript(script)
config.userContentController.add(self, name: "coverport")
webView.load(URLRequest(url: URL(string:
"https://embed.coverport.io/embed/quote?pk=pk_live_…&host=app://coverport-host")!))func userContentController(_ c: WKUserContentController, didReceive m: WKScriptMessage) {
guard let body = m.body as? [String: Any], body["__coverport"] as? Bool == true else { return }
switch body["type"] as? String {
case "complete": handleSale(body["sale"])
case "close": dismiss()
default: break
}
}Card entry in webviews
Payment is collected by Stripe Checkout inside the flow. Both platforms support this in a standard webview; do not disable JavaScript or third-party cookies for the CoverPort origin.
How the buyer signs in
The buyer enters their email, and CoverPort emails them a 6-digit code. Nothing is looked up, created or connected until they type it in: your publishable key is public, so the code is what stops someone using your page to create accounts for, or send email to, addresses they do not own. New buyers then add their name.
- A code works once and expires after 10 minutes. Five wrong tries use it up.
- One address can be sent a new code once a minute, five times an hour.
- If the buyer does not get the email, the flow offers to send a new code or use a different address.
Why there is no cookie
The flow deliberately does not rely on cookies. Third-party cookies are blocked inside iframes by every major browser, so the sign-in runs server-side on CoverPort and the resulting session lives in the frame's own memory for 30 minutes. Reloading the frame starts a fresh session, and the buyer signs in again with a new code.