Skip to main content

Welcome to our Help Center!

Setup WooCommerce plugin

This article is a guide on how to install and configure the WooCommerce plugin.


Installation & Configuration

See this video and follow the steps below :

  1. Install the plugin to your Wordpress admin.

  2. Click on Active Plugin.

  3. Go to WooCommerce → Settings → Payments → Billwerk+ Checkout.

  4. Choose a title and description to be shown on the checkout page.

    For example:

    Title: Online Payment

    Description: Secure payment with Billwerk+.

  5. Insert your API keys.

    • The Live API key is used for real payments

    • The Test API key is only used for test payments.

    1. Insert your Private API key from your live Billwerk+ account into the Live API key field.


      You can find your private API keys in your Billwerk+ Dashboard.

    2. Insert your Private API key from your test Billwerk+ account into the Test API key field.

    3. Open a new tab and go to your live account.

    4. On the side bar, click on Developers → API credentials .

    5. Click on Generate New under Private API Keys.

    6. Copy the key and paste it in WooCommerce under Private key.

  6. Choose between modal and window display.

  7. Choose the Payment methods you also have activated in Billwerk+.

    Hold ctrl/cmd while clicking on the different payment methods.

    This will list all the activated payment methods together in the Billwerk+ payment window.


    You also have the option to create individual payment options in the WooCommerce checkout, by going to WooCommerce → Settings → Payments → and activating the different payment methods. E.g. Billwerk+ - MobilePay.

    In this case, you can have individual rows directly in the WooCommerce checkout.

    For example:

    1. Billwerk+ Checkout. Title: Payment Cards

    2. Billwerk+ MobilePay. Title: MobilePay Online

    3. Billwerk+ ApplePay. Title: Apple Pay

  8. Chose which settle option you would like to use.

    For further information please read: Configure automatic settle in Wordpress/WooCommerce

  9. Enable debug, for faster solutions if anything goes wrong.

  10. Enable Save CC to save credit cards to customers for their later use. If you are not approved by your acquirer to save cards, do not activate this option.

  11. Enable Payment method icons for the same payment methods you enable in step 7.

  12. Choose order status mapping between WooCommerce and Billwerk+. Recommended configuration:

    1. Billwerk+ Created = Pending payment

    2. Billwerk+ Authorized = Processing

    3. Billwerk+ Settled = Completed.

  13. Click Save changes.

Bonus: Show your logo in the payment window

In order to do so, please follow these steps:

  1. Go into your Billwerk+ Optimize Administration.

  2. Click on Configuration → Checkout .

  3. In the default Configuration, click on Edit.

  4. Scroll down and Upload a logo from your computer → Update Configuration.


If you have installed a security plugin ensure not to block Ireland as a country or just whitelist our webhook IP address: This is very important since the plugin relies on webhooks.