chargebee-ucashpay

U.CASH Pay for Chargebee. Add a "Pay with U.CASH" option to invoices; a verified webhook marks the invoice paid. Non-custodial.

Status: scaffold. The OAuth + platform API call in markInvoicePaid() is stubbed (documented below). Wire it, validate in the platform sandbox, then list on the platform marketplace.

Flow

• GET /pay?invoiceId=..&amount=..&currency=.. redirects to a hosted U.CASH Pay checkout for the invoice.
• POST /ucashpay/webhook verifies the X-Webhook-Signature (HMAC-SHA256, 300s window) and marks the invoice paid.

Run

npm install
UCASH_CLOUD_TOKEN=st_your_store_cloud_token \
UCASH_WEBHOOK_SECRET=your_store_webhook_secret \
CHARGEBEE_SITE=.. CHARGEBEE_API_KEY=.. \
PORT=3000 npm start

Set up your pay.u.cash account

1. Sign up at pay.u.cash, verify email.
2. Set receive addresses under Settings -> Addresses.
3. Create a store at Account -> Stores -> + Add Store; copy the Store Cloud Token + Store Webhook Secret.
4. Set the webhook URL to https://your-host/ucashpay/webhook, then Test Webhook.

Chargebee setup

Configure U.CASH Pay as a custom payment gateway in your Chargebee site, or record an external payment. In markInvoicePaid(): POST https://{site}.chargebee.com/api/v2/invoices/{invoiceId}/record_payment with body { amount, payment_method: 'other' }, Authorization: Basic apikey:x. Listing on the Chargebee marketplace is a separate review.

License

MIT.