U.CASH Pay for Zen Cart

Accept crypto and card payments in your Zen Cart store through U.CASH Pay. Buyers pay at the hosted U.CASH Pay checkout and the order is confirmed automatically.

How it works

1. Buyer picks U.CASH Pay at checkout and confirms the order.
2. process_button() POSTs the order id to callback/ucash.php?action=checkout.
3. The callback creates a U.CASH Pay checkout via the SDK and redirects the buyer.
4. U.CASH Pay sends an HMAC-signed webhook to callback/ucash.php (no action). The callback verifies the signature, reconciles amount + currency, and sets the order to the configured Paid order status.

Requirements

• Zen Cart 1.5.x / 2.x (PHP 7.2+ with the curl extension).
• HTTPS on the public webhook URL.
• A free U.CASH Pay account.

Install

1. Copy the files into your Zen Cart install:
   • includes/modules/payment/ucash.php (module + SDK)
   • includes/modules/payment/PayUCashIntegration.php (SDK)
   • includes/languages/english/modules/payment/ucash.php (language strings)
   • callback/ucash.php (checkout redirect + webhook)
2. In the Zen Cart admin go to Modules -> Payment, click U.CASH Pay, then Install.

Configure

1. In U.CASH Pay -> Account -> Stores, create a store for this Zen Cart install and copy its Cloud token and Webhook secret.

2. In Zen Cart -> Modules -> Payment -> U.CASH Pay -> Edit, paste them into Cloud token and Webhook secret, set the U.CASH Pay URL (default https://pay.u.cash), and pick the Paid order status.

3. Set the store's Webhook URL in U.CASH Pay -> Account -> Stores -> [your store] -> Edit to:

   https://YOUR-STORE/callback/ucash.php
   

4. Save, then place a test order.

Debug

To enable verbose logging, create an empty file at callback/ucash_debug.on. The callback appends to callback/ucash_debug.txt. Remove the .on file to disable.

Files

• includes/modules/payment/ucash.php the payment module class.
• includes/modules/payment/PayUCashIntegration.php the shared SDK.
• includes/languages/english/modules/payment/ucash.php English language strings.
• callback/ucash.php checkout redirect + webhook receiver.

Multi-store

One U.CASH Pay store per Zen Cart install. Running several integrations? Create one store each in U.CASH Pay -> Account -> Stores; each gets its own Cloud token, Webhook secret, and Webhook URL.

Support

https://u.cash

(c) 2015-2026 U.CASH. All rights reserved.