solana-pay

Solana Pay ⚡

Decentralized payment protocol built on Solana. Instant, near-zero fee payments.

Environment Variables

Variable	Description	Required
SOLANA_KEYPAIR_PATH	Path to merchant wallet keypair	Yes
SOLANA_RPC_URL	Custom RPC endpoint	No
MERCHANT_NAME	Display name for payments	No

Features

• 💸 Instant Payments - Sub-second finality (~400ms)
• 🆓 Near-Zero Fees - ~$0.00025 per transaction
• 🔗 QR Code Payments - Generate scannable payment requests
• 🛒 Point of Sale - Merchant integrations
• 📱 Wallet Support - Phantom, Solflare, Backpack

Payment URL Specification

Solana Pay uses a URL scheme for payment requests:

solana:<recipient>?amount=<amount>&spl-token=<mint>&reference=<reference>&label=<label>&message=<message>&memo=<memo>

Generate Payment Request (SOL)

RECIPIENT=$(solana address --keypair "$SOLANA_KEYPAIR_PATH")
AMOUNT="1.5"
REFERENCE=$(solana-keygen new --no-bip39-passphrase --silent --outfile /dev/stdout | head -1)
LABEL="My Store"
MESSAGE="Order #12345"

# Build Solana Pay URL
PAY_URL="solana:${RECIPIENT}?amount=${AMOUNT}&reference=${REFERENCE}&label=${LABEL}&message=${MESSAGE}"

echo "Payment URL: $PAY_URL"

# Generate QR code (requires qrencode)
echo "$PAY_URL" | qrencode -o payment_qr.png -s 10
echo "QR code saved to payment_qr.png"

Generate Payment Request (SPL Token)

RECIPIENT=$(solana address --keypair "$SOLANA_KEYPAIR_PATH")
AMOUNT="100"
SPL_TOKEN="EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"  # USDC
REFERENCE=$(openssl rand -hex 32)
LABEL="My Store"
MESSAGE="Order #12345"

# Build Solana Pay URL with SPL token
PAY_URL="solana:${RECIPIENT}?amount=${AMOUNT}&spl-token=${SPL_TOKEN}&reference=${REFERENCE}&label=${LABEL}&message=${MESSAGE}"

echo "Payment URL: $PAY_URL"
echo "$PAY_URL" | qrencode -o payment_qr.png -s 10

Common Token Addresses

Token	Mint Address
USDC	EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
USDT	Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB
BONK	DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263
JUP	JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN