bigcommerce-ucashpay

A U.CASH Pay payment app for BigCommerce. Shoppers pay with crypto or card at the hosted checkout; a verified webhook updates the BigCommerce order. Non-custodial.

Status: scaffold. BigCommerce payment apps use the BigCommerce Payment Apps framework (app registration + OAuth + payment-method configuration), which is version/platform-specific. Wire up the OAuth token store + the BigCommerce PUT /orders/{id} call noted in index.js, then validate in the BigCommerce dev store before submitting to the Marketplace.

What it does

• GET /pay - the checkout calls this; the app redirects the shopper to a hosted U.CASH Pay checkout.
• POST /ucashpay/webhook - receives the U.CASH Pay settlement webhook, verifies the X-Webhook-Signature (HMAC-SHA256, 300s window), and updates the BigCommerce order (implement the API call in the handler).

Run

npm install
UCASH_CLOUD_TOKEN=st_your_store_cloud_token \
UCASH_WEBHOOK_SECRET=your_store_webhook_secret \
PORT=3000 \
npm start

Host on public HTTPS. Create a BigCommerce app in the Developer Portal, add it as a Payment app, and point its payment URL to https://your-host/pay.

Set up your pay.u.cash account

1. Sign up at pay.u.cash, verify your email.
2. Set your receive addresses under Settings → Addresses (a wallet per coin, or ENS/Unstoppable/FIO names).
3. Create a store at Account → Stores → + Add Store.
4. Copy the Store Cloud Token + Store Webhook Secret (store-level, not account-wide).
5. Set the webhook URL to https://your-host/ucashpay/webhook, then Test Webhook.

Submit to the BigCommerce Marketplace

Listing is via BigCommerce partner/marketplace review - outside this repo.

License

MIT.