Instalasi

Mulai dengan Solana Pay dengan menginstal JavaScript SDK dan menyiapkan lingkungan pengembangan Anda. SDK ini bersifat framework-agnostic dan bekerja dengan lingkungan JavaScript apa pun.

Persyaratan Sistem

Node.js: Versi 20 atau lebih tinggi (diperlukan untuk dukungan crypto.subtle)
Package Manager: pnpm, npm, atau yarn
TypeScript: Versi 5+ (direkomendasikan tetapi tidak wajib)

Instal Solana Pay SDK

Pilih package manager pilihan Anda:

# Using pnpm (recommended)
pnpm add @solana/pay@beta @solana/kit

# Using npm
npm install @solana/pay@beta @solana/kit

# Using yarn
yarn add @solana/pay@beta @solana/kit

Peer Dependencies

Berikut adalah peer dependencies dari @solana/pay dan harus diinstal bersamanya:

Paket	Versi
`@solana/kit`	`^6.5.0`

Optional Dependencies

Untuk pembuatan dan validasi transfer (transfer SOL dan token SPL), instal juga:

pnpm add @solana-program/system @solana-program/token @solana-program/token-2022 @solana-program/memo

Untuk client factories (createMerchantClient, createWalletClient), instal juga kit plugins:

pnpm add @solana/kit-plugin-rpc @solana/kit-plugin-payer @solana/kit-plugin-instruction-plan

Konfigurasi TypeScript

Jika menggunakan TypeScript, pastikan tsconfig.json Anda mencakup:

{
  "compilerOptions": {
    "module": "ESNext",
    "target": "ES2022",
    "lib": ["ES2022", "DOM", "DOM.Iterable"],
    "moduleResolution": "bundler",
    "resolveJsonModule": true,
    "esModuleInterop": true,
    "skipLibCheck": true
  }
}

Pengaturan Lingkungan

Lingkungan Pengembangan

Siapkan variabel lingkungan untuk pengembangan:

# .env.local
SOLANA_RPC_URL=https://api.devnet.solana.com
SOLANA_NETWORK=devnet

Lingkungan Produksi

Untuk produksi, gunakan endpoint mainnet:

# .env.production
SOLANA_RPC_URL=https://api.mainnet-beta.solana.com
SOLANA_NETWORK=mainnet-beta

Verifikasi Instalasi

Buat tes sederhana untuk memverifikasi bahwa semuanya berfungsi:

// test-installation.ts
import { address } from "@solana/kit";
import { encodeURL } from "@solana/pay";

// Test creating a payment URL
const recipient = address("FvJ8k8HhXp4a3zQyFMZd4FvEqcYdYE7gSZWxrEBRfBsB");

const url = encodeURL({
  recipient,
  amount: 0.01,
  label: "Test Store",
  message: "Test payment"
});

console.log("Solana Pay URL:", url.toString());
// Output: solana:FvJ8k8Hh...?amount=0.01&label=Test%20Store&message=Test%20payment

Jalankan tes:

npx tsx test-installation.ts

Anda akan melihat URL Solana Pay yang valid di konsol.

Masalah Umum dan Solusinya

Kesalahan Resolusi Modul

Jika Anda melihat kesalahan seperti "Cannot resolve module '@solana/pay'":

Bersihkan cache package manager Anda:

# pnpm
pnpm store prune

# npm
npm cache clean --force

# yarn
yarn cache clean

Hapus node_modules dan instal ulang:
```
rm -rf node_modules
pnpm install
```

Kesalahan TypeScript

Jika Anda mengalami kesalahan TypeScript:

Perbarui ke versi TypeScript terbaru (5+)
Pastikan moduleResolution diatur ke "bundler" atau "nodenext" di tsconfig.json Anda

Langkah Selanjutnya

Setelah Anda menginstal Solana Pay, pilih jalur integrasi Anda:

Transfer Requests - URL pembayaran sederhana untuk transfer dasar
Transaction Requests - Alur pembayaran interaktif
QR Code Integration - Buat kode QR untuk pembayaran mobile

Alat Pengembangan

Pertimbangkan untuk menginstal alat pengembangan yang berguna ini:

# Solana CLI (for testing and key generation)
sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"

# Local validator for testing
solana-test-validator

Sumber Daya

GitHub Repository - Kode sumber dan contoh
Solana Cookbook - Resep pengembangan Solana

Daftar Isi