WoltLab Cloud VieCode Shop: Coinbase Commerce Integration 8.0.6

Would you like to accept cryptocurrencies in your shop? This plugin integrates the payment service provider Coinbase Commerce seamlessly into the VieCode Shop and makes it possible to receive cryptocurrencies such as Bitcoin, Litecoin, Ethereum and more in no time!

Coinbase Commerce is a platform that allows merchants anywhere in the world to accept payments in cryptocurrencies in a fully decentralized manner. This means that all amounts you receive are controlled exclusively and completely by you. Coinbase Commerce has no access to any amounts you receive.

If you are not yet familiar with the topic, please take some time to learn about cryptocurrencies and the regulations governing their acceptance. Cryptocurrencies are a new and exciting way to pay for goods and services, but they are also regulated in many jurisdictions. By learning about the regulations in your jurisdiction, you can ensure that you are accepting cryptocurrencies in a legal and compliant manner.

A few reasons why you should start accepting cryptocurrency:

  • Cryptocurrency is a global currency, so it can be used by anyone in the world
  • Additional payment methods increase the probability that (new) customers will find a suitable payment method
  • Transactions are processed quickly, securely and confidentially. Customers can be sure that their personal information will not be shared.
  • You benefit from lower transaction fees than usual with common payment methods

Cryptocurrencies supported by Coinbase Commerce:

  • ApeCoin (APE)
  • Bitcoin (BTC)
  • Bitcoin Cash (BCH)
  • Dai (DAI)
  • Dogecoin (DOGE)
  • Ethereum (ETH)
  • Litecoin (LTC)
  • Shiba Inu (SHIB)
  • Tether (USDT)
  • USD Coin (USDC)

System Requirements

  • WoltLab Suite Core: Version 5.4.15+ oder 5.5.0+
  • VieCode Shop: Version 8.0.0+
  • PHP: Version 7.4.21+

If you have any issues with PHP compatibility, please contact me.

Installation & Setup

Before you can begin the setup, you need to create a Coinbase Commerce account. Coinbase Commerce does not require you (as of 09/15/2022) to provide any documentation for verification and you can start receiving payments immediately. It's best to make sure this is still the case before purchasing this extension.

Once you have successfully registered, you need to go through a few more steps in your Coinbase Commerce settings before you can set up the plugin. First, put your domain on the whitelist under the "Security" section. This is necessary so that Coinbase Commerce can send you payment notifications. You will also find your API-Token on this page.

Now switch to the "Notifications" section and add a new endpoint under "Webhook Subscriptions". For the URL, enter https://example.com/shop/index.php?coinbase-notification. Replace example.com with your domain. When selecting events, deselect all options except charge:confirmed, charge:failed and optionally charge:pending. The other events are not needed and may cause errors. After adding the endpoint, you will also find your Webhook-Secret on this page, which you will need in a moment.

If you want, you can now adjust your payment settings in the "Payments" section and set thresholds for under/overpayments. However, the plugin does not validate these and relies on Coinbase Commerce to cancel the payment if it does not match your settings.

At Coinbase Commerce, you are now done for the time being. Next, install the plugin and open the settings in the ACP under Configuration -> Shop -> Coinbase Commerce. Configure the settings as you know them from other payment methods of the VieCode Shop and enter your API-Token, as well as your Webhook-Secret.

You can now check Coinbase Commerce to see if the webhook notifications are working properly. To do this, go back to the notifications section and edit the webhook subscription you created. A small pop-up window will open, in which there is a "Send test" button (or similar). Now select one of the two selectable types, send a notification and wait for the result. The webhook notifications are working properly if you get a response status of 200 with an "OK" message.

The payment method is now ready to use.

Coinbase Commerce does not offer a sandbox mode! If you want to test the plugin, you need to make a real payment.

Important Information

The plugin only supports the webhook events for completing or canceling a payment used to either confirm or cancel orders. Payments that were overpaid or underpaid, as well as invoice integration are not supported. The latter should not be needed when using the VieCode Shop anyway, as it already does an excellent job of issuing its own invoices.


If you still have questions, you can ask them in the comments section of the plugin. For support requests, please start a new conversation so I can take care of the problem as soon as possible. I currently do not offer support through any other platform.


  • Version 8.0.6


    • Payments can now be marked as "being processed" by activating the "charge:pending" webhook
      • This means that the transaction was detected on the blockhain but not yet validated by the network

    Compatibility: WSC 5.4/5.5, VieCode Shop 8.0

  • Version 8.0.5

    Initial Release