Installation

@firma/pay is a React library for accepting Firma stablecoin payments on any website. It ships a checkout widget, EMPP encoding utilities, and Chronik payment watching.

Requirements

• React 18 or later
• Any valid ecash: address or your Firma username
• Node.js 18+ for bundlers that support WASM (Next.js, Vite, etc.)

Install

pnpm add @firma/pay

npm install @firma/pay

yarn add @firma/pay

Import the stylesheet

Firma Pay components rely on bundled CSS. Import it once in your app entry or the page that renders the widget:

import '@firma/pay/firma-pay.css';

Import the component

import { PayWithFirma } from '@firma/pay';

Continue to the Quick Start guide to render your first checkout, or see Next.js for App Router specifics.