Skip to main content
Widget Mode keeps users on your platform throughout the entire transaction flow via iframe or redirect.

​
Overview

Widget Mode allows you to embed Rampnow’s on-ramp and off-ramp services directly into your application. Users complete transactions within an overlay or iframe without ever leaving your platform.

Two Integration Options

Choose between iFrame (embedded) or Redirect mode

Quick Setup

Get started in minutes with URL parameters

All Payment Methods

Support for all available Rampnow payment modes

Customizable

Pre-fill amounts, currencies, and wallet addresses

​
URL Parameters

Configure the widget by passing parameters in the URL:
ParameterRequiredDefaultDescription
apiKeyRequired-Your unique API key from the Rampnow Partner Dashboard
Example: apiKey=YOUR_API_KEY
orderTypeOptionalbuyTransaction type: buy or sell
srcChainRequiredbuy: fiat
sell: ethereum		Source chain for the asset user is spending
srcCurrencyOptionalbuy: EUR
sell: ETH		Currency user is spending (fiat for buy, crypto for sell)
Example: srcCurrency=ETH
srcAmountOptional100Amount in srcCurrency
Example: srcAmount=100
dstCurrencyOptionalbuy: ETH
sell: EUR		Currency user receives (crypto for buy, fiat for sell)
dstChainRequiredbuy: ethereum
sell: fiat		Destination chain for received currency
paymentModeOptionalPayment mode with Lowest feePayment method: card, google_pay, apple_pay, open_banking, sepa, etc
walletAddressOptional-User’s crypto wallet address
Example: walletAddress=0xYourWalletAddress
walletAddressTagOptional-Optional wallet tag/memo for supported chains
externalOrderIdOptional-Your internal order ID for tracking

​
iFrame Mode

Embed the widget directly on your page for a seamless experience.
1

Create Container

Add a container element in your HTML:
<div id="ramp-container"></div>
2

Construct Widget URL

Build your URL with the required parameters:
https://app.rampnow.io/order/quote?apiKey=YOUR_API_KEY&srcCurrency=EUR&srcAmount=250&dstCurrency=BTC&dstChain=bitcoin&walletAddress=0xYourWalletAddress
3

Initialize iFrame

Embed the widget using an iframe:
<iframe 
  src="https://app.rampnow.io/order/quote?apiKey=YOUR_API_KEY&srcCurrency=EUR&srcAmount=250&dstCurrency=BTC&dstChain=bitcoin&walletAddress=0xYourWalletAddress" 
  title="Rampnow Widget"
  width="100%"
  height="600px"
  frameborder="0">
</iframe>
The widget will be embedded inside your container, providing an in-page experience for users.

​
Redirect Mode

Redirect users to Rampnow’s hosted page for a simpler integration.
1

Construct Widget URL

Build your URL with the required parameters. Example of a full URL with all the parameters:
https://app.rampnow.io/order/quote?apiKey=YOUR_API_KEY&srcCurrency=EUR&srcAmount=250&dstCurrency=BTC&dstChain=bitcoin&walletAddress=0xYourWalletAddress
2

Redirect User

Redirect the user to the constructed URL:
window.location.href = "https://app.rampnow.io/order/quote?apiKey=YOUR_API_KEY&srcCurrency=EUR&srcAmount=250&dstCurrency=BTC&dstChain=bitcoin&walletAddress=0xYourWalletAddress";
This example:
  • User buys 250 EUR worth of BTC
  • Crypto sent to wallet: 0xYourWalletAddress
  • Uses Bitcoin chain for destination

​
Webhook Integration

Track transaction status in real-time by configuring webhooks in your Rampnow Partner Dashboard.
Set up webhooks to receive notifications when users start or complete transactions.

​
When to Use Widget Mode

  • Platforms wanting deeply integrated user experience
  • Partners looking for quick integration
  • Applications needing all available payment modes
  • Teams wanting consistent branding
  • Fastest integration method
  • No custom UI development required
  • All payment methods supported
  • Pre-fill user data for convenience

​
Next Steps