# Widget Integration Methods

### ![](https://4289042207-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIdZZHiW5e32FPvxg7DPe%2Fuploads%2FfKYDJbhFj2sVaITP5Ri2%2Fimage.png?alt=media\&token=89329641-270b-4423-9f0e-9aa37d04d27e)Coindisco Widget — Integration Guide&#xD;

Integrating the Coindisco Widget into your website, wallet, or dApp is fast and easy.\
Depending on your project’s needs, you can choose between three integration methods — from a simple redirect to a fully branded API solution.

### 🖼️ Embedded Widget (iFrame)

\
The **Embedded Widget** places the checkout experience directly inside your website or application.\
Users can complete purchases without leaving your page, ensuring a smooth and consistent user experience.\
This method is **ideal for exchanges, wallets, and dashboards**, and allows customization of layout, size, and theme to match your brand.

<figure><img src="https://4289042207-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIdZZHiW5e32FPvxg7DPe%2Fuploads%2FmLi0rhcTvYtoqsL7jWzw%2Fimage.png?alt=media&#x26;token=1b74f39f-28f8-4009-ad43-00f05a629e9b" alt=""><figcaption></figcaption></figure>

This can be achieved by adding the following iFrame snippet to your codebase:&#x20;

```html
<iframe src="
https://widget.coindisco.com/?publicKey=pk_prod_01JVMKTMUSMDYW48QCZKSI3HYY
" width="450px" height="600px" ></iframe>
```

### 🔗 Button Integration (Open in New Tab)

The **Button Integration** allows you to open the Coindisco checkout page in a new browser tab.\
When users click your “Buy Crypto” button, they’re redirected to a secure hosted payment page powered by Coindisco.\
This is the **fastest and easiest** way to integrate crypto purchases — no backend setup is required, and it works with any frontend framework.

**Example:**

```html
<a href="
https://widget.coindisco.com/?publicKey=pk_prod_01JVMKTMUSMDYW48QCZKSI3HYY
" target="_blank" > Buy Crypto </a>
```

### 🔧 White Label API Integration

For partners who want a **fully branded “Buy Crypto” experience**, Coindisco offers a **White Label API**.\
&#x20;This integration allows your application to communicate directly with Coindisco’s backend — you manage the UI, while Coindisco handles quotes, payments, and transaction logic.\
It’s a powerful option for enterprises that require a fully customized design and flow.

<figure><img src="https://4289042207-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIdZZHiW5e32FPvxg7DPe%2Fuploads%2FUNVWNlymtOUPJlUvtyDy%2Fimage.png?alt=media&#x26;token=538f2acc-b421-4628-bb5e-2614712c28ed" alt=""><figcaption></figcaption></figure>

\
![:point\_right:](https://a.slack-edge.com/production-standard-emoji-assets/14.0/google-medium/1f449@2x.png) Learn more in the [White Label API Integration Guide](#white-label-api-integration)

### ⚡ Recommended: Use the Widget Customizer

The **Widget Customizer** lets you visually configure your widget without writing code.\
&#x20;You can adjust parameters like theme, currency, and size, and instantly generate your integration link.

<figure><img src="https://4289042207-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIdZZHiW5e32FPvxg7DPe%2Fuploads%2FOslgKyuI3SatojF2gvkS%2Fimage.png?alt=media&#x26;token=2cc1e0a1-6a84-4de5-a14d-ae93f65c94bb" alt=""><figcaption></figcaption></figure>

\
![:point\_right:](https://a.slack-edge.com/production-standard-emoji-assets/14.0/google-medium/1f449@2x.png)  Open the [Widget Customizer Guide](https://coindisco.gitbook.io/coindisco/widget-integration/widget-customizer-guide)

![](https://4289042207-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIdZZHiW5e32FPvxg7DPe%2Fuploads%2FOu8E2KaflDaNi46jQlpv%2Fimage.png?alt=media\&token=7bd3a293-814b-47f6-8c4c-8c9cddd88155) Try the Widget Customizer [here](https://widget.coindisco.com/customizeUx)

<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://coindisco.gitbook.io/coindisco/widget-integration/widget-integration-methods.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
