U.CASH Pay for WHMCS

Accept crypto and card payments on your WHMCS site through U.CASH Pay. Customers pay their invoices with U.CASH Pay and paid invoices are confirmed automatically - no manual reconciliation.

Set up your pay.u.cash account

You need a free U.CASH Pay account and a store before this plugin can accept payments. 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. You can also use ENS, Unstoppable Domains, or FIO names instead of raw addresses. This is where crypto payments settle.
3. Create a store. Go to Account → Stores, click + Add Store, name it (for example, after this platform), 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. Paste this plugin's webhook callback URL (shown in the plugin settings below) into the store's Store Webhook URL field, save, then click Test Webhook to confirm U.CASH Pay can reach your store.

Then paste the Store Cloud Token and Store Webhook Secret into the plugin configuration fields described below.

To also accept fiat cards, connect your own Stripe account under Settings → Payment processors. Cards run non-custodially through Stripe.

Install

1. Download whmcs-ucashpay-module.zip and unzip it.
2. Copy ucashpay.php → modules/gateways/ucashpay.php in your WHMCS installation.
3. Copy callback/ucashpay.php → modules/gateways/callback/ucashpay.php.
4. WHMCS admin → System Settings → Payment Gateways → U.CASH Pay → Activate.

Configure

U.CASH Pay uses one store per integration. Create a store for this WHMCS install, then wire it up:

1. In U.CASH Pay → Account → Stores, create a store (e.g. "WHMCS").
2. Copy that store's Cloud token and Webhook secret.
3. In WHMCS → System Settings → Payment Gateways → U.CASH Pay, paste them into Cloud token and Webhook secret key.
4. Click Copy URL next to the module's Webhook URL, then in U.CASH Pay → Account → Stores → [your store] → Edit, set the store's Webhook URL to it. Save.
5. Save Changes in WHMCS.
6. Click Test Connection - you should see: “Connected - U.CASH Pay reached your WHMCS and the webhook signature verified.”

That's it - customers can now pay invoices with U.CASH Pay.

Use the store's Cloud token (from Account → Stores), not the account-level one under Account → Cloud token. The Cloud token is publishable - it is not your API key.

Test Connection

Test Connection sends a real, signed test notification from U.CASH Pay to your WHMCS and reports:

• ✓ Connected - token valid, site reachable, secret matches. Ready to accept payments.
• ✗ Wrong/invalid token - re-copy the store's Cloud token from Account → Stores.
• ✗ Secret mismatch - re-copy the store's Webhook secret into the module.
• ✗ Not reachable - your Webhook URL must be HTTPS and publicly reachable.
• ⚠ URL mismatch - the Webhook URL in U.CASH Pay differs from the module's; make them match.

Multi-store

Running several integrations (WHMCS + WooCommerce + …)? Create one store per integration in U.CASH Pay → Account → Stores; each gets its own Cloud token, Webhook secret, and Webhook URL.

Requirements

• WHMCS running on HTTPS.
• A free U.CASH Pay account.

Support

https://u.cash

© 2015-2026 U.CASH. All rights reserved.