Widget URL params
Every hosted widget reads the same parameters from either data-* attributes (script + button), URL query string (iframe), or Zoid props.
Universal
| Param | Required? | Notes |
|---|---|---|
configId | Yes | See Networks → ConfigIds matrix |
account | No | Restrict to a single wallet |
lookAndFeel | No | "modal" (default) or "regular" |
themeOverrides | No | JSON string of CSS variable overrides |
postbackUrl | No | Server URL for HMAC-signed lifecycle posts |
postbackSecret | No | HMAC secret (omit for unsigned posts) |
Commit Widget
| Param | Notes |
|---|---|
sellerId | Show offers from one seller |
productUuid | Targets a product (incl. variants) |
bundleUuid | Targets a bundle |
offerId | Targets a single offer |
redirectUrl | Where to redirect after commit |
Redemption Widget
| Param | Notes |
|---|---|
sellerId | Filter to one seller |
exchangeId | Open directly to one exchange |
deliveryInfoUrl | Endpoint to POST collected delivery info |
Finance Widget
| Param | Notes |
|---|---|
role | "seller", "buyer", "disputeResolver", "agent" |
accountId | The on-chain ID for that entity |
Source
- Widgets:
bosonprotocol/widgets