Docs

Technical Documentation

A comprehensive reference for StackPay's current MVP — covering on-chain invoice flows, payment surfaces, contract architecture, API routes, and the notification and settlement pipeline.

StackPay is a chain-first payment product built on Stacks. The current MVP covers merchant onboarding, invoice creation, reusable payment links, hosted customer checkout, PDF receipts, in-app notifications, and manual settlement — all running against real contracts on testnet.

The product is structured around three distinct payment surfaces: Standard invoices for single-use payment requests, MultiPay for reusable product-style routes, and Universal QR for open-ended public payments where the customer determines the amount. Each surface creates verifiable on-chain records while the merchant-facing layer remains in Supabase.

Supported assets
sBTC · STX · USDCx
Checkout modes
Standard · MultiPay · Universal QR
Notifications
Chainhook-powered · In-app
Settlement
Manual withdrawal · MVP
Architectural separation
Clarity contracts hold payment truth — invoice IDs, payment state, receipt IDs, and settlement execution. Supabase stores the merchant-facing product layer — profiles, dashboard records, notifications, and operational metadata. The Next.js application coordinates both sides through route handlers, hosted pages, wallet orchestration, and Chainhook webhook ingestion.