> For the complete documentation index, see [llms.txt](https://docs.calypso.money/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.calypso.money/acquiring/onramp-widget/how-to-embed-the-onramp-widget-to-your-site.md).

# How to embed the ONRAMP widget to your site

#### Iframe Integration

You can embed the payment widget into your page using the HTML `iframe` element.

**Basic integration example:**

html

```
<iframe
  src="https://pay.calypso.money/onramp?account=0xf54aa3ec1f12a4eb3c8bf565078b371f3736f434&widgetKey=509ca990-8a94-45d5-858a-0971a1b7e2e9&idempotencyKey=dee72a7a-0e6d-4e7d-baf0-e7bf02a895d0&color=256eff&logo=true&radius=6&theme=light"
  allow="clipboard-read; clipboard-write">
</iframe>
```

**Required permissions:**

For all widget functions to work properly, the following permissions must be added to the `allow` attribute:

* `clipboard-read` — for reading data from the clipboard
* `clipboard-write` — for writing data to the clipboard

These permissions enable the copy buttons (payment address, amount, and other information) to function correctly within the widget.

**Why this matters:**

For security reasons, modern browsers block clipboard access for content loaded inside an `iframe` unless explicit permission is granted via the `allow` attribute.

Without these permissions, the copy buttons will not work, resulting in a poor user experience and potential errors when making a payment.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://docs.calypso.money/acquiring/onramp-widget/how-to-embed-the-onramp-widget-to-your-site.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.