⚡Widget quickstart

1. Create or open a widget

Open Dashboard - Widgets in the required environment.

2. Configure the allowed origin

Add the exact website origin that will embed the widget, including the scheme and port when applicable.

https://app.example.com
http://localhost:3000

Do not add a path such as /checkout; origins contain only scheme, host, and optional port.

3. Copy the widget URL

The URL contains the correct sandbox or production public key.

https://widget.coindisco.com/?publicKey=pk_test_YOUR_PUBLIC_KEY

4. Open or embed the URL

Use a redirect for the smallest integration or an iframe to keep the flow on the current page.

5. Test the complete flow

Test region and method selection, buy or sell quotes, wallet validation, provider redirect, and transaction updates. Then verify responsive iframe behavior and failure states.