> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rampnow.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Onramp & Offramp Widget Quickstart

> Embed Rampnow's buy and sell flow with a URL or an iframe

No backend and no signing: one URL with your public key. Set `orderType` to `buy` (onramp) or `sell` (offramp). Examples run against **sandbox**.

<Tip>
  Using an AI coding agent? Connect it to these docs first: [Build with AI](/quickstart/build-with-ai).
</Tip>

<Steps>
  <Step title="Get your public key">
    Copy your public key (`pk_...`) from the [Partner Dashboard](https://partner.rampnow.io) under **API Hub**.
  </Step>

  <Step title="Build the widget URL">
    <Tabs>
      <Tab title="Onramp (buy)">
        ```text theme={null}
        https://app.sandbox.rampnow.io/order/quote?apiKey=YOUR_API_KEY&orderType=buy&srcCurrency=EUR&srcChain=fiat&srcAmount=250&dstCurrency=ETH&dstChain=ethereum&walletAddress=0xUserWalletAddress
        ```
      </Tab>

      <Tab title="Offramp (sell)">
        ```text theme={null}
        https://app.sandbox.rampnow.io/order/quote?apiKey=YOUR_API_KEY&orderType=sell&srcCurrency=USDT&srcChain=ethereum&srcAmount=500&dstCurrency=EUR&dstChain=fiat
        ```
      </Tab>
    </Tabs>

    Add `externalOrderId` to tie the order to your records. All parameters: [Parameters](/quickstart/ramp-widget/parameters).
  </Step>

  <Step title="Open it">
    <CodeGroup>
      ```html iFrame theme={null}
      <iframe
        src="WIDGET_URL"
        title="Rampnow Widget"
        width="100%"
        height="600px"
        frameborder="0"
        allow="payment"
      ></iframe>
      ```

      ```javascript Redirect theme={null}
      window.location.href = "WIDGET_URL";
      ```
    </CodeGroup>
  </Step>

  <Step title="Receive webhooks">
    Add your webhook URL in the Partner Dashboard under **API Hub**. Rampnow posts on every order status change. See [Webhook](/api-reference/webhook).
  </Step>
</Steps>

<Card title="Full guide" icon="book-open" href="/quickstart/ramp-widget/overview">
  Every URL parameter, iframe and redirect modes
</Card>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.