Solana Payment Integration for High-Volume Marketplaces

We help businesses with Solana payment integration for high-volume marketplaces, enabling fast, low-fee crypto payments. Solana Pay is the key tool, but its integration requires understanding transaction mechanics, finality, and security. Let's dive into a real project: setting up a Solana payment gateway for a marketplace with over $50,000 monthly turnover. Since 2019, we have integrated Solana Pay for 30+ projects, gaining experience in high-load systems.

If you want to accept Solana on your website, the specificity of Solana payments is that there is no native "payment request" standard like BIP-21 (Bitcoin) or EIP-681 (Ethereum). Instead, there is Solana Pay — an open protocol developed by Solana Labs that covers most payment use cases: simple SOL transfers, SPL token payments, and transactional requests with arbitrary backend logic.

How Solana Pay Works

Solana Pay uses the solana: URL scheme encoded in a QR code. The wallet recognizes the URL and shows the user details: recipient, amount, token. For integration, you only need to generate such a URL on the backend and display the QR. Payment verification is done by searching for a reference public key in the blockchain.

Solana Pay: Transfer Request

The simplest scenario is a request to transfer a fixed amount of SOL or SPL token. The URL scheme:

solana:<recipient>?amount=<value>&label=<label>&message=<message>&memo=<memo> 

Example for paying 10 USDC:

solana:7Np41RSSZFkBmBUkVBntbRMzEnbZBqVkjFEf3BQnkGTi?amount=10&spl-token=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&label=MyShop&message=Order%20%2312345&memo=ORDER-12345 

spl-token is the mint address of USDC on mainnet. memo is an arbitrary string recorded on-chain via the Memo program, used for order reconciliation.

This URL is encoded into a QR code. Wallets supporting Solana Pay (Phantom, Solflare, Backpack) automatically parse it and show the payment details. The generated Solana Pay QR code is embedded in your checkout page for seamless scanning.

Generating QR on the Backend

import { encodeURL, createQR, TransferRequestURLFields, } from "@solana/pay"; import { PublicKey } from "@solana/web3.js"; import BigNumber from "bignumber.js"; function createPaymentRequest(orderId: string, amountUSDC: number) { const recipient = new PublicKey("YOUR_MERCHANT_WALLET"); const splToken = new PublicKey("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"); const urlFields: TransferRequestURLFields = { recipient, amount: new BigNumber(amountUSDC), splToken, label: "MyShop", message: `Order #${orderId}`, memo: orderId, }; const url = encodeURL(urlFields); const qrCode = createQR(url, 360, "transparent"); return { url: url.toString(), qrCode }; } 

Payment Verification

After displaying the QR, you need to confirm payment. The Solana Pay API (SDK) provides findReference — a function to search for a transaction by reference public key (a unique key added to each payment):

import { findReference, validateTransfer } from "@solana/pay"; import { Connection, clusterApiUrl, Keypair } from "@solana/web3.js"; const connection = new Connection(clusterApiUrl("mainnet-beta"), "confirmed"); // reference — unique keypair for each order const reference = Keypair.generate().publicKey; // Polling every 2 seconds async function pollForPayment(reference: PublicKey, expectedAmount: BigNumber) { while (true) { try { const signatureInfo = await findReference(connection, reference, { finality: "confirmed", }); await validateTransfer(connection, signatureInfo.signature, { recipient: MERCHANT_WALLET, amount: expectedAmount, splToken: USDC_MINT, reference, }); return signatureInfo.signature; // payment confirmed } catch (e) { // FindReferenceError — transaction not yet seen await new Promise((r) => setTimeout(r, 2000)); } } } 

validateTransfer checks: correct recipient, correct amount, correct token. If anything mismatches, it throws an exception. This protects against paying with a "similar" transaction.

Why Solana Suits Merchants?

Transactions confirm in 2–3 seconds, with fees around $0.00025. This makes Solana ideal for micro-payments and high-load systems like NFT marketplaces or gaming platforms. With proper configuration, failures are nearly eliminated. Solana crypto payments for business are fast and cheap. Solana Pay supports SPL token payments for a variety of digital assets. Compared to traditional bank gateways, Solana Pay integrates 5 times faster and saves up to 95% on fees. As a Solana merchant, you can leverage the Solana Pay API for efficient transaction processing.

Choosing the Right Finality Level

Solana does not have probabilistic finality like Bitcoin. Here are the levels: