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
-
Enter donation amount on the campaign page
-
Click "Donate" button
-
First popup appears - Click "Confirm" to approve token access
-
Wait a few seconds for the approval to process
-
Second popup appears - Click "Confirm" to send your donation
-
Wait for confirmation - You'll see a success message
Total time: Usually 5 to 10 seconds
Gas Fee Settings
When each popup appears:
-
Look for gas fee options (usually shows "Market" by default)
-
Click "Market" to see other options
-
Select "Aggressive" for fastest processing
-
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.