Skip to main content
The widget is Rampnow’s complete buy and sell flow, opened with a URL. You link to it or put it in an iframe, pass your partner key and any order details you already know as query parameters, and Rampnow runs everything from sign-in to delivery. There is no package to install and no JavaScript to write.

iFrame or Redirect

Keep users on your page with an iframe, or send them to the hosted page

Quick Setup

Configure everything with URL parameters

All Payment Methods

Every payment method enabled for your account, out of the box

Pre-filled orders

Pre-fill direction, assets, amount and wallet address
Need event callbacks, open/close control or a React hook? The SDK wraps the widget with a JavaScript API and accepts the same parameters.

​
How it works

1

Build the widget URL

Start from the widget host for your environment, add /order/quote and your parameters. See URL parameters.
2

Open it

Load the URL in an iframe or redirect the user to it. See Embed.
3

The user completes the order

The user signs in, passes KYC if needed and pays or sends crypto. See User Flow for what they see.
4

Track it with webhooks

Rampnow sends a webhook to your endpoint on every status change. See the Webhook guide.

​
Your partner API key

Every widget session, whether opened by URL, iframe or the SDK, carries your partner API key as apiKey. That key is what makes the order yours:
  • Orders placed through your integration are attributed to your account in the Partner Dashboard
  • Order status webhooks go to your endpoint
  • The partner fee agreed with Rampnow for your account applies to each order. It can be zero if you integrate for visibility only
Use the public key from the Partner Dashboard under API Hub. Sandbox and production keys are different, and each only works against its own environment.
The public key is safe to ship in client-side code. You don’t need a backend, an API secret or request signing to open the widget. The API key and secret pair (with X-RAMPNOW-SIGN) is only for the Onramp & Offramp Intent REST API.

​
Environments

Build and test against sandbox first. No real money or mainnet crypto moves there. See Sandbox Testing for test payments and testnet tokens.

​
When to use the widget

  • Platforms that want a deeply integrated experience with minimal code
  • The fastest launch: a link or an iframe is enough
  • Native apps and emails, where a URL is easier than a JavaScript SDK
  • Teams that want Rampnow’s pre-built UI, updated without code changes
  • You need browser events or programmatic control: use the SDK
  • You want to build the pre-checkout journey yourself and create orders server-to-server: use Onramp & Offramp Intent
See Integrations Overview for a side-by-side comparison.

Next: URL parameters

Every parameter you can pass to the widget