Parameters | Integrate Kado

Field	Values	Type	Default Value
apiKey - Required Kado integrator key. This is a public key used for identifier purposes.	[UUID] Ex: fa47115e-35e3-11ed-a261-0242ac120002	String
onPayCurrency The fiat currency that will be selected by default for the user to pay in. Users can select any other that is available for selection.	USD, EUR, CAD, GBP, MXN, COP, INR, CHF, AUD, ARS, BRL, CLP, JPY, KRW, PEN, PHP, SGD, TRY, UYU, TWD, VND, CRC, SEK, PLN, DKK, NOK, NZD	String	USD
onRevCurrency The cryptocurrency that will be selected by default for the user to buy. Users can select any other that is available for selection. Note: requires network to be set.	USDT, USDC, SOL, ETH, AVAX, DAI, OSMO, ATOM, BTC, XLM, STARS, SCRT, INJ, CMDX, wETH, wBTC, USDC.e, MATIC, XRP, REGEN, WHALE, BLD, IST, XKI, XPLA, HUAHUA, FLIX, ARCH, LTC, NTRN, SEI, TIA, COREUM, BONK, JUP, KUJI, QCK, IXO, FRAX	String
offPayCurrency The cryptocurrency that will be selected by default for the user to sell. Users can select any other that is available for selection. Note: Off Ramp currently not available for Arbitrum, Optimism, Polygon	USDT, USDC, SOL, ETH, AVAX, ATOM, BTC, XLM, XRP, LTC, NTRN, SEI, TIA, BONK, JUP, KUJI, QCK	String
offRevCurrency The fiat currency that will be selected by default for the user to be paid in. Users can select any other that is available for selection.	USD	String
product The option that will be selected by default (on-ramp or off-ramp). Users can change the selection.	BUY, SELL, SWAP	String
onPayAmount The amount that will be selected by default for the user to buy. Users can enter any other amount.	Any positive number, rounded to the nearest cent. Min/max will be validated upon widget load. Min >= 10	String
offPayAmount The amount that will be entered by default for the user to sell. Users can enter any other amount.	Any positive number. Min/max will be validated upon widget load.	String
onToAddress Blockchain address of the wallet where the purchased cryptocurrency will be sent to.	Valid wallet address matching the network Ex: 0x3ACfa4b5320550199C322A9B33e85c70d0F90D1b	String
onToAddressMulti Key-value pairs to set multiple wallet addresses, associated to a specific blockchain.	Valid chain:address key-value pairs Ex: ETHEREUM:0x1234,OSMOSIS:osmo1234,COSMOS HUB:cosmos1234	Array[string]
offFromAddress Blockchain address of the wallet that cryptocurrency will be sent from, for an off-ramp.	Valid wallet address matching the network Ex: 0x3ACfa4b5320550199C322A9B33e85c70d0F90D1b	String
network The crypto network that will be selected by default for buy or sell. Users can select any other networks that are available for selection. Note: Requires onRevCurrency to be set. Note: Off Ramp currently not available for Arbitrum, Optimism, Polygon	BITCOIN, TERRA, OSMOSIS, SOLANA, ETHEREUM, JUNO, AVALANCHE, KUJIRA, INJECTIVE, ARBITRUM, OPTIMISM, POLYGON, COSMOS HUB, STELLAR, STARGAZE, SECRET, BASE, COMDEX, RIPPLE, BASE, REGEN, AGORIC, MIGALOO, KI, XPLA, NOBLE, CHIHUAHUA, OMNIFLIX, ARCHWAY, LITECOIN, NEUTRON, SEI, CELESTIA, COREUM, QUICKSILVER, IMPACTS HUB, FRAXTAL	String
cryptoList A comma-separated list of crypto currencies that users can buy or sell. Only these will show on the widget.	USDT, USDC, SOL, ETH, AVAX, DAI, OSMO, ATOM, BTC, XLM, STARS, SCRT, INJ, CMDX, wETH, wBTC, USDC.e, MATIC, XRP, REGEN, WHALE, BLD, IST, XKI, XPLA, HUAHUA, FLIX, ARCH, LTC, NTRN, SEI, TIA, COREUM, BONK, JUP, KUJI, QCK, IXO, FRAX	Array[string]	USDT, USDC, SOL, ETH, AVAX, DAI, OSMO, ATOM, BTC, XLM, STARS, SCRT, INJ, CMDX, wETH, wBTC, USDC.e, MATIC, XRP, REGEN, WHALE, BLD, IST, XKI, XPLA, HUAHUA, FLIX, ARCH, LTC, NTRN, SEI, TIA, COREUM, BONK, JUP, KUJI, QCK
fiatList A comma-separated list of fiat currencies that users can buy or sell. Only these will show on the widget.	USD, CAD, GBP, EUR, MXN, COP, INR, CHF, AUD, ARS, BRL, CLP, JPY, KRW, PEN, PHP, SGD, TRY, UYU, TWD, VND, CRC, SEK, PLN, DKK, NOK, NZD	Array[string]	USD, CAD, GBP, EUR, MXN, COP, INR, CHF, AUD, ARS, BRL, CLP, JPY, KRW, PEN, PHP, SGD, TRY, UYU, TWD, VND, CRC, SEK, PLN, DKK, NOK, NZD
networkList A comma-separated list of crypto networks that users can buy or sell. Only these will show on the widget. Note: Requires onRevCurrency to be set.	BITCOIN, TERRA, OSMOSIS, SOLANA, ETHEREUM, JUNO, AVALANCHE, KUJIRA, INJECTIVE, ARBITRUM, OPTIMISM, POLYGON, COSMOS HUB, STELLAR, STARGAZE, SECRET, BASE, COMDEX, RIPPLE, BASE, REGEN, AGORIC, MIGALOO, KI, XPLA, NOBLE, CHIHUAHUA, OMNIFLIX, ARCHWAY, LITECOIN, NEUTRON, SEI, CELESTIA, COREUM, QUICKSILVER, IMPACTS HUB, FRAXTAL	Array[string]	BITCOIN, TERRA, OSMOSIS, SOLANA, ETHEREUM, JUNO, AVALANCHE, KUJIRA, INJECTIVE, ARBITRUM, OPTIMISM, POLYGON, COSMOS HUB, STELLAR, STARGAZE, SECRET, BASE, COMDEX, RIPPLE, BASE, REGEN, AGORIC, MIGALOO, KI, XPLA, NOBLE, CHIHUAHUA, OMNIFLIX, ARCHWAY, LITECOIN, NEUTRON, SEI, CELESTIA, COREUM, QUICKSILVER
productList A comma-separated list of products that the user will see on the widget.	BUY, SELL, SWAP	Array[string]	BUY, SELL, SWAP
theme Sets the theme of the widget to light or dark. The default theme is light.	light, dark	String	light
email The user's email that you'd like to trigger a login for	valid email address	String
mode The UI mode. Minimal mode will remove the menu and drop users directly into the Order Confirmation page.	minimal, full	String
fiatMethodList The fiat payment methods to allow the user to pay with, or sell to.	card, ach, apple, wire, sepa, pix, debit_only	Array[string]	card, ach, apple, wire, sepa, pix, debit_only
userRef An optional reference provided by the integrator to link a reference in the integrator's system to a Kado user.	valid uuid	String
sessionId An optional reference provided by the integrator to link a session to any orders created within that session. The `sessionId` will correspond to the `orderRef` field for a given order obtained via the API/webhooks.	valid uuid	String
phone The user's phone number that you'd like to verify.	valid phone number	String
primaryColor The primary display color for your widget theme.	valid color hex code or RBG values Ex 1: 242,169,0 Ex 2: F2A900	String
secondaryColor The secondary display color for your widget theme.	valid color hex code or RBG values Ex 1: 242,169,0 Ex 2: F2A900	String
successColor The color to display upon successful interactions.	valid color hex code or RBG values Ex 1: 242,169,0 Ex 2: F2A900	String
warningColor The color to display upon warnings for user interactions.	valid color hex code or RBG values Ex 1: 242,169,0 Ex 2: F2A900	String
errorColor The color to display upon errored interactions.	valid color hex code or RBG values Ex 1: 242,169,0 Ex 2: F2A900	String
appRedirect An optional parameter to enhance the post-settlement user experience by enabling seamless redirection from an external web browser to a new tab or deep link within an app. To enable the redirection feature, set the appRedirect parameter to true and reach out to our support team for more details. NOTE: If you do not wish to use the redirection feature, simply do not include the appRedirect parameter in the URL parameters.	true, false	String

