
PrestaShop integration
A module for PrestaShop 8 and 1.7.8. Smaller payments add up until the order total is reached.
Read the API quick startRequirements
- PrestaShop 8.1.x or 1.7.8.x, PHP 8.3+ with bcmath, curl, openssl and json, and MySQL with InnoDB.
- A public HTTPS shop outside maintenance mode, a gateway public API URL and a payout wallet. The module was exercised in a PrestaShop 8.1.7 shop; 1.7.8 was not run in a shop.
Install and configure
- Package the repository with make integrations-package and take suawave.zip, or copy the module folder into modules/suawave.
- Upload the archive in Module Manager, then install and configure Suawave.
- Set the gateway URL, ticker, payout address, exact public shop origin and order currency. Leave the callback public key empty and save to fetch it from /pubkey/, or paste it to pin the key.
- Use the module's configured order currency. There is no conversion: the token amount equals the cart total one to one.
What the buyer sees
The order confirmation and order detail pages show the amount, deposit address, gateway-generated QR code and deadline. The order waits in Awaiting crypto payment until verified confirmed deposits cover the total, then moves to Payment accepted. The customer reloads the page or checks order history; the confirmation page does not refresh automatically.
Payment behavior
- Smaller confirmed deposits accumulate. Pending callbacks only record detection; duplicate callback UUIDs do not add credit again.
- Expired instructions hide the address and QR code and offer a new attempt on the existing unpaid order. Expiry notes depend on page requests or a cron module, so a shop without traffic can record them late.