@firma/pay · npm package

The easiest way to end fees and chargebacks for your eComm business

Firma Pay is a drop-in React checkout for accepting Firma stablecoin payments. Zero transaction fees, no chargebacks, real-time confirmation — built and operated in Switzerland.

Quick Start Live Demo

0%Transaction fees

0Chargebacks

3sSettlement

3Currencies (USD, CHF, EUR)

Built for merchants who are done with card rails

Firma Pay replaces card checkout with stablecoin settlement your business actually controls — programmable, final, and fee-free at the protocol level.

End card fees

Card networks take 2–3% plus fixed fees on every sale. Firma Pay settles in Firma stablecoins with zero per-transaction platform fees.

Eliminate chargebacks

Firma payments are final on-chain settlement. No dispute windows, rolling reserves, or surprise reversals weeks after delivery.

Real-time checkout

Chronik WebSocket watches the receiver address and matches FPAY-encoded order IDs — mempool pulse, finalized checkmark, done.

Drop-in React widget

One component handles QR codes, Firma Wallet deep links, username resolution, and payment detection. Ship in minutes, not weeks.

Quick Start

Go from zero to a live checkout widget in three steps.

Install the package
```
pnpm add @firma/pay
```
or
```
npm install @firma/pay
```
or
```
yarn add @firma/pay
```
View @firma/pay on npm →

Import styles and the component

import '@firma/pay/firma-pay.css';
import { PayWithFirma } from '@firma/pay';

Render the checkout widget

<PayWithFirma
  receiverUsername="merchant"
  orderId="VP9G"
  amount="10.00"
  currency="USD"
  onPaymentFinalized={(txid) => {
    // Fulfill the order, update your DB, etc.
    console.log('Paid!', txid);
  }}
/>

Full quick start guide →

Documentation

InstallationPackage setup, peer dependencies, and stylesheet import.PayWithFirmaProps reference for the checkout component.API ReferencePackage exports, hooks, and utilities.LLMsMachine-readable docs index at /llms.txt for AI coding agents.