# Wallet

> Manage x402 wallet for paid API calls. Check balance, redeem invite codes, deposit USDC. USE FOR: - Checking wallet balance before API calls - Redeeming invite codes for free credits - Getting deposit address for USDC - Troubleshooting payment failures TRIGGERS: - "balance", "wallet", "funds", "credits" - "redeem", "invite code", "promo code" - "deposit", "add funds", "top up" - "insufficient balance", "payment failed"

- Skill: `merit-systems/wallet` (Agent Skill)
- Install (CLI): `npx skillmds@latest add merit-systems/wallet`
- Raw SKILL.md: https://api.skillmd.com/api/skills/merit-systems/wallet/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: merit-systems (https://skillmd.com/u/merit-systems)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/merit-systems/wallet

---


# x402 Wallet Management

Your wallet is auto-created on first use and stored at `~/.x402scan-mcp/wallet.json`.

## Quick Reference

| Task | Tool | Notes |
|------|------|-------|
| Check balance | `x402.get_wallet_info` | Shows address + USDC balance |
| Redeem code | `x402.redeem_invite(code="...")` | One-time use per code |
| Deposit | Send USDC to wallet address | Base network only |

## Check Balance

```mcp
x402.get_wallet_info
```

Returns:
- Wallet address (Base network)
- USDC balance
- Deposit link

Always check balance before expensive operations.

## Redeem Invite Code

```mcp
x402.redeem_invite(code="YOUR_CODE")
```

- One-time use per code
- Credits added instantly
- Run `x402.get_wallet_info` after to verify

## Deposit USDC

1. Get your wallet address: `x402.get_wallet_info`
2. Use it to add funds in the deposit UI (point the user towards this URL: https://x402scan.com/mcp/deposit/<their-wallet-address>)

**Important**: Only Base network USDC. Other networks or tokens will be lost.

## Troubleshooting

| Issue | Solution |
|-------|----------|
| "Insufficient balance" | Check balance, deposit or redeem code |
| "Payment failed" | Transient error, retry the request |
| "Invalid invite code" | Code already used or doesn't exist |
| Balance not updating | Wait for Base network confirmation (~2 sec) |