Crypto Payment manual.

How to accept Bitcoin, Ethereum, Cardano, Solana and XRP - with your own wallets and no payment provider in between.

System requirements

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:

bin/console plugin:refresh bin/console plugin:install --activate StawCryptoPaymentDirect bin/console cache:clear

Licence key

The licence key is entered first in the plugin configuration. Licensing and updates run through our licensing platform.

Setup in three steps

  1. Enter the licence key.
  2. Store the wallet addresses for the currencies you want to offer.
  3. 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.

You buy the licence directly from us and get an invoice from us. Install by upload in the admin without SSH, updates through our licensing platform, support straight from the developer.

Ask us directly+49 2555 9997342

Shopware Store

In preparation

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.