Overview
While Crossmint provides built-in wallet support, you can also integrate your own wallet solution using thepayer prop. This is useful when:
- You’re already using a wallet connection solution (like RainbowKit, Web3Modal, or ConnectKit)
- You want to customize the transaction signing flow
- You need to support specific wallets or chains
Quick Integration
Here’s a simple example using wagmi and viem:When the user clicks the hosted checkout button, our SDK will first call
handleChainSwitch to ensure the correct
network is set, then handleSignAndSendTransaction to complete the purchase.Payer Configuration
Thepayer prop accepts the following configuration:
Popular Wallet Solutions
You can integrate Crossmint with popular Web3 solutions:RainbowKit
Web3Modal
Best Practices
- Error Handling: Always return clear error messages in
handleSignAndSendTransaction - Chain Support: Be explicit about supported chains to avoid runtime errors
- User Experience: Show loading states during chain switches and transactions
- Wallet Connection: Ensure wallet is connected before showing checkout

