OPENCART PLUGIN

Crypto payments for OpenCart.

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

Get the plugin

v1.0.1

The first release targets OpenCart 4.1.x and PHP 8.1+. Tested with OpenCart 4.1.0.4; check your theme and checkout on staging.

MIT licensed · PHP SDK included · No Composer setup

Simple checkout. Verified orders.

  • Hosted checkout with your store's accepted assets
  • Signed IPN plus authenticated API checks
  • Saved invoice retries and duplicate-payment protection

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

Install

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

whollycrypto.ocmod.zip

Keep this filename. Upload and install the package using this menu:

Extensions → Installer

Then install and edit the payment method:

Extensions → Extensions → Payments → Wholly Crypto

Connect a store

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.

Use HTTPS. Allow callbacks through your firewall without CAPTCHA or browser login. Save, test the connection, then complete a staging payment.

Choose waiting, paid, review and expired order statuses. Only the paid status may trigger OpenCart fulfillment. The first release uses one shared connection per installation.

The connection check tests API access, not a complete payment.

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.

OpenCart keeps the verified result in order history and retains its native fraud checks. Use Wholly's IPN history to inspect and resend failed deliveries.

Limits & delivery problems

This release supports positive fiat orders and full-page checkout. No automatic refunds or recurring debits. OpenCart 3.x and 4.0.x are not supported.

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 →