@ucash/svelte

Svelte components and helpers for U.CASH Pay: a <UcashPayButton> (pure client-side) plus a server-side checkout helper. Non-custodial.

Install

npm install @ucash/svelte

The button (client-side)

<script>
  import { UcashPayButton } from '@ucash/svelte';
</script>

<UcashPayButton
  cloud="st_your_store_cloud_token"
  amount={10}
  currency="USD"
  title="Pro plan"
  externalReference="order_123"
  redirectUrl="https://yoursite.com/thanks"
/>

Opens the hosted U.CASH Pay checkout, where the customer pays with crypto or card. No server call required.

Server-side checkout (transaction-tracked)

import { createUcashCheckout } from '@ucash/svelte';

const r = await createUcashCheckout({
  cloud: process.env.UCASH_CLOUD_TOKEN!,
  amount: '10.00',
  currency: 'USD',
  externalReference: orderId,
  redirectUrl: 'https://yoursite.com/thanks',
});
// redirect the browser to r.payment_url

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) and, for webhooks, the Store Webhook Secret. Use the store-level token, not the account-wide one.
5. Set the webhook URL (server-side checkout): paste your webhook endpoint into the store's Store Webhook URL field, save, then Test Webhook.

License

MIT.