---
title: Commerce Kit
description: 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:

```tsx
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](/docs/tools/commerce-kit/quickstart/payment-button)** -
Learn more about the PaymentButton

**[→ Quick Start Guides](/docs/tools/commerce-kit/quickstart/installation)** -
Get up and running

## Installation

Choose the Commerce Kit packages you need:

```bash
# 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:

- **[Quick Start Guides](/docs/tools/commerce-kit/quickstart/installation)** -
  Get up and running quickly

## Community & Support

- **Questions?** Ask on
  [Solana Stack Exchange](https://solana.stackexchange.com/) (use the
  `commerce-kit` tag)
- **Issues?** Report on
  [GitHub Issues](https://github.com/solana-foundation/commerce-kit/issues)

## Source

- [GitHub Repository](https://github.com/solana-foundation/commerce-kit)

Built and maintained by the [Solana Foundation](https://solana.org).

Licensed under MIT.