Skip to main content

MetaMask Wallet Setup

Set up a MetaMask wallet to test payments on Ethereum-based networks in the WickiePay sandbox.

Install MetaMask​

  1. Visit metamask.io and install the browser extension
  2. Create a new wallet and save your recovery phrase securely
  3. MetaMask will default to Ethereum Mainnet

Switch to Sepolia Testnet​

  1. Open MetaMask
  2. Click the network dropdown (top left)
  3. Enable Show test networks in Settings > Advanced
  4. Select Sepolia from the network list

Get Test ETH​

You need test ETH for gas fees:

  1. Copy your MetaMask wallet address
  2. Visit a Sepolia faucet (search for "Sepolia faucet")
  3. Request test ETH to your address
  4. Wait for the transaction to confirm

Add Test USDC (ERC20)​

To test USDC payments:

  1. In MetaMask, click Import tokens
  2. Select Custom token
  3. Enter the Sepolia USDC contract address (provided in your sandbox portal)
  4. Token symbol and decimals will auto-populate
  5. Click Add custom token

Get Test USDC​

  1. Use the WickiePay sandbox portal to request test USDC
  2. Or use the sandbox faucet provided by your account manager
  3. Tokens will appear in your MetaMask wallet

Test a Payment​

  1. Create a Payment In via the sandbox API
  2. Copy the payment address from the API response
  3. In MetaMask, click Send
  4. Paste the payment address
  5. Enter the required amount of USDC
  6. Confirm the transaction
  7. Monitor the payment status via API or webhook

Adding USDT (ERC20)​

Follow the same steps as USDC, using the USDT contract address from your sandbox portal.

Troubleshooting​

IssueSolution
Transaction pendingEnsure you have enough test ETH for gas
Token not showingVerify the correct contract address was imported
Wrong networkConfirm MetaMask is on Sepolia, not Mainnet

Next Steps​