@ucash/vue

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

Install

npm install @ucash/vue

The button (client-side)

<script setup lang="ts">
import { UcashPayButton } from '@ucash/vue';
</script>

<template>
  <UcashPayButton
    cloud="st_your_store_cloud_token"
    :amount="10"
    currency="USD"
    title="Pro plan"
    external-reference="order_123"
    redirect-url="https://yoursite.com/thanks"
  />
</template>

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/vue';

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.