Phoenix.lol — Solana (SOL) Payment Gateway for Invision Community

Accept native SOL payments directly on your IPS-powered forum or marketplace — no third-party processors, no middlemen, no KYC. Funds go straight to your wallet.

Overview

This module integrates Solana as a payment method inside Invision Community's Nexus commerce system. When a customer checks out, they are shown a dedicated payment page with the exact SOL amount, a scannable QR code, and a live confirmation tracker. The order is marked as paid automatically once the required number of on-chain confirmations is reached.

How it works

1. Customer selects Solana (SOL) at checkout.
2. The gateway converts the invoice total to SOL in real time using live market data from Binance or CoinGecko.
3. The customer is redirected to a clean payment page showing the exact amount, wallet address, and QR code.
4. The gateway polls the official Solana JSON-RPC (api.mainnet-beta.solana.com) every few seconds.
5. The moment a matching transfer is detected, a live confirmation progress bar appears.
6. Once the configured number of slot confirmations is reached, the order and invoice are marked as Paid automatically and the customer is redirected.

No webhooks. No external payment processors. No API keys required.

Features

Blockchain & verification

• Uses the official Solana mainnet JSON-RPC — free, no API key needed
• Detects payments via getSignaturesForAddress + getTransaction balance delta analysis
• Tracks confirmation status: processed → confirmed → finalized
• Accepts payments up to 1% below the invoiced amount to account for exchange rounding
• Searches transactions up to (timeout + 60) minutes back, so late senders from exchanges are still detected

Live payment page

• Real-time progress bar showing slot confirmations out of the required threshold
• Animated confirmation counter with stage-aware icons and status badges
• Countdown timer with color-coded urgency (green → amber → red)
• One-click copy for the wallet address
• QR code compatible with Phantom, Solflare, and any Solana-native wallet app
• Direct link to Solscan for transaction verification
• Fully responsive — works on mobile and desktop

Admin controls (ACP)

• Wallet address with base58 format validation
• Configurable confirmation threshold (default: 32 slots ≈ 13 seconds)
• Payment timeout window: 10 minutes to 24 hours
• Exchange rate source: Binance or CoinGecko (with 5-minute cache)
• Optional custom RPC endpoint for dedicated nodes or premium providers (Helius, QuickNode, etc.)
• Debug endpoint (?debug=1) for live RPC inspection without touching orders

Currency support

• Accepts any IPS store currency — USD, EUR, GBP, RUB, and more
• Two-step conversion: fiat → USD → SOL at live market rates
• Rate cached for 5 minutes to reduce external API calls

Requirements

• Invision Community 4.x with Nexus (Commerce) installed
• PHP 7.4 or higher
• Outbound HTTPS access to api.mainnet-beta.solana.com from your server
• A Solana wallet address you control

Installation

1. Download the .tar archive.
2. In your ACP go to System → Applications → Upload Application.
3. Upload the archive and follow the on-screen steps.
4. Go to Commerce → Payments → Payment Methods → Add Method, select Solana (SOL), and enter your wallet address.
5. Save. The payment method is now live at checkout.

Configuration tips

Security notes

• Each payment page URL is protected by an HMAC-style hash tied to the transaction ID and your site's unique key — it cannot be guessed or replayed.
• The gateway never stores private keys or seeds. It is read-only: it only queries the public blockchain.
• Expired payment windows are automatically closed and the transaction is marked as refused.