Skip to main content
The product page widget renders instalment messaging next to the price (e.g. “or pay in 4 instalments of RX”), along with a built-in “How it works” explainer modal, all from a single script tag with no API call or signature required.
If your store runs WooCommerce, Shopify, or Magento with the official Float plugin, this is already included, so you don’t need to add it yourself. This page is for custom API integrations.

​
Add the widget

Place a script tag wherever the messaging should render, typically directly below the price:
The script injects its own markup (logo, instalment breakdown, and a “How it works” link) at its own position in the DOM. There’s no container element or JS SDK to set up.

​
Parameters

​
Keep the price in sync

If the price can change without a page reload (a variant picker, a quantity stepper, a discount code), you need to remove the existing script’s rendered output and insert a brand-new <script> element with the updated price. Changing the src attribute on an existing script tag doesn’t cause it to re-fetch or re-run.

​
Handle missing or zero price

Don’t render the widget with price=0 or blank. The script no-ops in that case (if (price <= 0) return) and silently leaves its default placeholder on screen rather than showing an error. Suppress the widget entirely for unpriced or out-of-stock items, rather than letting it render with a fallback of 0.

​
What’s included

The “How it works” link opens a modal that’s already wired up; you don’t need to link to the explainer page yourself or build a lightbox. It only renders correctly from a real page served over HTTP(S); it won’t work from a local static file preview.
No, this widget is purely on-page merchandising. You still create a checkout and redirect the shopper as described in Accepting payments once they choose Float.
Not via this widget; it’s fixed to Rand (ZAR) pricing. If you need multi-territory instalment messaging, compute and render it yourself using your merchant config.