MAGENTO PLUGIN

Crypto payments for Magento 2.

Connect your shop to your own Wholly Crypto checkout. Customers choose a network and token; verified notifications update the order.

Magento 2

v1.0.0

Magento 2.4 · PHP 8.2+ · HTTPS · InnoDB

Tested on Magento Open Source 2.4.8-p5 with the standard checkout. Follow your Magento version's PHP requirements.

MIT licensed · PHP SDK included · No Composer setup

Install

Download the install package and verify SHA256SUMS. Do not use GitHub's source ZIP.

Extract the ZIP in your Magento root, then run these commands as your shop's filesystem owner. Replace en_US with your storefront locales.

php bin/magento module:enable WhollyCrypto_Payment
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy -f en_US
php bin/magento cache:flush

Connect a store

Open Stores → Configuration → Sales → Payment Methods → Wholly Crypto. Choose your store view and enable the method.

Enter your API and checkout origins, Project/Store API UUIDs, a project-restricted read/write API credential and the store IPN signing secret. Enable IPN in Wholly; the plugin supplies the callback URL.

Allow IPN callbacks through your firewall without CAPTCHA or browser login. Test a payment on your staging shop before going live.

Wallet keys stay in Wholly Crypto. The plugin adds no percentage fee; your processing-credit policy still applies.

Check the payment flow

Unconfirmed or partial payments stay pending. A matching, settled payment updates the order once. Overpaid, late, invalid or changed orders require review. Browser returns never confirm payment.

Magento records one paid invoice. Find the Wholly invoice ID and verification result in the order's Payment Information and comments.

Recover missed updates

Magento cron checks saved invoices every five minutes. You can also run a manual check from your shop directory.

php bin/magento whollycrypto:reconcile --limit=50
Limits & delivery problems

No automated refunds, recurring debits, split-order payments or embedded checkout.

Hyvä, PWA/headless checkout and Adobe Commerce-specific extensions need separate staging tests.

Low credits can pause IPN while customers can still pay. Restore credits and resend failed notifications from Wholly's delivery history.

How processing credits work → · IPN guide →