apiKey - Required Kado integrator key. This is a public key used for identifier purposes.

[UUID] Ex: fa47115e-35e3-11ed-a261-0242ac120002

String

onPayCurrency

The fiat currency that will be selected by default for the user to pay in. Users can select any other that is available for selection.

USD, EUR, CAD, GBP, MXN, COP, INR, CHF, AUD, ARS, BRL, CLP, JPY, KRW, PEN, PHP, SGD, TRY, UYU, TWD, VND, CRC, SEK, PLN, DKK, NOK, NZD

String

USD

onRevCurrency The cryptocurrency that will be selected by default for the user to buy. Users can select any other that is available for selection. Note: requires network to be set.

USDT, USDC, SOL, ETH, AVAX, DAI, OSMO, ATOM, BTC, XLM, STARS, SCRT, INJ, CMDX, wETH, wBTC, USDC.e, MATIC, XRP, REGEN, WHALE, BLD, IST, XKI, XPLA, HUAHUA, FLIX, ARCH, LTC, NTRN, SEI, TIA, COREUM, BONK, JUP, KUJI, QCK, IXO, FRAX

String

offPayCurrency

The cryptocurrency that will be selected by default for the user to sell. Users can select any other that is available for selection. Note: Off Ramp currently not available for Arbitrum, Optimism, Polygon

