How to Donate: Understanding MetaMask Popup
How to Donate: Understanding MetaMask Popups
Making your first donation on our platform? This guide explains exactly what to expect during the donation process,
including the important two-popup system.
Before You Start
Make sure you have:
- MetaMask installed and set up on Polygon network
- POL tokens (for gas fees)
- USDC tokens (for donating)
Need help with setup? Check our MetaMask Wallet Setup Guide first.
The Two-Popup Donation Process
⚠️ CRITICAL: You will see TWO MetaMask popups when donating
This is normal and required for all donations. Here's what happens:
Popup 1: Token Approval
- What it says: "Approve" or "Allow [website] to spend your USDC"
- What it does: Gives our website permission to access your USDC tokens
- Gas fee: Small fee (usually under $0.50)
- You must: Click "Confirm" to proceed
Popup 2: Donation Transaction
- What it says: "Confirm" transaction
- What it does: Actually sends your donation
- Gas fee: Small fee (usually under $0.50)
- You must: Click "Confirm" to complete donation
Step-by-Step Donation Process
1. Enter donation amount on the campaign page
2. Click "Donate" button
3. First popup appears - Click "Confirm" to approve token access
4. Wait a few seconds for the approval to process
5. Second popup appears - Click "Confirm" to send your donation
6. Wait for confirmation - You'll see a success message
Total time: Usually 5 to 10 seconds
Gas Fee Settings
When each popup appears:
1. Look for gas fee options (usually shows "Market" by default)
2. Click "Market" to see other options
3. Select "Aggressive" for fastest processing
4. This ensures your transaction goes through quickly
Common Issues & Solutions
"Transaction Failed" Error
- Cause: Insufficient POL for gas fees
- Solution: Buy more POL tokens or try again with lower gas fees
"Only One Popup Appeared"
- Cause: You may have already approved this website before
- Solution: This is normal - just confirm the second popup
"Donation Not Showing Up"
- Cause: Network congestion or you only approved the first popup
- Solution: Wait 30 seconds or check if second popup is still pending
"MetaMask Not Connecting"
- Cause: Wrong network or wallet issues
- Solution: Make sure you're on Polygon network and refresh the page
Important Reminders
✅ Always approve BOTH popups - your donation won't work with just one
✅ Use "Aggressive" gas fees - prevents failed transactions
✅ Keep some POL tokens - you need them for gas fees on every transaction
✅ Double-check the amount - transactions can't be reversed
Need Help?
Still having trouble with donations? Contact our support team by sending an email to [email protected] with:
- Your wallet address
- Screenshot of any error messages
- Which step you're stuck on
- The campaign you're trying to donate to
Remember: The two-popup process is a security feature, not a bug. It protects both you and the campaign creators.