@firma/pay

Drop-in React checkout for accepting Firma stablecoin payments (USD, CHF, EUR) on any website. Zero transaction fees, real-time settlement, no chargebacks.

npm: @firma/pay · Documentation: pay.firma.cash

Install

pnpm add @firma/pay

npm install @firma/pay

yarn add @firma/pay

Quick start

Import the stylesheet once, then render the checkout widget:

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

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

receiverUsername can be any valid ecash: address or your Firma username (with or without @).

Next.js (App Router)

Keep PayWithFirma in a 'use client' component and import the stylesheet:

'use client';

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

If you consume @firma/pay from a monorepo workspace package, add transpilePackages: ['@firma/pay'] in next.config.ts.

See pay.firma.cash for the full integration guide, API reference, and live demo.

Changelog

0.0.6

• Match third-party invoices when FIRMA sent to the receiver is at least the invoice amount. Self-sends (every FIRMA token input and output is the same address) require at least one output of exactly the invoice amount, so leftover change is not treated as payment.

0.0.5

• Treat an invoice as paid when FIRMA received at the receiver is at least the invoice amount (overpayment counts). This also confirms self-sends, where leftover tokens return to the same address.

0.0.4

• USD invoices and payment watching now use FIRMA instead of legacy SRO. Required after the Firma app SRO migrate cutover; current app builds reject SRO BIP21 send links.

0.0.3

• Upgrade ecash-lib to 4.13.0. Next.js integrations no longer need extra webpack configuration.

0.0.2

• Removed the showTagline prop and built-in promotional tagline. The widget is now just the checkout button and payment flow; add your own copy around it if needed.

0.0.1

• Initial release.

License

MIT