logo

Widget Configuration Guide

Stably Ramp provides a range of configurable options, allowing you to customize the on & off ramping experience to fit your users' specific needs.
Here's a list of the available configuration parameter options.
Example:
URL param
Explanation
Data Type
flow
Specifies the payment flow type. Acceptable values are buy, sell, or swap.
string
fromAmount
Represents the amount e.g. 100.01to be used for the purchase, or the quantity of the asset to be sold/swapped.
numeric
fromAssets
Defines a prioritized list of assets for the from field. Use USD, * to include USD and all other assets. An asterisk (*) shows all remaining assets; absence of an asterisk hides them in the UI. Refer to Supported Crypto Assets for more details.
list of strings
fromNetworks
Specifies a prioritized list of networks (e.g. ethereum, stellar, *) or payment methods (e.g. ach_push, credit_debit_card, domestic_wire, *) for the source field. An asterisk (*) includes all networks; without it, only specified networks are shown. Details on fiat payment networks and crypto networks are available in our documentation on Fees, Limits, and Payment Methods and Supported Networks, respectively.
list of strings
toAssets
Defines a prioritized list of assets for the destination field. Use USDC, USDT, * to include USDC, USDT, and all other assets. An asterisk (*) shows all remaining assets; absence of an asterisk hides them. Supported crypto assets are listed in our Supported Assets and Networks documentation.
list of strings
toNetworks
Specifies a prioritized list of networks (e.g. ethereum, stellar, *) or payment methods (e.g. ach_push, credit_debit_card, domestic_wire, *) for the destination field. An asterisk (*) includes all networks; without it, only specified networks are shown. Refer to our Supported Networks documentation for more information.
list of strings
toAddress
The recipient's wallet address for receiving digital assets, e.g. 0x55e9877C8e66801313607396e7e563391753f800
string
integrationId
A unique identifier provided by Stably, used for tracking metrics such as transaction volume and user signups through your Stably Ramp integration. This value should not be altered.
string
_blank
Needs to be set to 1 (_blank=1). This is only for mobile wallet integrations. Further explained here
numeric
Further examples
✅ USDC & USDT only on-ramp
✅ Prioritizing Frax for on/off-ramp but including all options
✅ Horizen EON only on-ramp
✅ Demonstrate that Stably Ramp wire fees are low
✅ Swap from CUSD only
✅ Swap from Horizen EON only
❌ Invalid from USD to USDC sell flow (should be buy flow)
Share