@ucash/react

React components and helpers for U.CASH Pay. A drop-in "Pay with U.CASH" button (pure client-side) plus a server-side checkout helper. Non-custodial: funds settle to addresses you control.

Install

npm install @ucash/react

The button (client-side)

import { UcashPayButton } from '@ucash/react';

export function Buy() {
  return (
    <UcashPayButton
      cloud="st_your_store_cloud_token"   // publishable, safe in the browser
      amount={10}
      currency="USD"
      title="Pro plan"
      externalReference="order_123"
      redirectUrl="https://yoursite.com/thanks"
    />
  );
}

The button opens the hosted U.CASH Pay checkout (pay.u.cash/embed.php?…), where the customer pays with crypto or card. No server call required.

Server-side checkout (transaction-tracked)

For a checkout tied to an order (and to receive settlement webhooks), create the transaction server-side and redirect:

// app/api/checkout/route.ts (Next.js)
import { createUcashCheckout } from '@ucash/react';

export async function POST(req: Request) {
  const { orderId, amount } = await req.json();
  const r = await createUcashCheckout({
    cloud: process.env.UCASH_CLOUD_TOKEN!,       // store token, keep server-side
    amount,
    currency: 'USD',
    externalReference: orderId,
    redirectUrl: 'https://yoursite.com/thanks',
  });
  if (!r.ok) return Response.json({ error: r.message }, { status: 500 });
  return Response.json({ url: r.payment_url, id: r.transaction_id });
}

Set up your pay.u.cash account

1. Sign up at pay.u.cash with email + password, then click the verification link in the email.
2. Set your receive addresses under Settings -> Addresses (a wallet per coin, or ENS/Unstoppable/FIO names). Crypto settles here.
3. Create a store at Account -> Stores -> + Add Store.
4. Copy the Store Cloud Token (publishable, used by the button / server helper) and, for webhooks, the Store Webhook Secret. Use the store-level token, not the account-wide one.
5. Set the webhook URL (if using server-side checkout): paste your webhook endpoint into the store's Store Webhook URL field, save, then Test Webhook.

Verifying webhooks

This package ships a button + checkout helper. To verify settlement webhooks (HMAC-SHA256 over t.raw_body, 300s window), use the same algorithm in the n8n / Zapier nodes, or ask for a verifyWebhook helper here.

License

MIT.