Deposit with Exchange - JavaScript

Note

If you're looking to enable crypto payments in your online or in-person business, check out WalletConnect Pay, our all-in-one payments solution. Learn more in the WalletConnect Pay docs →

Deposit with Exchange gives your users a seamless way to fund their connected wallets directly from centralized exchange accounts like Binance. Instead of forcing users to leave your app, log into their exchange, and manually handle withdrawals, you can offer a guided in-app flow that keeps them engaged and ready to transact.

Quickstart#

This feature will start working as soon as your team is on the allowed-list. Contact us via our form here to get started.

Warning

Projects first need to install and set up Reown AppKit before integrating AppKit Pay. If you haven't done so, please refer to the Reown AppKit docs.

Clicking on Fund your wallet will show the modal below:

Funding your wallet with Deposit with Exchange

Start Deposit with Exchange from a button#

Install the library#

npm install @reown/appkit-pay

Usage#

Import the baseUSDC asset, the pay function and the useAppKitAccount hook to get the address of the connected wallet.

import { baseUSDC, pay } from '@reown/appkit-pay';

Get the address of the connected wallet using the subscribeAccount function.

let address = null;const appKit = createAppKit({...}); // please check our docs or examples to understand how to create the AppKit instanceappKit.subscribeAccount(state => {    address = state['accountState']?.address;})

In order to run the deposit, use the function pay. This function receives three parameters.

// pay function returns a PaymentResult objectconst result = await pay({     recipient: address,    amount: 0.0001,    paymentAsset: baseUSDC});if (result.success) {    console.log("Payment successful: "+ result.result);} else {    console.error("Payment error: "+ result.error);}

Supported Networks and Assets#

Currently, Deposit with Exchange supports the following assets on the following networks:

Asset -> Network

Binance

USDC -> Ethereum, Optimism, Arbitrum, Base, Polygon, Solana
USDT -> Ethereum, Optimism, Arbitrum, Polygon, Solana
Native Solana

For access to additional networks or assets, contact us via our form here.

Assets Configuration#

For the moment, AppKit Pay has pre-configured these assets:

baseETH, baseSepoliaETH, and baseUSDC
ethereumUSDC, optimismUSDC, arbitrumUSDC, polygonUSDC and solanaUSDC
ethereumUSDT, optimismUSDT, arbitrumUSDT, polygonUSDT and solanaUSDT

import { baseETH } from '@reown/appkit-pay'

For custom assets, you can create a paymentAsset object with all the information:

// Configure the paymentAssetconst paymentAssetDetails = {    network: 'eip155:8453', // Base Mainnet    asset: 'native', // Or USDC in Base: '0x833589fcd6edb6e08f4c7c32d4f71b54bda02913'    metadata: {        name: 'Ethereum', // Or 'USD Coin'        symbol: 'ETH',    // Or 'USDC'        decimals: 18      // Or 6 for USDC    }};