Pay with Card
Key: depositWithCash · Deposit method: onramp
The fiat on-ramp lets users fund with a card, Apple Pay, or bank transfer — no crypto required. Swapper's on-ramp partner converts cash to crypto, then that crypto is routed and swapped to your destination token.
What the user experiences
Chooses Pay with Card (labeled "Deposit with Fiat" by default, or "Buy with Fiat" if you set
actionLabel: "buy").Enters an amount and picks a currency, payment method and provider available in their region.
Completes payment with the provider (hosted, PCI-compliant).
The purchased crypto is delivered and swapped to your
dstTokenAddr, which arrives atdepositWalletAddress.
Availability of currencies and payment methods is determined by the provider and the user's geolocation.
Two settlement shapes
Where the purchased crypto lands determines how the deposit is reported:
Straight to an external wallet — the on-ramp delivers directly. The deposit is fully done at
completed.Into a Swapper smart wallet, then swept onward — when the destination needs a further swap/bridge, the on-ramp funds one of our smart wallets, and the onward swap is tracked as a separate
smart_walletdeposit. Final delivery is marked by that second deposit's completion.
In the second case you receive two webhook events — one onramp, one smart_wallet — correlated on-chain. Don't double-count them. See Webhooks → Linking.
What your app receives
A transaction.completed webhook whose deposit.method is onramp, with providerData.type = "onramp":
The on-ramp deposit also carries depositTxHash — the on-chain tx that delivered the crypto — which is the key used to link it to a follow-on smart-wallet swap.
In the browser you also get a transaction_success widget event with depositOption: "depositWithCash".
Mobile WebViews
Inside a native mobile WebView (iOS, Android, React Native, Ionic/Capacitor), add the webviewMode flag. The payment step then shows a link your app opens in the system browser instead of a popup. Setup per platform: Direct Iframe & Mobile → Mobile WebViews.
When payments get declined
Card declines usually come from the user's bank, not from Swapper. Point users or your support team to Card Payment Best Practices.
Last updated