Shopware 6.7 and a valid licence key. You also need your own wallet address for every cryptocurrency you want to offer, one you can receive payments on.
Installation
Upload the plugin ZIP in the Shopware admin under Extensions, then install and activate it. Or from the console:
The licence key is entered first in the plugin configuration. Licensing and updates run through our licensing platform.
Setup in three steps
Enter the licence key.
Store the wallet addresses for the currencies you want to offer.
Enable the payment method in the relevant sales channel.
Supported cryptocurrencies
Five currencies are available: Bitcoin (BTC), Ethereum (ETH), Cardano (ADA), Solana (SOL) and XRP.
Only what you store appears: The checkout offers exactly those currencies that have a wallet address on file. You do not have to offer all five - just enter the addresses you actually want to use.
Storing wallet addresses
Each currency has its own configuration field: btcAddress, ethAddress, adaAddress, solAddress and xrpAddress.
Check carefully: Crypto payments cannot be reversed. A mistyped address means payments go irretrievably to a stranger's wallet or nowhere at all. Always copy addresses out of your wallet rather than typing them, and test each currency once with a tiny amount.
Enabling the payment method
Like any Shopware payment method, this one has to be enabled in the relevant sales channel. Without that step it does not show up in the checkout, even with addresses stored.
Selection during checkout
Customers pick their cryptocurrency during checkout, not afterwards. Only what you configured is offered.
The finish page
After the order is placed, the finish page shows the matching wallet address together with a copy button. The customer then transfers the amount from their own wallet.
Checking and confirming payments
Important to know: The plugin does not verify payments on the blockchain. It shows the customer a wallet address for a manual transfer. Whether and when a payment arrives is something you check in your own wallet, and the incoming payment is then confirmed manually in the shop.
Plan for this in daily operations: crypto orders need a fixed checkpoint, much like prepayment by bank transfer. Because rates fluctuate, it also pays to have a clear rule on how long a payment may take and how you handle under- or overpayments.
Editable texts
All texts can be changed in the admin. Two come pre-filled:
Confirmation text
Asks the customer to send the exact amount to the address shown.
Network fee note
Points out that network fees are not included in the order total.
The plugin ships bilingual, German and English.
Troubleshooting
A currency does not appear in the checkout
No wallet address is stored for it. That is the intended behaviour.
The payment method does not appear at all
Then it is not enabled in the sales channel, or not a single address has been entered.
The customer paid but the order is still open
That is by design. Incoming payments are confirmed manually; there is no automatic blockchain check.
The transferred amount differs
Network fees are borne by the customer and are not part of the order total - which is what the pre-filled note explains. Larger discrepancies need to be settled case by case.
Support
We are happy to answer questions about setup or the order flow. Get in touch via the contact page or write to info@stoneandwater.online.
All settings
Every setting of the plugin with its default value and explanation, in the same order as in the administration. The texts come straight from the plugin (version 1.1.0).
Sales channel
Sales channelDefault: All sales channels
Defines which sales channel the settings below apply to. Without a selection they apply to all channels, as long as a channel has no values of its own. This allows separate wallets per shop.
Wallet addresses
BitcoinDefault: empty
Receiving address for Bitcoin. Customers who choose Bitcoin see it on the finish page with a button to copy it. If left empty, Bitcoin is not offered at checkout. Please check the address carefully - payments to a wrong address cannot be recovered.
EthereumDefault: empty
Receiving address for Ethereum. Customers who choose Ethereum see it on the finish page with a button to copy it. If left empty, Ethereum is not offered at checkout. Please check the address carefully - payments to a wrong address cannot be recovered.
CardanoDefault: empty
Receiving address for Cardano. Customers who choose Cardano see it on the finish page with a button to copy it. If left empty, Cardano is not offered at checkout. Please check the address carefully - payments to a wrong address cannot be recovered.
SolanaDefault: empty
Receiving address for Solana. Customers who choose Solana see it on the finish page with a button to copy it. If left empty, Solana is not offered at checkout. Please check the address carefully - payments to a wrong address cannot be recovered.
XRP LedgerDefault: empty
Receiving address for XRP Ledger. Customers who choose XRP Ledger see it on the finish page with a button to copy it. If left empty, XRP Ledger is not offered at checkout. Please check the address carefully - payments to a wrong address cannot be recovered.
Checkout texts
Confirmation textDefault: Please send the exact amount to the address below.
Text on the finish page above the payment address. It tells the customer what to do next. If left empty, the default text is shown.
Network fee noteDefault: Please note: network fees are not included in the order amount.
Note on the finish page, highlighted with a warning sign. It points out that the fees of the respective network come on top. If left empty, the default text is shown.
License
License keyDefault: empty
The licence key from your Stone & Water customer account. Without a valid licence, checkout offers no cryptocurrency. The plugin checks the key with the licence server once a day; if the server cannot be reached, it keeps running for up to seven days.
Through the store or directly from us.
Two routes, the same feature set - pick whichever suits your setup.
Directly from Stone & Water
Available right now
Monthly4,99 €
Best valueYearly50,90 €15 % cheaper
All prices net, plus VAT.
Download the free Plugin Suite and upload it in the admin, no SSH needed. It installs and updates the plugin with one click. You buy the licence directly from us, with an invoice from us and support straight from the developer.
The plugin will be listed in the official Shopware Community Store. Installation and automatic updates then run through the plugin manager, billing through your Shopware account. We will link it here as soon as it is live.
Crypto as a payment method?
Back to Crypto Payment.
Every feature and all prices are on the product page. We are happy to help with setup and wallet configuration.