Token Recovery
Recover tokens that were accidentally sent using the wrong token or on the wrong blockchain network.
Overview
MakaPay's Token Recovery feature allows merchants to recover funds when customers make payment mistakes, such as:
Wrong Token: Customer sends USDC instead of USDT (or vice versa)
Wrong Chain: Customer sends tokens on Ethereum when payment was expected on Polygon
Custom Tokens: Recovery of unsupported tokens sent to payment addresses
The recovery process is self-service through the dashboard and typically completes within a few minutes.
Prerequisites
Before using token recovery:
Gas Tank Balance: You need at least 0.10 USDT in your Gas Tank to cover recovery fees
Payment Status: The payment must exist in your dashboard (any status)
Token Balance: Tokens must be present at the payment address
Step-by-Step Recovery Process
Step 1: Navigate to the Payment
Go to Dashboard > Payments
Find the payment with the wrong token/chain issue
Click on the payment to view details
Step 2: Open Token Recovery
In the payment details, click the "Recover Tokens" button
The Token Recovery modal will open
The system automatically scans all supported chains for recoverable tokens
Step 3: Review Found Tokens
The system checks for tokens across all supported networks:
Ethereum (Mainnet)
Polygon (MATIC)
BNB Smart Chain (BSC)
MakaChain
For each chain, supported tokens are scanned:
USDT
USDC
Results are grouped by chain:
"Original" badge: Tokens on the payment's intended chain
"Wrong Chain" badge: Tokens sent on a different network
Step 4: Recover Tokens
Click the chain to expand the token list
Review the token balance and address
Click "Recover" next to the token you want to recover
Wait for the transaction to complete (usually 1-3 minutes)
Success message will show the recovered amount
Step 5: Verify Recovery
Recovered tokens are sent directly to your merchant wallet address
The recovery modal will refresh to show updated balances
Check your wallet to confirm receipt
Recovery Fees
Token recovery uses your Gas Tank balance to pay for blockchain transaction fees:
MakaChain
~$0.01
Polygon
~$0.01 - $0.05
BSC
~$0.05 - $0.10
Ethereum
~$0.50 - $5.00 (varies with gas prices)
Important:
Minimum Gas Tank balance required: $0.10 USDT
Merchant receives 100% of recovered tokens (no platform fee)
Only the blockchain gas fee is deducted from your Gas Tank
Custom Token Recovery
If a customer sent an unsupported token (not USDT or USDC):
Open the Token Recovery modal
Scroll to "Custom token address" section
Enter the token's contract address (e.g.,
0x...)Click the search icon to check the balance
If tokens are found, proceed with recovery
Note: Custom token recovery only works if the token is a standard ERC-20 token.
Cross-Chain Recovery (Wrong Network)
This is the most common recovery scenario. Example:
Customer was supposed to send USDT on Polygon, but sent USDT on Ethereum instead.
How It Works
MakaPay uses CREATE2 deterministic addresses - the same payment address exists on all EVM-compatible chains
The Token Recovery feature scans all chains for the same address
You can recover tokens from any supported chain, regardless of the original payment network
Recovery Process
Open Token Recovery for the payment
Look for chains with the "Wrong Chain" badge
Expand the chain to see token balances
Click "Recover" to process the recovery
Tokens are transferred to your merchant address on that chain
Troubleshooting
"Insufficient Gas Tank Balance"
Problem: Your Gas Tank balance is below the minimum required.
Solution:
Go to Dashboard > Gas Tank
Deposit at least $0.10 USDT
Wait for deposit confirmation
Retry the recovery
"No tokens found"
Problem: The scan shows no recoverable tokens.
Possible causes:
Tokens haven't arrived yet (check block explorer)
Tokens were already recovered
Token is not supported (try custom token address)
Solution:
Verify the transaction on a block explorer (Etherscan, Polygonscan, etc.)
Confirm the destination address matches the payment address
Try the custom token input if using a non-standard token
"Transaction Failed"
Problem: Recovery transaction reverted on-chain.
Possible causes:
Network congestion
Insufficient token balance
Smart contract issue
Solution:
Wait a few minutes and try again
Check if the token balance is still present
Contact support if the issue persists
"Transaction Pending"
Problem: Recovery is taking longer than expected.
Cause: Network congestion or slow block times.
Solution:
Do NOT retry immediately (may cause duplicate transactions)
Check your transaction history for pending transactions
Wait for confirmation (can take 5-15 minutes on Ethereum during congestion)
Frequently Asked Questions
Can I recover any token?
You can recover:
Automatically detected: USDT, USDC on all supported chains
Custom tokens: Any ERC-20 compatible token using the custom address field
Is there a fee for recovery?
Platform fee: None (merchant receives 100%)
Gas fee: Paid from your Gas Tank (varies by network)
How long does recovery take?
MakaChain
1-5 seconds
Polygon
30 seconds - 2 minutes
BSC
30 seconds - 2 minutes
Ethereum
1-5 minutes
Can I recover tokens from an expired payment?
Yes, token recovery works regardless of payment status (pending, expired, completed, etc.).
What if I sent tokens to the wrong MakaPay address?
Token recovery only works for the specific payment address. If tokens were sent to a different payment address:
Find the correct payment in your dashboard
Use Token Recovery on that payment instead
Can I recover native tokens (ETH, MATIC, BNB)?
Currently, only ERC-20 tokens are supported. Native token recovery is not yet available.
Support
If you encounter issues not covered in this guide:
Dashboard Chat: Click the support icon in the dashboard
Email: [email protected]
Include: Payment ID, transaction hash, and error message
Last updated