Documentation

AUPAY Project Documentation

AUPAY is a Solana-native payment gateway project that combines a public-facing landing page and an operational dApp dashboard. The platform is designed to convert invoice workflows into programmable payment requests with real-time status updates, wallet integration, and receipt operations.

Vision

The core thesis of AUPAY is simple: payment operations should be event-driven, auditable, and automation-friendly. Instead of treating invoices as static files, AUPAY treats them as executable payment flows that can be tracked through a deterministic lifecycle.

Architecture

Landing Layer

Branded marketing page with CTA buttons, ecosystem links, and narrative sections.

dApp Layer

Operational dashboard for URL building, scan flows, wallet connection, and payment activity.

Solana Pay Rail

Standardized Solana payment URL format used for wallet checkout and deterministic reference matching.

Operations Layer

Simulated webhook console, receipt generation, and transaction table for operational visibility.

Quickstart

npm install
npm run dev
# landing: http://localhost:3000
# dashboard: http://localhost:3000/dapps
# docs: http://localhost:3000/docs

Landing Experience

The landing page communicates positioning and conversion paths: launch dashboard, buy token narrative path, and social onboarding. Header and CTAs are designed for quick routing into operational flows.

dApp Dashboard

Dashboard capabilities currently include payment request generation, QR rendering, live-like payment simulation, transaction listing, receipt utilities, and wallet controls.

Solana Pay Schema

AUPAY uses a standards-aligned Solana payment URL with optional parameters for amount, token mint, references, labeling, and memo metadata.

solana:<RECIPIENT_ADDRESS>?amount=125.00&spl-token=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&reference=AUPAY-REFERENCE&label=AUPAY%20Merchant&message=Payment%20for%20automated%20invoice&memo=INV-2026-001

Wallet Integration

Phantom wallet connection is available on the dashboard header. If Phantom is not installed, the flow prompts installation. Connected state shows a short wallet address with disconnect support.

Scan Modes

Receive (QR)

Displays generated QR from current Solana Pay request for incoming payment collection.

Scan to Pay

Uses camera scanning to decode external Solana Pay QR and opens payment links for outgoing sends.

Receipt Operations

Receipt utilities include in-browser print-to-PDF and one-click Gmail compose generation for selected transaction records.

Security Notes

Validate recipient addresses before payment submission.
Validate token mint values against approved allowlists.
Store references and memos in immutable audit logs in production.
Use backend verification for real on-chain payment confirmations.

Deployment

This project is built with Next.js App Router and can be deployed to Vercel or a custom Node runtime. Environment-specific wallet and RPC behavior should be configured before production rollout.

Roadmap

Near Term

Real RPC listeners, deterministic invoice matching service, and persistent transaction storage.

Mid Term

Merchant settings, role-based access, webhook signing, and advanced settlement analytics.

FAQ

Is AUPAY production-ready?

Current implementation is a strong prototype and product narrative. For production, add backend verification, secure key management, and persistent infrastructure.

Can I accept SOL and USDC?

Yes. The dashboard supports SOL and USDC request generation. USDC uses the configured token mint in URL parameters.