ucashpay-solid 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 U.CASH
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,44 @@
+# ucashpay-solid
+
+SolidJS components and helpers for [U.CASH Pay](https://pay.u.cash): a **Pay-with-U.CASH** button plus a server-side checkout helper. Accept crypto + cards. Non-custodial: funds settle direct to the merchant's wallet.
+
+## Install
+
+```bash
+npm install ucashpay-solid solid-js
+```
+
+## Client-side button (no server needed)
+
+The Cloud token is publishable, so you can render a pay link straight from the browser:
+
+```tsx
+import { UcashPayButton } from 'ucashpay-solid';
+
+export default function Buy() {
+  return <UcashPayButton cloud="YOUR_CLOUD_TOKEN" amount="10" currency="USD" title="Pro plan" />;
+}
+```
+
+Or build the URL yourself with `hostedCheckoutUrl({ cloud, amount, currency, title, externalReference, redirectUrl })`.
+
+## Server-side tracked checkout
+
+For a transaction record + webhook, create the checkout server-side:
+
+```ts
+import { createUcashCheckout } from 'ucashpay-solid';
+const r = await createUcashCheckout({ cloud: process.env.UCASH_CLOUD_TOKEN!, amount: '10', currency: 'USD', externalReference: 'order-123' });
+if (r.ok) redirect(r.payment_url);
+```
+
+## Set up your pay.u.cash account
+
+You need a free U.CASH Pay account and a store before this can accept payments. Settlement is non-custodial: crypto goes straight to addresses you control.
+
+1. **Sign up** at [pay.u.cash](https://pay.u.cash), then click the verification link in the email.
+2. **Set receive addresses** under **Settings -> Addresses** (raw address, ENS, Unstoppable Domains, or FIO).
+3. **Create a store** under **Account -> Stores** and copy its **Store Cloud Token** (use the store-level token, not the account-wide one).
+4. To also accept fiat cards, connect your own Stripe under **Settings -> Payment processors**.
+
+License: MIT.

package/dist/index.d.mts

@@ -0,0 +1,34 @@
+import { JSX } from 'solid-js';
+
+interface HostedCheckoutOptions {
+    cloud: string;
+    amount: string | number;
+    currency?: string;
+    title?: string;
+    externalReference?: string;
+    redirectUrl?: string;
+    baseUrl?: string;
+}
+/** Build a hosted U.CASH Pay checkout URL (publishable cloud token, no server needed). */
+declare function hostedCheckoutUrl(opts: HostedCheckoutOptions): string;
+interface UcashPayButtonProps extends HostedCheckoutOptions {
+    buttonText?: string;
+    class?: string;
+    style?: JSX.CSSProperties;
+    children?: JSX.Element;
+}
+/** A "Pay with U.CASH" button/link that opens the hosted checkout. Pure client-side. */
+declare function UcashPayButton(props: UcashPayButtonProps): JSX.Element;
+interface CreateCheckoutResult {
+    ok: boolean;
+    payment_url: string;
+    transaction_id: number | null;
+    message?: string;
+}
+/**
+ * Server-side helper: create a transaction-tracked checkout and return the payment URL + id.
+ * Call from a server route. Idempotent per externalReference.
+ */
+declare function createUcashCheckout(params: HostedCheckoutOptions): Promise<CreateCheckoutResult>;
+
+export { type CreateCheckoutResult, type HostedCheckoutOptions, UcashPayButton, type UcashPayButtonProps, createUcashCheckout, hostedCheckoutUrl };

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+import { JSX } from 'solid-js';
+
+interface HostedCheckoutOptions {
+    cloud: string;
+    amount: string | number;
+    currency?: string;
+    title?: string;
+    externalReference?: string;
+    redirectUrl?: string;
+    baseUrl?: string;
+}
+/** Build a hosted U.CASH Pay checkout URL (publishable cloud token, no server needed). */
+declare function hostedCheckoutUrl(opts: HostedCheckoutOptions): string;
+interface UcashPayButtonProps extends HostedCheckoutOptions {
+    buttonText?: string;
+    class?: string;
+    style?: JSX.CSSProperties;
+    children?: JSX.Element;
+}
+/** A "Pay with U.CASH" button/link that opens the hosted checkout. Pure client-side. */
+declare function UcashPayButton(props: UcashPayButtonProps): JSX.Element;
+interface CreateCheckoutResult {
+    ok: boolean;
+    payment_url: string;
+    transaction_id: number | null;
+    message?: string;
+}
+/**
+ * Server-side helper: create a transaction-tracked checkout and return the payment URL + id.
+ * Call from a server route. Idempotent per externalReference.
+ */
+declare function createUcashCheckout(params: HostedCheckoutOptions): Promise<CreateCheckoutResult>;
+
+export { type CreateCheckoutResult, type HostedCheckoutOptions, UcashPayButton, type UcashPayButtonProps, createUcashCheckout, hostedCheckoutUrl };

package/dist/index.js

@@ -0,0 +1,87 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.tsx
+var index_exports = {};
+__export(index_exports, {
+  UcashPayButton: () => UcashPayButton,
+  createUcashCheckout: () => createUcashCheckout,
+  hostedCheckoutUrl: () => hostedCheckoutUrl
+});
+module.exports = __toCommonJS(index_exports);
+var DEFAULT_BASE = "https://pay.u.cash";
+function hostedCheckoutUrl(opts) {
+  const base = (opts.baseUrl || DEFAULT_BASE).replace(/\/+$/, "");
+  const params = new URLSearchParams({ cloud: opts.cloud, amount: String(opts.amount) });
+  if (opts.currency) params.set("currency", opts.currency);
+  if (opts.title) params.set("title", opts.title);
+  if (opts.externalReference) params.set("external_reference", opts.externalReference);
+  if (opts.redirectUrl) params.set("redirect", opts.redirectUrl);
+  return `${base}/embed.php?${params.toString()}`;
+}
+function UcashPayButton(props) {
+  const href = () => hostedCheckoutUrl({
+    cloud: props.cloud,
+    amount: props.amount,
+    currency: props.currency ?? "USD",
+    title: props.title,
+    externalReference: props.externalReference,
+    redirectUrl: props.redirectUrl,
+    baseUrl: props.baseUrl
+  });
+  return /* @__PURE__ */ React.createElement("a", { href: href(), target: "_blank", rel: "noopener noreferrer", class: props.class, style: props.style }, props.children ?? props.buttonText ?? "Pay with U.CASH");
+}
+async function createUcashCheckout(params) {
+  const base = (params.baseUrl || DEFAULT_BASE).replace(/\/+$/, "");
+  const body = new URLSearchParams({
+    function: "create-transaction",
+    amount: String(params.amount),
+    currency_code: params.currency || "USD",
+    cryptocurrency_code: "",
+    external_reference: params.externalReference || "",
+    title: params.title || "",
+    redirect: params.redirectUrl || "",
+    cloud: params.cloud,
+    idempotent: "1"
+  });
+  const res = await fetch(`${base}/payment/ajax.php`, {
+    method: "POST",
+    headers: { "Content-Type": "application/x-www-form-urlencoded" },
+    body
+  });
+  const json = await res.json();
+  let payment_url = "";
+  let transaction_id = null;
+  if (Array.isArray(json.response)) {
+    for (const v of json.response) {
+      if (!payment_url && typeof v === "string" && /^https?:\/\//i.test(v)) payment_url = v;
+      if (transaction_id === null && (typeof v === "number" || /^\d+$/.test(String(v)))) {
+        const n = Number(v);
+        if (n > 0) transaction_id = n;
+      }
+    }
+  }
+  return { ok: !!json.success, payment_url, transaction_id, message: json.message };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  UcashPayButton,
+  createUcashCheckout,
+  hostedCheckoutUrl
+});

package/dist/index.mjs

@@ -0,0 +1,60 @@
+// src/index.tsx
+var DEFAULT_BASE = "https://pay.u.cash";
+function hostedCheckoutUrl(opts) {
+  const base = (opts.baseUrl || DEFAULT_BASE).replace(/\/+$/, "");
+  const params = new URLSearchParams({ cloud: opts.cloud, amount: String(opts.amount) });
+  if (opts.currency) params.set("currency", opts.currency);
+  if (opts.title) params.set("title", opts.title);
+  if (opts.externalReference) params.set("external_reference", opts.externalReference);
+  if (opts.redirectUrl) params.set("redirect", opts.redirectUrl);
+  return `${base}/embed.php?${params.toString()}`;
+}
+function UcashPayButton(props) {
+  const href = () => hostedCheckoutUrl({
+    cloud: props.cloud,
+    amount: props.amount,
+    currency: props.currency ?? "USD",
+    title: props.title,
+    externalReference: props.externalReference,
+    redirectUrl: props.redirectUrl,
+    baseUrl: props.baseUrl
+  });
+  return /* @__PURE__ */ React.createElement("a", { href: href(), target: "_blank", rel: "noopener noreferrer", class: props.class, style: props.style }, props.children ?? props.buttonText ?? "Pay with U.CASH");
+}
+async function createUcashCheckout(params) {
+  const base = (params.baseUrl || DEFAULT_BASE).replace(/\/+$/, "");
+  const body = new URLSearchParams({
+    function: "create-transaction",
+    amount: String(params.amount),
+    currency_code: params.currency || "USD",
+    cryptocurrency_code: "",
+    external_reference: params.externalReference || "",
+    title: params.title || "",
+    redirect: params.redirectUrl || "",
+    cloud: params.cloud,
+    idempotent: "1"
+  });
+  const res = await fetch(`${base}/payment/ajax.php`, {
+    method: "POST",
+    headers: { "Content-Type": "application/x-www-form-urlencoded" },
+    body
+  });
+  const json = await res.json();
+  let payment_url = "";
+  let transaction_id = null;
+  if (Array.isArray(json.response)) {
+    for (const v of json.response) {
+      if (!payment_url && typeof v === "string" && /^https?:\/\//i.test(v)) payment_url = v;
+      if (transaction_id === null && (typeof v === "number" || /^\d+$/.test(String(v)))) {
+        const n = Number(v);
+        if (n > 0) transaction_id = n;
+      }
+    }
+  }
+  return { ok: !!json.success, payment_url, transaction_id, message: json.message };
+}
+export {
+  UcashPayButton,
+  createUcashCheckout,
+  hostedCheckoutUrl
+};

package/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "ucashpay-solid",
+  "version": "0.1.0",
+  "description": "SolidJS components and helpers for U.CASH Pay: a Pay-with-U.CASH button + server-side checkout creation. Non-custodial.",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "files": ["dist"],
+  "scripts": { "build": "tsup src/index.tsx --format cjs,esm --dts", "dev": "tsup src/index.tsx --format cjs,esm --dts --watch" },
+  "keywords": ["ucash","u.cash","solid","solidjs","payments","crypto","bitcoin","checkout","non-custodial"],
+  "peerDependencies": { "solid-js": ">=1.7.0" },
+  "devDependencies": { "solid-js": "^1.8.0", "tsup": "^8.0.0", "typescript": "^5.4.0" },
+  "license": "MIT"
+}