Documentation
Everything about PumpPay
PumpPay lets you send any pump.fun token straight to an X @username, no wallet address needed. The recipient verifies their X account, adds a Solana wallet, and the tokens land in it.
Overview
PumpPay is a social gifting layer for Solana. Instead of asking someone for a 44-character wallet address, you send tokens to the handle you already know them by. Gifts are public, shareable moments a way to onboard friends into a community through ownership instead of ads.
It is not an exchange and not a trading venue. PumpPay never quotes prices, never routes swaps and never takes custody of anything beyond the gift itself while it waits to be claimed.
No address needed
Send to @handle. The recipient supplies a wallet later.
Escrowed until claimed
Tokens sit in a program-controlled escrow wallet.
Public by default
Every gift gets a shareable claim link and appears in Activity.
How it works
- Connect a wallet. PumpPay reads the SPL and Token-2022 balances of the connected wallet and shows only tokens you actually hold.
- Pick a token, amount and X handle. Add an optional note it shows up on the gift card and the claim page.
- Sign one transfer. The tokens move from your wallet into the PumpPay escrow wallet. Nothing else is signed.
- The recipient verifies X. They sign in with X; PumpPay checks the handle matches the one on the gift exactly.
- They add a Solana wallet. Escrow releases the exact gift amount to that address on-chain and the gift is marked claimed.
Sending a gift
Sending requires a connected Solana wallet (Phantom, Solflare, Backpack and any other wallet-standard wallet). Token selection is intentionally gated behind connection, PumpPay does not present a catalog of tokens to buy, only what is already in your balance.
You need a small amount of SOL for network fees, and the escrow may need a rent-exempt token account for a mint it has never held before. Both are ordinary Solana costs, not PumpPay charges.
After signing you get a claim link. Share it with the recipient or just tag them, the gift is discoverable from the Activity feed by handle either way.
Claiming a gift
Anyone can open a claim link, but only the X account named on the gift can claim it. Verification uses X OAuth 2.0 with PKCE and requests the minimum scope needed to read your username, PumpPay cannot post, follow, read DMs or see your email.
If you sign in with the wrong account, the claim page says so and offers to re-verify as the correct handle. Once verified, paste or connect a Solana address; the release transaction is submitted by the escrow and the resulting signature is shown so you can confirm it on Solscan.
Claims are idempotent: repeated attempts on the same gift cannot release funds twice, and a gift can only ever be in one of held, claimed or refunded states.
Escrow & custody
Between sending and claiming, tokens live in a single app-controlled escrow wallet on Solana mainnet. The escrow keypair lives only on the server; it is never exposed to the browser, and every release is authorized by a server function after handle verification succeeds.
Every deposit and release is an ordinary on-chain transfer, so the escrow's full history is publicly auditable. Balances, held vs. released totals and current holdings are summarized on the escrow transparency view.
Unclaimed gifts stay held indefinitely and can be refunded to the original sender's wallet, nothing expires into PumpPay's pocket.
Tokens & data
Token metadata, name, symbol, logo, decimals and price, is pulled live from pump.fun and Jupiter and cached server-side so pages stay fast. If a token has no logo published upstream, PumpPay falls back to a generated ticker mark.
Trending on PumpPay is native: rankings are driven by how many gifts a token has received on PumpPay, not by market cap or volume elsewhere. The same is true for the leaderboards, top tokens, top gifters and most-gifted accounts all come from PumpPay activity.
Fees & limits
- Solana network fees apply to the send and to the escrow release.
- A one-time rent-exempt deposit may be needed to open a token account for a new mint.
- Gifts are limited to what your wallet actually holds, there is no credit, lending or leverage.
- Any PumpPay fee, if enabled, is shown before you sign. Nothing is ever charged silently.
Security
- PumpPay never asks for your seed phrase or private key.
- The only thing you sign is a token transfer to the escrow address.
- Gift and handle records are not publicly readable from the database; all reads go through server functions.
- X sessions are signed server-side and scoped to reading your username only.
- Wallets may warn on shared preview domains. Use the published PumpPay domain for transactions and always confirm the escrow address before signing.
FAQ
What if the recipient never claims?
The gift stays in escrow. It can be refunded to the sending wallet at any time.
Can I send to someone who has no wallet at all?
Yes, that's the point. They only need a wallet at claim time, and creating one takes a minute.
Can someone impersonate a handle to steal a gift?
No. Claiming requires signing in to that exact X account through X itself; PumpPay compares the verified username against the gift.
Does PumpPay support non-pump.fun tokens?
Any SPL or Token-2022 token in your wallet can be sent. Metadata is richest for pump.fun tokens.
Can I change the recipient after sending?
No. A gift is bound to the handle at send time. Refund it and send a new one instead.
Ready to gift?
Connect your wallet and send a token to any X @username.