USDT, USDC, SOL, ETH, AVAX, ATOM, BTC, XLM, XRP, LTC, NTRN, SEI, TIA, BONK, JUP, KUJI, QCK

String

offRevCurrency

The fiat currency that will be selected by default for the user to be paid in. Users can select any other that is available for selection.

USD

String

product

The option that will be selected by default (on-ramp or off-ramp). Users can change the selection.

BUY, SELL, SWAP

String

onPayAmount

The amount that will be selected by default for the user to buy. Users can enter any other amount.

Any positive number, rounded to the nearest cent. Min/max will be validated upon widget load. Min >= 10

String

offPayAmount

The amount that will be entered by default for the user to sell. Users can enter any other amount.

Any positive number. Min/max will be validated upon widget load.

String

onToAddress

Blockchain address of the wallet where the purchased

cryptocurrency will be sent to.

Valid wallet address matching the network Ex: 0x3ACfa4b5320550199C322A9B33e85c70d0F90D1b

String

onToAddressMulti Key-value pairs to set multiple wallet addresses, associated to a specific blockchain.

Valid chain:address key-value pairs Ex: ETHEREUM:0x1234,OSMOSIS:osmo1234,COSMOS HUB:cosmos1234

Array[string]

offFromAddress Blockchain address of the wallet that cryptocurrency will be sent from, for an off-ramp.

Valid wallet address matching the network Ex: 0x3ACfa4b5320550199C322A9B33e85c70d0F90D1b

String

network

The crypto network that will be selected by default for buy or sell. Users can select any other networks that are available for selection.

Note: Requires onRevCurrency to be set. Note: Off Ramp currently not available for Arbitrum, Optimism, Polygon

BITCOIN, TERRA, OSMOSIS, SOLANA, ETHEREUM, JUNO, AVALANCHE, KUJIRA, INJECTIVE, ARBITRUM, OPTIMISM, POLYGON, COSMOS HUB, STELLAR, STARGAZE, SECRET, BASE, COMDEX, RIPPLE, BASE, REGEN, AGORIC, MIGALOO, KI, XPLA, NOBLE, CHIHUAHUA, OMNIFLIX, ARCHWAY, LITECOIN, NEUTRON, SEI, CELESTIA, COREUM, QUICKSILVER, IMPACTS HUB, FRAXTAL

