twisto-widget | Twisto Documentation

Banner widget for product pages — Pay in 30 days, Pay in 3, Paid BNPL.

Step 1: Add this script to the page ⬇️

<script src="https://cdn.twistopay.com/widget/twisto-widget.js" async></script>

Step 2: In the body of the page, insert the widget where you want it to appear ⬇️

The widget supports three products. Choose the one you need:

Pay in 30 days — no extra attributes needed:

<twisto-widget product="pay-in-30-days" language="en"></twisto-widget>

Pay in 3 — requires amount, currency, and merchant-name:

<twisto-widget
  product="pay-in-3"
  merchant-name="ESHOP_NAME"
  amount="AMOUNT"
  currency="CZK"
  language="en"
></twisto-widget>

Change merchant-name="ESHOP_NAME" to the name of your e-shop and always pass the product price to amount.

The widget supports default and minimal layouts via the layout attribute:

Default	Minimal

Attributes

Attribute	Description	Type	Default value
language	Language of widget. Options: `cs`, `en` or `pl`.	String	`en`
product	Name of Twisto product. Must be: `pay-in-30-days`, `pay-in-3`, or `paid-bnpl`.	String	`null`
layout	Widget presentation. Options: `default` or `minimal`. Optional — defaults to `default` if omitted.	String	`default`
theme	Theme color palette. Options: `light` or `dark`.	String	`light`
site	To which site the user will be redirected. By default decided by language. Can be `cz` or `pl`.	String	`null`
width	The width of widget. Options: `auto` or `full`.	String	`auto`
amount	Product price. Required for `pay-in-3` and `paid-bnpl`.	Number	`null`
currency	Currency of amount. Required for `pay-in-3` and `paid-bnpl`. For example, `CZK`, `EUR`, `PLN`, etc.	String	`null`
merchant-name	Your e-shop name. Required for `pay-in-3` and `paid-bnpl` banner.	String	`null`

For a full list of available attributes, see How to edit Twisto widgets.

<twisto-widget product="pay-in-30-days" language="en"></twisto-widget>

<twisto-widget product="pay-in-30-days" language="en" layout="minimal"></twisto-widget>

<twisto-widget
  product="pay-in-3"
  merchant-name="ESHOP NAME"
  amount="2000"
  currency="CZK"
  language="en"
></twisto-widget>

<twisto-widget
  product="paid-bnpl"
  merchant-name="ESHOP NAME"
  amount="2000"
  currency="CZK"
  language="en"
></twisto-widget>