Skip to main content

Configuring your widget: assets, fees, and theming

How to choose which cryptocurrencies you offer, set your fees, and customize your widget's appearance.

Overview


Once you're approved, you can tailor your MoonPay integration to your business — choosing which cryptocurrencies your customers can buy or sell, setting your own fees, and styling the widget to match your brand. This article covers all three, all of which live in your Partner Dashboard and are self-service.

These settings apply to MoonPay Ramps (On-ramp and Off-ramp), which has the fullest configuration options in the dashboard today.

Choosing your cryptocurrencies


Open On-ramp → Enabled assets (or Off-ramp → Enabled assets) to choose which cryptocurrencies your customers can buy or sell.

  • Use the checkboxes to enable or disable each asset, then click Save Changes

  • Search and filter by network to find assets quickly, or use Show Selected to review what's enabled

  • Some assets are tagged Suspended or Suspended Global and can't be enabled

Note: If you can't enable a particular token, check whether it's tagged as Suspended in your region or globally. Suspended assets aren't something you can switch on yourself.

Setting your fees


Open On-ramp → Fees (or Off-ramp → Fees) to set your own fee on top of MoonPay's fees. You can set fees per payment method, with regional overrides via the tabs (Global, Australia, Brazil, East Asia, EEA, UK, US).

  • The columns show MoonPay's fee, the minimum MoonPay fee, and your fee

  • Off-ramp also includes an I am not charging fees option if you'd prefer not to add a fee

Important: Setting your own fees requires Enhanced Verification. If the fee fields show as 0 with a tooltip saying "Complete Enhanced Verification to set transaction fees," you'll need to complete Enhanced Verification first — it's a prerequisite, not a support issue.

Note: The fee field is labelled with a 5% maximum. If you need to charge more than that, speak to your commercial contact at MoonPay rather than adjusting it in the dashboard.

Customizing your widget's appearance


Open Theming to style the widget so it matches your brand. Three widget types are themed independently via tabs: Top-up Widget, Buy Widget v2, and Buy Widget v1.

  • The live preview in the centre shows your widget with the current theme applied

  • Use the Theme Controls panel to adjust the look, with sub-tabs for General, Loader, Light Theme, and Dark Theme

  • Under General you can set Button, Widget, and Foreground radius

  • Click Save Changes when you're done, or Reset to Default to start over

Tip: Make sure you're theming the right widget type for your integration — Buy v1, Buy v2, or Top-up each carry their own theme.

FAQs


Why can't I enable a particular cryptocurrency?

It's likely tagged Suspended in your region or globally, which means it can't be switched on from your side.

Why are my fee fields locked at 0?

Setting fees requires Enhanced Verification. Complete that first and the fields will unlock.

Can I charge more than 5%?

The dashboard caps the fee field at 5%. If your business needs to charge more, speak to your commercial contact at MoonPay.

My theme changes aren't showing on my live widget.

First, confirm you clicked Save Changes. If you did and the change still isn't live, there may be a caching or deployment layer between the dashboard and your live widget — ask Nova and it'll raise this for a closer look.

Where to get help


If your assets, fees, or theming aren't behaving as expected after checking the steps above, just ask Nova — our AI assistant, right there in your dashboard. Nova gives instant answers to most questions, and if it can't resolve something on its own, it'll create a support request and pass it to our partner support team for you.

Did this answer your question?