Events

The SDK surfaces two callbacks. Under the hood they are driven by postMessage events from the hosted flow; if you use the direct iframe path you will handle those messages yourself.

onComplete(sale)

Fires exactly once, after the buyer's payment succeeds and the policy is issued. The modal stays open on the confirmation screen; the buyer closes it when they are done, and onClose does not fire afterwards.

coverport.mount('#insure-btn', {
  key: 'pk_live_…',
  onComplete: async (sale) => {
    await fetch('/api/insurance/record', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({
        purchaseId: sale.purchaseId,
        amountTotal: sale.amountTotal,
        currency: sale.currency,
        testMode: sale.testMode,
        shipmentId: currentShipment.id, // your own correlation id
      }),
    });
  },
});

onClose()

Fires when the modal is dismissed without a completed sale. Any of these trigger it:

• The close button in the corner of the modal
• A click on the backdrop
• The Escape key
• The hosted flow sending a close message (for example, a "No thanks" action inside the flow)
• handle.destroy() while a modal is open

Use it to resume whatever the buyer was doing, or to log abandonment.

Ordering guarantees