String

cryptoList

A comma-separated list of crypto currencies that users can buy or sell. Only these will show on the widget.

USDT, USDC, SOL, ETH, AVAX, DAI, OSMO, ATOM, BTC, XLM, STARS, SCRT, INJ, CMDX, wETH, wBTC, USDC.e, MATIC, XRP, REGEN, WHALE, BLD, IST, XKI, XPLA, HUAHUA, FLIX, ARCH, LTC, NTRN, SEI, TIA, COREUM, BONK, JUP, KUJI, QCK, IXO, FRAX

Array[string]

USDT, USDC, SOL, ETH, AVAX, DAI, OSMO, ATOM, BTC, XLM, STARS, SCRT, INJ, CMDX, wETH, wBTC, USDC.e, MATIC, XRP, REGEN, WHALE, BLD, IST, XKI, XPLA, HUAHUA, FLIX, ARCH, LTC, NTRN, SEI, TIA, COREUM, BONK, JUP, KUJI, QCK

fiatList

A comma-separated list of fiat currencies that users can buy or sell. Only these will show on the widget.

USD, CAD, GBP, EUR, MXN, COP, INR, CHF, AUD, ARS, BRL, CLP, JPY, KRW, PEN, PHP, SGD, TRY, UYU, TWD, VND, CRC, SEK, PLN, DKK, NOK, NZD

Array[string]

USD, CAD, GBP, EUR, MXN, COP, INR, CHF, AUD, ARS, BRL, CLP, JPY, KRW, PEN, PHP, SGD, TRY, UYU, TWD, VND, CRC, SEK, PLN, DKK, NOK, NZD

networkList

A comma-separated list of crypto networks that users can buy or sell. Only these will show on the widget. Note: Requires onRevCurrency to be set.

BITCOIN, TERRA, OSMOSIS, SOLANA, ETHEREUM, JUNO, AVALANCHE, KUJIRA, INJECTIVE, ARBITRUM, OPTIMISM, POLYGON, COSMOS HUB, STELLAR, STARGAZE, SECRET, BASE, COMDEX, RIPPLE, BASE, REGEN, AGORIC, MIGALOO, KI, XPLA, NOBLE, CHIHUAHUA, OMNIFLIX, ARCHWAY, LITECOIN, NEUTRON, SEI, CELESTIA, COREUM, QUICKSILVER, IMPACTS HUB, FRAXTAL

Array[string]

BITCOIN, TERRA, OSMOSIS, SOLANA, ETHEREUM, JUNO, AVALANCHE, KUJIRA, INJECTIVE, ARBITRUM, OPTIMISM, POLYGON, COSMOS HUB, STELLAR, STARGAZE, SECRET, BASE, COMDEX, RIPPLE, BASE, REGEN, AGORIC, MIGALOO, KI, XPLA, NOBLE, CHIHUAHUA, OMNIFLIX, ARCHWAY, LITECOIN, NEUTRON, SEI, CELESTIA, COREUM, QUICKSILVER

productList A comma-separated list of products that the user will see on the widget.

BUY, SELL, SWAP

Array[string]

BUY, SELL, SWAP

theme Sets the theme of the widget to light or dark. The default theme is light.

light, dark

String

light

email The user's email that you'd like to trigger a login for

valid email address

String

mode The UI mode. Minimal mode will remove the menu and drop users directly into the Order Confirmation page.

minimal, full

String

fiatMethodList The fiat payment methods to allow the user to pay with, or sell to.

card, ach, apple, wire, sepa, pix, debit_only

Array[string]

card, ach, apple, wire, sepa, pix, debit_only

userRef An optional reference provided by the integrator to link a reference in the integrator's system to a Kado user.

valid uuid

String

sessionId An optional reference provided by the integrator to link a session to any orders created within that session. The sessionId will correspond to the orderRef field for a given order obtained via the API/webhooks.

valid uuid

String

phone The user's phone number that you'd like to verify.

valid phone number

String

primaryColor The primary display color for your widget theme.