Introduction

Commerce primitives for building Solana payment experiences

Commerce Kit is a collection of tools for building commerce experiences on Solana. From drop-in payment buttons to headless primitives, Commerce Kit provides everything you need to accept crypto payments.

Why Commerce Kit?

  • Drop-in Components: Pre-built PaymentButton with wallet connection, token selection, and transaction handling
  • Framework Agnostic: Use headless primitives in any JavaScript framework
  • Solana Pay: Full Solana Pay support with QR code generation
  • Type-Safe: Complete TypeScript support across all packages
  • Wallet Standard: Compatible with all Wallet Standard wallets (Phantom, Solflare, Backpack, etc.)

Quick Start

The fastest way to get started is with the PaymentButton component:

import { PaymentButton } from '@solana-commerce/kit';

function App() {
  return (
    <PaymentButton
      config={{
        merchant: {
          name: 'My Store',
          wallet: 'your-solana-wallet-address'
        },
        mode: 'buyNow'
      }}
      onPaymentSuccess={(signature) => {
        console.log('Payment successful:', signature);
      }}
    />
  );
}

→ PaymentButton Quick Start - Learn more about the PaymentButton

→ Quick Start Guides - Get up and running

Installation

Choose the Commerce Kit packages you need:

# Unified Commerce Meta Package
pnpm add @solana-commerce/kit

# Drop-in payment button (most common)
pnpm add @solana-commerce/react

# Wallet connection only
pnpm add @solana-commerce/connector

# Headless commerce primitives
pnpm add @solana-commerce/headless

# Solana Pay QR codes
pnpm add @solana-commerce/solana-pay

# React hooks for custom UIs
pnpm add @solana-commerce/sdk

Commerce Kit is a collection of tools for building commerce experiences on Solana. From drop-in payment buttons to headless primitives, Commerce Kit provides everything you need to accept crypto payments.

Next Steps

Explore the documentation based on what you're building:

Community & Support

Source

Built and maintained by the Solana Foundation.

Licensed under MIT.