U.CASH Pay for Magento 2

Accept crypto (BTC, ETH, USDT, USDC, Solana, Tron, UCASH + custom tokens) and cards (via your own Stripe) through U.CASH Pay. Non-custodial: funds settle direct to your wallet.

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.

Installation

Via Composer (recommended)

composer require ucash/module-pay
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento cache:clean

Manual

1. Create app/code/Ucash/Pay/.
2. Copy all files from this repo into that directory.
3. Run php bin/magento setup:upgrade && php bin/magento setup:di:compile && php bin/magento cache:clean.

Configuration

1. Go to Stores > Configuration > Sales > Payment Methods > U.CASH Pay.
2. Set Enabled = Yes.
3. In U.CASH Pay (pay.u.cash), go to Account > Stores. Copy your Cloud token and Webhook secret.
4. Paste them into the Magento config. Set the Webhook URL in U.CASH Pay to: https://your-store.com/ucashpay/payment/webhook
5. Save + flush cache.

How it works

1. Buyer selects U.CASH Pay at checkout.
2. The module creates a pay.u.cash checkout (via the SDK) and redirects the buyer.
3. Buyer pays with crypto or card on the hosted U.CASH Pay page.
4. U.CASH Pay sends an HMAC-signed webhook to /ucashpay/payment/webhook.
5. The module verifies the webhook, creates an invoice, and marks the order "Processing".

Non-custodial: the platform never holds funds. Crypto settles direct buyer-to-wallet; cards through the merchant's own Stripe.

Files

• Model/PaymentMethod.php - payment method registration (extends AbstractMethod).
• Controller/Payment/Redirect.php - creates checkout via SDK + redirects buyer.
• Controller/Payment/Webhook.php - verifies HMAC webhook + creates invoice + marks order paid.
• PayUCashIntegration.php - the shared SDK (zero-dependency).
• etc/config.xml + etc/adminhtml/system.xml - default config + admin UI.
• etc/frontend/routes.xml - frontend routes (/ucashpay/payment/*).

License: OSL-3.0 / AFL-3.0 (Magento's license).