
OpenCart integration
An extension for OpenCart 4 that takes payment for orders in the currency you choose.
Read the API quick startRequirements
- OpenCart 4.0.2.x, PHP 8.3+ with bcmath, curl, openssl and json. No runtime Composer packages.
- A public HTTPS shop, gateway public API URL and payout wallet. Orders must use the configured order currency.
Install and configure
- Package the repository with make integrations-package and upload suawave.ocmod.zip through Extensions > Installer. Keep that archive name.
- Open Extensions > Extensions > Payments, install Suawave and click Edit. Grant the admin user group access to extension/suawave/payment/suawave if needed.
- Set the gateway URL, ticker, payout address, exact public shop origin and order currency. Leave the public key empty and save to fetch it from /pubkey/, or paste a valid RSA PEM key.
- Choose waiting and paid order statuses and enable the method. For updates, copy the new files over extension/suawave and save the settings; uninstalling the payment removes its settings.
What the buyer sees
Checkout shows the amount, deposit address and a QR code drawn locally by the bundled browser library. It polls the shop's local status endpoint and moves to the success page after verified confirmed deposits cover the order total.
Payment behavior
- There is no exchange-rate lookup: the token amount equals the order total one to one, and the method appears only for the configured currency.
- Pending deposits show as detected without paying the order. Smaller confirmed deposits add up. After expiry, checkout hides the address and allows a fresh attempt unless payment was already detected.