
WooCommerce crypto payment plugin
A WordPress plugin. The amount, address and QR code show on the thank-you page and in the order email.
Read the API quick startRequirements
- WordPress 6.0+, WooCommerce 8+ and PHP 8.3+ with bcmath and openssl.
- A publicly reachable HTTPS shop, a gateway public API URL and a payout wallet on the selected network.
Install and configure
- Package the repository with make integrations-package and upload suawave-payment.zip through Plugins > Add New > Upload Plugin, then activate it.
- Open WooCommerce > Settings > Payments > Suawave payment.
- Set the gateway URL, enabled ticker and payout address. Fetch the PEM public key from /pubkey/ and paste it with real line breaks.
- Set the public site origin explicitly behind a proxy. Choose whether the order total equals the token amount or uses the gateway conversion rate.
What the buyer sees
The thank-you page, order details and order email show the amount, deposit address, network, minimum deposit, deadline and gateway-generated QR code. The order stays on hold until verified confirmed deposits cover the total.
Payment behavior
- Pending callbacks add a note only. Smaller confirmed deposits accumulate; repeated callback UUIDs do not add credit again.
- When the payment window closes, the instructions hide the address and QR code. Paying again creates a new attempt; a paid order shows Payment received.