Configure your widget

Sandbox and Live each have their own widget. The environment switch in the dashboard sidebar chooses which one you’re editing. Saving a change asks for the code we email you. The top of the section shows the widget’s state: Not configured, New links enabled or Paused.

Website

Setting	What it does
Websites allowed to embed your widget	The pages that may open the widget, up to 10. `https` addresses only; `http://localhost` is also allowed in Sandbox. A page that isn’t listed gets a not-found screen instead of the widget.
Redirect origins	Where a widget link’s `redirect` may send the customer. By default the same as the websites above. Turn on Use different redirect origins when customers should land somewhere else.

Redirect origins matter only when a customer opens a widget link as a full page, for example from an email. Inside the window on your page the widget doesn’t navigate; your callbacks run instead. Example. The widget opens on https://shop.example.com, but after paying you want the customer on https://account.example.com/orders/123. Turn on Use different redirect origins, add https://account.example.com, and pass redirect: "https://account.example.com/orders/123" in the link.

Appearance

Setting	What it does
Display name	The business name shown at the top of the widget.
Button colour	The colour of the widget’s buttons.
Logo address	An `https` URL of your logo.
Support chat	Whether customers can open support chat inside the widget.

Payment options

Setting	What it does
Buy and sell stablecoins, Buy stablecoins only, Sell stablecoins only	Which directions the widget offers. A link that asks for a direction you turned off is refused.
Stablecoins, Networks, Currencies	All supported, or only the ones you pick. Prefills in a link are limited to these; the customer can choose among them.

The exact assets, networks and currencies you can enable are listed under Coverage.

Signing secret & security

Setting	What it does
Signing secret	Shown once when the widget is created. Only needed for signed links. Rotate secret invalidates every link signed with the old one.
Allow unsigned links	On by default: your page opens the widget with the widget ID alone, and link parameters are prefills the customer can change. Turn it off to require every link to be signed.
Accept new widget links	Turn it off to pause the widget: new opens show a not-found screen, and payments already in progress continue. The state at the top reads Paused.

The widget ID is permanent and appears in every link as /w/<widget-id>.

Welcome

API basics

Ramp

Orchestration

Wallets

Agentic Payments

Configure your widget

Website

Appearance

Payment options

Signing secret & security

​Website

​Appearance

​Payment options

​Signing secret & security

Website

Appearance

Payment options

Signing secret & security