Ми допомагаємо бізнесу приймати платежі в Solana (SOL) та SPL-токенах з мінімальною затримкою. Solana Pay — ключовий інструмент, але його інтеграція потребує розуміння механіки транзакцій, остаточності та безпеки. Розберемо на прикладі реального проєкту: налаштування прийому USDC для маркетплейсу з оборотом понад $50 000 на місяць. Ми інтегрували Solana Pay для 30+ проєктів, накопичивши досвід у високонавантажених системах.
Специфіка Solana-платежів у тому, що тут немає нативного стандарту «платіжного запиту» рівня BIP-21 (Bitcoin) або EIP-681 (Ethereum). Натомість є Solana Pay — відкритий протокол, розроблений Solana Labs, який покриває більшість payment use cases: прості SOL-перекази, SPL-токени, транзакційні запити з довільною логікою на бекенді.
Як працює Solana Pay?
Solana Pay використовує URL-схему solana:, яка кодується в QR-код. Гаманець розпізнає URL і показує користувачеві деталі: отримувача, суму, токен. Для інтеграції достатньо згенерувати такий URL на бекенді та відобразити QR. Верифікація відбувається через пошук reference pubkey у блокчейні.
Solana Pay: Transfer Request
Найпростіший сценарій — запит на переказ фіксованої суми SOL або SPL-токена. URL-схема:
solana:<recipient>?amount=<value>&label=<label>&message=<message>&memo=<memo> Приклад для оплати 10 USDC:
solana:7Np41RSSZFkBmBUkVBntbRMzEnbZBqVkjFEf3BQnkGTi?amount=10&spl-token=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&label=MyShop&message=Order%20%2312345&memo=ORDER-12345 spl-token — mint address USDC на mainnet. memo — довільний рядок, записується в транзакцію on-chain через Memo program, використовується для reconciliation замовлень.
Цей URL кодується в QR-код. Гаманці з підтримкою Solana Pay (Phantom, Solflare, Backpack) автоматично розбирають його та показують деталі платежу.
Генерація QR на бекенді
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 }; } Верифікація платежу
Після показу QR потрібно підтвердити факт оплати. Solana Pay надає findReference — пошук транзакції по reference pubkey (унікальний ключ, що додається в кожен платіж):
import { findReference, validateTransfer } from "@solana/pay"; import { Connection, clusterApiUrl, Keypair } from "@solana/web3.js"; const connection = new Connection(clusterApiUrl("mainnet-beta"), "confirmed"); // reference — унікальний keypair для кожного замовлення const reference = Keypair.generate().publicKey; // Polling кожні 2 секунди 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; // платіж підтверджено } catch (e) { // FindReferenceError — транзакція ще не з'явилася, чекаємо await new Promise((r) => setTimeout(r, 2000)); } } } validateTransfer перевіряє: правильний recipient, правильна сума, правильний токен. Якщо щось не збігається — кидає виняток. Це захист від спроби оплатити «схожою» транзакцією.
Чому Solana підходить для мерчантів?
Транзакції підтверджуються за 2–3 секунди, комісія — близько $0.00025. Це робить Solana ідеальною для мікроплатежів та високонавантажених систем, таких як NFT-маркетплейси або ігрові платформи. При правильному налаштуванні відмови практично виключені. Порівняно з традиційними банківськими шлюзами, Solana Pay інтегрується в 5 разів швидше та економить до 95% на комісіях.
Який рівень остаточності вибрати?
Solana не має probabilistic finality як Bitcoin. Тут є рівні:
| Рівень | Час | Опис | Коли використовувати |
|---|---|---|---|
| processed | <0.5 сек | Транзакція включена в блок, можливий rollback | Не використовувати для платежів |
| confirmed | 1-3 сек | Блок отримав >66% голосів супербільшості | Основний варіант для суми до $10 000 |
| finalized | 10-15 сек | Блок у rooted частині ланцюга, rollback неможливий | Для великих сум або юридичних вимог |
Для платежів використовуйте confirmed — це баланс швидкості та безпеки.
Порівняння Solana Pay з іншими рішеннями
| Критерій | Solana Pay | Tron USDT (TRC-20) | Stripe Crypto |
|---|---|---|---|
| Швидкість підтвердження | 2-3 сек | ~1 хв | до 5 хв |
| Комісія | ~$0.00025 | $0.5-1 | ~$0.75 + 1% |
| Підтримка токенів | Будь-які SPL | USDT/USDC | BTC/ETH/USDC |
| Складність інтеграції | Низька (SDK) | Середня (API) | Середня (API) |
Процес роботи та терміни
Що входить у роботу під ключ
- Проектування архітектури: вибір RPC (Helius, QuickNode), налаштування мерчант-гаманця (hardware або multisig).
- Розробка API для генерації платіжних запитів з унікальним reference.
- Інтеграція polling або WebSocket для моніторингу підтверджень.
- Збереження signature транзакції в базі для аудиту та reconciliation.
- Обробка timeout (рекомендуємо 2 хвилини, після — показувати помилку).
- Документація та навчання команди.
Процес роботи
- Аналітика: вивчаємо бізнес-вимоги, обираємо токени та стек.
- Проектування: схема платіжного флоу, вибір RPC, налаштування безпеки.
- Реалізація: інтеграція Solana Pay, генерація QR, верифікація.
- Тестування: симуляція платежів, перевірка всіх edge cases.
- Деплой: налаштування production RPC, моніторинг, документація.
Терміни
Зазвичай інтеграція займає від 3 до 10 робочих днів залежно від складності (кількість токенів, необхідність multisig, рівень безпеки). Оцінимо ваш проєкт безкоштовно.
Як ми забезпечуємо безпеку?
Гарантуємо, що всі транзакції підписуються лише після верифікації через validateTransfer. Reference генерується для кожного замовлення, що виключає повторне використання. Мерчант-гаманець ізольований від сервера — підписуються лише транзакції підтверджених платежів.
Розкажіть про ваші завдання — наші інженери з сертифікатами Solana допоможуть налаштувати прийом платежів за 1-2 тижні. Зв'яжіться з нами для безкоштовної консультації. Замовте інтеграцію Solana Pay вже сьогодні.