1. Setting up the plugin


1.1 Settings in the Datatrans account

Log into the backend of your Datatrans account and use the link “change merchant” in the upper right corner to go to your merchant administration. Then, go to the page “UPP Administration > Security“.

Generate a password and click on “Update”. Username and password will be required later when setting up the plugin in the WordPress backend.

Then click on the red “Important parameters will be digitally signed (HMAC-SHA256) and sent with payment messages”. The sign value in the text field is required for the WooCommerce settings.

1.2 Settings in WooCommerce

Log into the backend of your WordPress installation and go to “WooCommerce > Settings > datatrans“.

License key: datatrans for WooCommerce

Enter the license key for the plugin “datatrans for WooCommerce” to receive updates and support for the plugin. Then click “activate”.

An activation of a license may fail for the following reasons:

  • The limit of the number of websites the license can be activated for is reached or the license is used for another domain. You can manage your license and remove websites from the license in your account at mamedev.ch.
  • The license has expired. Visit mamedev.ch and renew your license or buy a new license.

Environment

Choose test to connect to a datatrans sandbox account (https://admin.sandbox.datatrans.com). To make test payments you will need to use test payment means. You can find all available test payment means in the document “Technical Implementation Guide Universal Payment Page” on the following page:

https://docs.datatrans.ch/docs/testing-credentials

Choose production to connect your online shop to the production interface and receive real payments.


Username

You can find this value in the datatrans account under “UPP administration > Security”.


Password

The password can be generated in the datatrans account under “UPP Management > Security”.


Webhook sign

The value that was generated on the “UPP Management > Security > Security signature” page under the option “Important parameters will be digitally signed (HMAC-SHA256) and sent with payment messages” must be entered here.


Authorization order status

Choose here whether orders that are only authorized but not settled should have the WooCommerce status “pending”, “in progress” or “completed”.


Authorization order status for virtual products 

Choose here whether orders that only contain virtual products should receive the WooCommerce status “pending”, “in progress” or “completed” for payments that are only authorized but not settled.


Settled payment order status

Choose here whether orders that are authorized and settled should receive the WooCommerce status “pending”, “in progress” or “completed”.


Settled payment order status for virtual products

Choose here whether for payments that are authorized and settled for orders that only contain virtual products, the WooCommerce status should be “pending”, “in progress” or “completed”.


Saved payment methods

If this option is activated, customers can activate a checkbox for certain payment methods in order to save the payment method for later purchases and thereby speed up the purchase process. The saved payment methods are listed for each customer in the account under “Payment Methods”.


Log

Here you can define whether errors or all events (recommended) are to be logged or whether logs should be deactivated.