Onramp & Offramp Widget Quickstart

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

Using an AI coding agent? Connect it to these docs first: Build with AI.

Get your public key

Copy your public key (pk_...) from the Partner Dashboard under API Hub.

Build the widget URL

Onramp (buy)
Offramp (sell)

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

https://app.sandbox.rampnow.io/order/quote?apiKey=YOUR_API_KEY&orderType=sell&srcCurrency=USDT&srcChain=ethereum&srcAmount=500&dstCurrency=EUR&dstChain=fiat

Add externalOrderId to tie the order to your records. All parameters: Parameters.

Open it

<iframe
  src="WIDGET_URL"
  title="Rampnow Widget"
  width="100%"
  height="600px"
  frameborder="0"
  allow="payment"
></iframe>

window.location.href = "WIDGET_URL";

Receive webhooks

Add your webhook URL in the Partner Dashboard under API Hub. Rampnow posts on every order status change. See Webhook.

Full guide

Every URL parameter, iframe and redirect modes