@ucash/n8n

An n8n community node for U.CASH Pay. Create hosted crypto + card checkouts and verify settlement webhooks, fully non-custodial.

Operations

• Create Checkout - calls pay.u.cash to create a transaction and returns the hosted payment_url (plus the transaction_id). Wire it into any workflow to generate a pay link from an amount, currency, title, and your own external_reference.
• Verify Webhook - verifies an incoming X-Webhook-Signature (HMAC-SHA256, replay-safe, 300s window) and returns the parsed transaction. Use it after an n8n Webhook node to confirm a payment before fulfilling.

Set up your pay.u.cash account

You need a free U.CASH Pay account and a store before this node can create checkouts. Settlement is non-custodial: crypto goes straight to addresses you control.

1. Sign up at pay.u.cash with your email and password, then click the verification link in the email U.CASH Pay sends you.
2. Set your receive addresses. Go to Settings -> Addresses and enter a wallet address for each coin you want to accept (ENS, Unstoppable Domains, or FIO names also work). This is where crypto payments settle.
3. Create a store. Go to Account -> Stores, click + Add Store, name it (for example, "n8n"), and create it.
4. Copy the store credentials. In that store's row, copy the Store Cloud Token and the Store Webhook Secret. Use the store-level token, not the account-wide one.
5. Set the webhook URL. If you use the Verify Webhook operation, create an n8n Webhook node, copy its production URL, paste it into the store's Store Webhook URL field in pay.u.cash, save, then click Test Webhook.

Then in n8n, create Credentials -> U.CASH Pay API and paste the Store Cloud Token (+ Store Webhook Secret if you verify webhooks).

Install

This is an n8n community node. Install it from npm inside your n8n environment:

npm install @ucash/n8n

Or load it from this repo by cloning it into your N8N_CUSTOM_NODES directory (then npm install && npm run build). See the n8n community nodes docs.

Receiving a payment end-to-end

[ Webhook (n8n) ] -> [ U.CASH Pay: Verify Webhook ] -> [ Fulfil order / send email / ... ]

• The Webhook node exposes a URL you paste into pay.u.cash (step 5 above).
• U.CASH Pay -> Verify Webhook checks verified === true before you act. U.CASH Pay signs every event with X-Webhook-Signature: t=<ts>,v1=<hmac>; the node recomputes HMAC-SHA256 over t.raw_body with your Store Webhook Secret.

Notes

• Create Checkout is idempotent (idempotent=1) per external_reference.
• The node uses Node's built-in fetch and crypto; no extra runtime deps.

License

MIT.