Setting up the plugin
For setting up the plugin you need a free TWINT portal account:
1. Start setup assistant
Log in to the WordPress backend of your website and start the setup assistant on the page “WooCommerce > Settings > TWINT” by clicking on the corresponding button.
2. Select integration
Two different integrations are available for setup, the integration via mame and the direct integration.
If you later decide to use a different integration, you can restart the setup and follow the steps below again.
Integration via mame (empfohlen)
When integrating via mame, the connection to TWINT takes place via mame’s servers. This integration offers the following advantages over the direct connection:
- Subscription payments via Woo Subscriptions.
- Storage of TWINT as a payment method for future payments.
- Best performance: Performance does not depend on the server or your web hosting. The payment process takes place on mame’s secure servers.
- Less computing load on your own server/online shop.
- Weniger Rechenlast auf dem eigenen Server/Onlineshop.
- High security standards for communication with TWINT and the storage of sensitive data.
- Easy setup.
To set up via this integration, you can proceed to paragraph 3.1.
Direct integration on your server
With direct integration, your website is connected directly to TWINT. The following are the most important differences to integration via mame:
- The payment process takes place on your server.
- The performance of the payment process depends on the performance of your server.
- Security depends on your WordPress installation and web hosting. The TWINT security certificate is saved in the WordPress installation.
- Subscription payments and the storage of TWINT as a means of payment for future payments are not possible because the storage of the corresponding keys requires increased security standards.
To set up via this integration, you can proceed to paragraph 3.2.
3.1 Integration via mame
Step 1: Enter license key
In the first step, enter the license key that you received via email when you purchased the plugin. You can also find the license in your account at mamedev.ch.
Step 2: Enter API credentials
To receive the API token and the webhook key, you can log in to your mamedev.app account.
If you don’t have an account yet, you can create a new account at mamedev.app/register. To do this you need the license key (see step 1). Alternatively, you can create a user for mamedev.app in your mamedev.ch account.
After logging in, go to the page “Settings > API Settings”. On this page you can generate a new webhook key by clicking on the “Generate new key” button.
On the same page under “Api Tokens > Add Api Token” you can generate a new token. Enter any name (e.g. the name of your shop) and select “TWINT” in the selection field.
Now enter the webhook key and API token in the corresponding fields in the setup assistant.
Step 3: Add store
In the TWINT portal:
In this step, a store must be added to the TWINT portal and linked to the mamedev.app account.
Log in to your TWINT portal account and go to “Settings”. If you don’t already have a bank account under “Accounts”, you can add a new one. The income from sales is transferred to this account.
Then go to “HOME” and click on the “Integrate TWINT” button under “Online shop”.
On the next screen (Basic Information), provide all the required information about your online shop and click “Next”.
In the next screen (connection) you have to select “PSP (payment service provider)” and “mame”.
After the store is added, the Store UUID is displayed. The Store UUID is needed in the next steps.
In the WordPress backend:
Go back to the setup assistant in the WordPress backend and click on the “Add new store” button in step 3. A new window opens to activate the service at mamedev.app and link the TWINT store.
After you have activated the service, the “Add Store” form can be completed and submitted as follows:
- Store name: Any name for identification at mamedev.app and in the WP backend. The name is not displayed to customers.
- Public name: The name of the store as it should be displayed to customers.
- Store UUID (TWINT): Enter the Store UUID of the store that you just created in the TWINT portal (see above).
- Store logo (optional): A logo of size 800px x 400px. This field is optional.
Click on “continue”. If the store was added successfully, you can close the window and continue with the setup assistant. The store should now appear as a selection. If this is not the case, you can click the “Load Stores” button to update the list.
Select the store and click “Next”.
Setup complete
Now all you have to do is activate the WooCommerce payment method and the setup of the TWINT plugin is complete.
It’s best to make a test payment right away. You can refund the payment directly from the order edit screen in the WordPress backend.
3.2 Direct integration via your server
This paragraph can be omitted if the integration has already been carried out via mame (paragraph 3.1).
Step 1: Enter license key
In the first step, enter the license key that you received via email when you purchased the plugin. You can also find the license in your account at mamedev.ch.
Step 2: Enter TWINT parameters
TWINT portal:
You will receive the parameters required for this step in your TWINT portal account:
https://portal.twint.ch
Log in to your TWINT portal account and go to “Settings”. If you don’t already have a bank account under “Accounts”, you can add a new one. The income from sales is transferred to this account.
Then go to “HOME” and click on the “Integrate TWINT” button under “Online shop”.
Fill in the basic information and in the second step (connection) select the integration “Shop plug-in” and “WordPress WooCommerce”.
When adding the first store, a certificate must also be created, which is required for the setup at WooCommerce. To do this, set a password under “Order certificate” and remember it or save it in a safe place. Important: The password will be required again later and can no longer be viewed after the certificate has been created.
If special characters are used for the password, only the following may occur: ~!@#%^*_+-={}[]:,./
The previously added bank account must be selected under “Credit account”.
After the registration in the last step the UUID will be displayed. Keep this value somewhere for later steps. To display the UUID again go to “Stores” and edit the settings of your shop.
On the same page you can also download the certificate, which will later be required for the WooCommerce settings.
WordPress backend:
Go back to the setup assistant in the WordPress backend and enter the Store UUID you just received, the certificate password and any Cash Register ID (e.g. the name of the shop).
Step 3: Convert the TWINT certificate
The certificate downloaded in the previous step can now be uploaded using the “Upload file” button.
If uploading the certificate fails, either the password is incorrect or the certificate could not be converted automatically. On the “Convert TWINT certificate” page you will find further options to convert the certificate into the correct format.
Step 4: Enroll cash register
In the last step, the virtual cash register must be registered once with TWINT. To do this, you can click the “Enroll” button.
Setup complete
Now all you have to do is activate the WooCommerce payment method and the setup of the TWINT plugin is complete.
It’s best to make a test payment right away. You can refund the payment directly from the order edit screen in the WordPress backend.
