Twisto widgets can be customized to fit your e-shop. The settings are similar across banner and checkout versions. Below you will find a description of each attribute for all widget types.
| 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 |
The modal has two variants depending on what information is available:
- Static — displayed when
amount and currency are not provided, or when the merchant has not specified which services they offer. Always shows all services without the amount calculation on the right side. - Dynamic — displayed when
amount and currency are provided. Shows the calculated amount for each service. If only one service is offered via product, only that service is shown.
| Attribute | Description | Type | Default value |
|---|
| product | Name of Twisto product. Options: pay-in-30-days, pay-in-3, paid-bnpl. | String | null |
| combination | Use bnpl+pay-in-3 to explicitly show BNPL + Pay in 3 together. Optional. | String | null |
| amount | Product price. When provided together with currency, enables the dynamic variant with calculated amounts. | Number | null |
| currency | Currency of amount. Required with amount. For example, CZK, EUR, PLN, etc. | String | null |
| language | Language. Options: cs, en or pl. | String | en |
| theme | Theme. Options: light or dark. | String | light |
| width | Modal width. Options: auto or full. | String | auto |
| merchant-name | Your e-shop name. Optional. | String | null |
| is-opened | Controls visibility. Set to "true" to show, "false" to hide. | Boolean | "false" |
Same attributes as <twisto-widget>, but uses combination instead of product.
| Attribute | Description | Type | Default value |
|---|
| combination | Combined offer. Currently: bnpl+pay-in-3. | String | null |
| layout | Widget presentation. Options: default or minimal. | String | default |
| language | Language. Options: cs, en or pl. | String | en |
| theme | Theme. Options: light or dark. | String | light |
| site | Redirect target. Can be cz or pl. | String | null |
| width | Widget width. Options: auto or full. | String | auto |
| amount | Product price. Required. | Number | null |
| currency | Currency. Required. For example, CZK, EUR, PLN, etc. | String | null |
| merchant-name | Your e-shop name. Required. | String | null |
A sticky full-width banner fixed to the top of the page. Does not require amount, currency, or merchant-name — the strip promotes Twisto products without displaying calculated prices.
| Attribute | Description | Type | Default value |
|---|
| product | Twisto product. Must be: pay-in-30-days, pay-in-3, or paid-bnpl. | String | null |
| language | Language. Options: cs, en or pl. | String | en |
| theme | Theme color palette. Options: light or dark. | String | light |
| variant | Visual style. Options: white (light background) or colored (purple background). | String | white |
| site | Redirect target site. Can be cz or pl. By default decided by language. | String | null |
Checkout widget for payment selection. Shows Pay in 30 days and Pay in 3 — or a single product when product is specified.
| Attribute | Description | Type | Default value |
|---|
| product | Twisto product. Options: pay-in-30-days or pay-in-3. Omit to show all products. | String | null |
| amount | Product price. Required when product="pay-in-3" or when product is omitted. | Number | null |
| currency | Currency of amount. Required with amount. For example, CZK, EUR, PLN, etc. | String | null |
| language | Language. Options: cs, en or pl. | String | en |
| theme | Theme. Options: light or dark. | String | light |
| width | Widget width. Options: auto or full. | String | auto |
| site | Redirect target. Can be cz or pl. By default decided by language. | String | null |
| selected-type | Read-only. Reflects the selected product — "standard" (Pay in 30 days) or "pay-in-three". | String | null |
| Attribute | Description | Type | Default value |
|---|
| product | Twisto product. Must be: pay-in-30-days or pay-in-3. | String | null |
| language | Language. Options: cs, en or pl. | String | en |
| theme | Theme. Options: light or dark. | String | light |
| site | Redirect target. Can be cz or pl. | String | null |
| width | Widget width. Options: auto or full. | String | auto |
| amount | Product price. Required for pay-in-3. | Number | null |
| currency | Currency. Required for pay-in-3. For example, CZK, EUR, PLN, etc. | String | null |