Overview

The widget's home screen offers several ways for a user to fund your destination: three methods shown by default, plus opt-in source flows you enable explicitly. This section explains what each one does, what the user experiences, and what your app receives.

You control which appear with supportedDepositOptions; omit it to show the default set.

The default methods

Method	Key	User pays with	Best when
Pay with Card	depositWithCash	Card / Apple Pay / bank (fiat)	Users have no crypto yet.
Transfer Crypto	transferCrypto	A one-tap smart-wallet deposit	Lowest-friction on-chain funding.
Wallet Deposit	walletDeposit	Tokens in their own wallet, any chain	Crypto-native users.

All three converge on the same outcome: your dstTokenAddr on dstChainId, delivered to depositWalletAddress.

Opt-in source flows

Two additional funding sources, off by default — enable them explicitly in supportedDepositOptions. Each pulls the user's balance from that platform and swaps/bridges it to your destination token, much like Wallet Deposit but sourced from a specific platform account rather than a connected wallet.

Method	Key	Source
Deposit from Polymarket	depositFromPolymarket	The user's Polymarket USDC balance
Deposit from Perps	depositFromPerps	The user's balance on a supported perps venue

How they map to a deposit's method

When a deposit completes, its record (in webhooks) carries a method field. It relates to the widget option like so:

Widget option	Deposit method
depositWithCash	onramp (and, if swept onward, a linked smart_wallet)
transferCrypto	smart_wallet
walletDeposit	dex_swap

The onramp-plus-sweep case produces two linked deposits — see Webhooks → Linking.

Amounts and limits

• Deposit size can be clamped in USD with minDepositUsd / maxDepositUsd.

• The wallet-deposit flow always floors the minimum by a gas-based estimate so network fees are covered.

• All reported amounts are base-unit strings.

Choosing what to show

• Consumer app, mainstream users → lead with depositWithCash; the one-tap transferCrypto is also low-friction. Keep walletDeposit for crypto-native users who prefer their own wallet.

• DeFi / on-chain product → walletDeposit and transferCrypto.

• Not sure → show the default set and let users pick.

• Built on Polymarket or a perps venue? → enable the matching opt-in source flow so users can fund straight from their platform balance.

Read the per-method pages for the details:

• Pay with Card

• Transfer Crypto

• Wallet Deposit