On-ramp widget parameters

The following parameters can be used to customize the user journey in the widget.

Parameter	Description
apiKey required	Your publishable API key. This is used to assign customers and transactions to your MoonPay account.
currencyCode	The code of the cryptocurrency (e.g., btc, eth, matic) you want the customer to purchase. The customer will not be able to select another currency. To differentiate between networks, use the currency codes listed in the MoonPay Dashboard.
defaultCurrencyCode	The code of the cryptocurrency you would prefer the customer to purchase. The customer can still select another currency. If both currencyCode and defaultCurrencyCode are passed, currencyCode will take precedence.
walletAddress	The cryptocurrency wallet address the purchased funds will be sent to. If you pass a valid wallet address the customer won’t be prompted to enter one.When pre-filling wallet addresses, you must pass currencyCode and sign the URL. Values need to be URL encoded to generate a valid signature.
walletAddressTag	The secondary cryptocurrency wallet address identifier/memo for coins such as EOS, XLM, XRP and XMR. This parameter will be skipped if walletAddress or currencyCode is not passed.
walletAddresses	A JSON string representing the wallet addresses you want to use for multiple cryptocurrencies. If the customer selects a cryptocurrency for which you have passed a valid wallet address, the customer won’t be prompted to enter one. The currency code must be lowercase.An example for BTC and EOS: {“btc”:“tb1qst9rvjnhym6kwmdkwgfs4h5dtp7cau5346jp9x”,“eos”:“eosmoonpay23”}If you use this parameter, only the cryptocurrencies for which you pass a wallet address will be shown to the customer, unless you also pass the showAllCurrencies parameter. If both walletAddresses and walletAddress are passed, walletAddresses takes precedence.For the following token types, you only need to provide a single wallet address: BEP-2, bnb BEP-20, bnb_bsc ERC-20, eth EOS, eos Polygon, pol_polygon TRC-20, trxWhen using this parameter, you must sign URLs. Learn more about signing URLs.
walletAddressTags	A JSON string representing the wallet address tags you want to use for various cryptocurrencies. An example with EOS and XRP wallet address tags: {“eos”:“myeostag”,“xrp”:“0123456789”}.If the customer selects a cryptocurrency for which you have passed a valid wallet address tag, the customer won’t be prompted to enter one. This parameter will be skipped if walletAddresses is not passed.If both walletAddressTags and walletAddressTag are passed, walletAddressTags takes precedence.
colorCode	The color code for the widget main color. It is used for buttons, links and highlighted text. Only hexadecimal codes are accepted, for example #FF2B8F. You can also apply a different color for dark mode by adding a comma separated color code.
theme	Enable dark mode or light mode as the default appearance for the widget. Possible values are dark, light.
themeId	ID of the theme created for your application or website. See Themes page.NB: This parameter is seldom used. If you built your theme using the MoonPay dashboard theme builder, you do not need to use themeId, as this theme will be applied wherever you use your API key.
language	The ISO 639-1 standard language code representing the language the widget should use.If you pass a code for a language we do not support, the widget will remain in the current default language. This is usually the language of the customer’s browser; if we do not offer that language, the widget will use English (en).
baseCurrencyCode	The code of the fiat currency (e.g. usd, aud, gbp) you want the customer to purchase with.Refer to our Currencies API to get a full list of supported currencies.
baseCurrencyAmount	A positive integer representing how much fiat the customer wants to spend. Best used together with the baseCurrencyCode & currencyCode parameters.Refer to our Currencies API to get the minimum and maximum values for each currency.
quoteCurrencyAmount	A positive integer representing how much crypto the customer wants to buy. Best used together with the currencyCode & baseCurrencyCode parameters.Refer to our Currencies API to get the minimum and maximum values for each currency.Note that if you pass both baseCurrencyAmount and quoteCurrencyAmount, the quote currency amount will take precedence.
contractAddress**	The contract address of the token you want pre-selected for the user in the widget. [Only supported for DeFi Buy integrations.]
networkCode**	Defines the network where the token contract exists (e.g., solana, ethereum). Must match the blockchain where the token contract is deployed. [Only supported for DeFi Buy integrations.]
lockAmount	Set this parameter to true to lock the baseCurrencyAmount set for the customer and prevent them from modifying it. This parameter will be skipped if baseCurrencyAmount is not passed.
email	The customer’s email address. If you pass a valid email address, the customer won’t be prompted to enter one.If a customer is already logged in and their e-mail address doesn’t match with the URL address, the customer will be logged out automatically.
externalTransactionId	An identifier you would like to associate with the transaction. This identifier will be present whenever we pass you transaction data.
externalCustomerId	An identifier you would like to associate with the customer. This identifier will be present whenever we pass you customer data, allowing you to match our data with your own existing customer data.
paymentMethod	Pre-select the payment method you want the customer to use. Possible values are credit_debit_card, gbp_bank_transfer, gbp_open_banking_payment, apple_pay, google_pay, sepa_bank_transfer, pix_instant_payment, interac, paypal, revolut_pay, venmo and moonpay_balance.If payment method is unavailable users will default to our payment selection screen.
redirectURL	A URL you’d like to redirect the customer to after they complete the buy flow in the widget. We will append the transaction’s ID and status as query parameters to your URL.MoonPay will add transactionId={{transactionId}}&transactionStatus=pending to the redirectURL.HTTPS or Universal/App Link URLs are supported. Custom-scheme links (e.g., myapp://…) are not supported.
showAllCurrencies	Set this parameter true to show all cryptocurrencies enabled on your account, including those for which you did not pass any wallet address via the walletAddresses parameter. You don’t need to set this if you did not use the walletAddresses parameter.
showOnlyCurrencies	A comma-separated list of currency codes. Set this parameter if you want to show only some of the cryptocurrencies enabled on your account, without having to pass wallet addresses for those currencies. If both the walletAddresses and showOnlyCurrencies parameters are passed we will only show matching currencies present in both fields. All other currencies will not be included.
showWalletAddressForm	Set this parameter true to show the wallet address form, even though you’ve already passed a valid wallet address via the walletAddress or walletAddresses parameters. The customer will be able to see the valid wallet address, but will not be able to change it.
unsupportedRegionRedirectUrl	A URL you’d like to redirect the customer upon coming from unsupported region. After the user lands on an unsupported region screen, they will be redirected to provided URL after 3 seconds.
skipUnsupportedRegionScreen	Set this parameter to true if you want to skip the widget’s unsupported region screen and immediately redirect the customer. If you set this parameter, you also need to set unsupportedRegionRedirectUrl.
allowedIpAddress	A base64 HMAC-SHA256 hash of the customer’s public IP address, signed with your secret key and included in the signed query string. Required to go live: the widget only loads if this hash matches the IP address MoonPay observes at load time. See IP matching.

**Only supported for DeFi Buy integrations.