PHP extension:
- SOAP
#####Note: We can only guarantee that the modules work on woocommerce version 2.1.5-2.3.*
#####Before you update to a newer version of WooCommerce, always make a backup as we don’t guarantee functionality of new versions of Woocommerce. We can only guarantee that the modules work in the standard theme and checkout of woocommerce.
If you are using modules under 2.0 of this module (released aug 2015) you first need to remove all old PayEx modules in the plugin folder of your Wordpress installation, usually /wp-content/plugins
-
Sign in as administrator on your wordpress site, click the plugins menu item, then “add new”:
-
Then “upload”. Browse and find the module you want to upload and then click install:
-
When the module have uploaded successfully then you can activate it:
######You can also install the modules using ftp/sftp:
- Unzip the modules on your computer and transfer the folders over to the plugins folder which should be in root/wp-content/plugins/ of your site using FTP/SFTP, the root is where all your wordpress files are.
- Then log on to your wordpress site as admin and go to the plugins menu and click activate on all the modules you installed.
- To configure the modules you have to go to the menu called WooCommerce and click settings.
- Then in the overhead menu you click checkout
- There you can choose which module you want to configure.
Enable/disable: Check the box to enable the plugin
Title: Title of plugin as the user will see it
Description: This controls the title which the user sees during checkout
Account number: You can collect the account number in Payex Merchant Admin; for Production mode and for Test mode. Remember there are different account numbers for test and production mode. For more info contact PayEx support: [email protected].
Encryption key: The encryption key you get in Payex Merchant Admin (Choose md5). Remember there are different encryption keys for test and production mode For more information contact PayEx support: [email protected].
- You need to login to either Production account or Test account.
- Sign in with the information you have been given by PayEx
- In the margin on the left, find “Merchant” and click on “Merchant profile”
- Click on “New encryption key”
Banks: Click to find the selection of banks that work with this module.
Language: The language that the module will display to the user
Test mode: check this box if you want the module to run in test mode
Debug: check this to get debug logs
Enable/disable: Check the box to enable the plugin
Title: Title of plugin as the user will see it
Description: This controls the title which the user sees during checkout
Account number: You can collect the account number in Payex Merchant Admin; for Production mode and for Test mode. Remember there are different account numbers for test and production mode. For more info contact PayEx support: [email protected].
Encryption key: The encryption key you get in Payex Merchant Admin (Choose md5). Remember there are different encryption keys for test and production mode For more information contact PayEx support: [email protected].
Payment type: You can choose between factoring, part payment or user select. On user select the customer will choose either factoring or part payment in the checkout.
Language: The language that the module will display to the user
Test mode: Check this box if you want the module to run in test mode
Debug: Check this to get debug logs
Fee: Set a factoring fee, set 0 to disable
Get address is a supplementary module you can get that only works with the factoring module. What it does is when you enter your social security number if automatically finds and enters your address in the form for you.
Enable/disable: Check the box to enable the plugin
Title: Title of plugin as the user will see it
Description: This controls the title which the user sees during checkout
Account number: You can collect the account number in Payex Merchant Admin; for Production mode and for Test mode. Remember there are different account numbers for test and production mode. For more info contact PayEx support: [email protected].
Encryption key: The encryption key you get in Payex Merchant Admin (Choose md5). Remember there are different encryption keys for test and production mode For more information contact PayEx support: [email protected].
Purchase operation: If AUTHORIZATION is submitted, this indicates that the order will be a 2-phased transaction if the payment method supports it. SALE is a 1-phased transaction.
Payment view: Which type of payment model you would like to use
Language: The language that the module will display to the user
Test mode: Check this box if you want the module to run in test mode
Debug: Check this to get debug logs
Enable/disable: Check the box to enable the plugin
Title: Title of plugin as the user will see it
Description: This controls the title which the user sees during checkout
Account number: You can collect the account number in Payex Merchant Admin; for Production mode and for Test mode. Remember there are different account numbers for test and production mode. For more info contact PayEx support: [email protected].
Encryption key: The encryption key you get in Payex Merchant Admin (Choose md5). Remember there are different encryption keys for test and production mode For more information contact PayEx support: [email protected].
Purchase operation: If AUTHORIZATION is submitted, this indicates that the order will be a 2-phased transaction if the payment method supports it. SALE is a 1-phased transaction.
Language: The language that the module will display to the user
Max amount: A limit on how much a order can have
Agreement URL: Url to the user/payment agreement
Test mode: Check this box if you want the module to run in test mode
Debug: Check this to get debug logs
To translate the modules you need a program called poedit. The files you need to translate are located in wp-content/plugins/woocommerce-gateway-payex/languages/
Every module have their own pot file that will be used to translate in to your desired language.
- Simply open up the .pot file with poedit and select the line which you want to translate and in the bottom row add the translation.
- The translation will appear in the right column of the main window.
- When you’re done don’t forget to set the language in the top right to the language you just translated to.
Important: When you’re done, save the file as a .po file. And the file needs to be named with the language code of your country. So for example if you translated the woocommerce-gateway-payex module to german then the file should be named payex-de_DE
The language code of your country can be found here: http://www.lingoes.net/en/translator/langcode.htm.
To change to the language that you just translated to you just need open wp-config and change the language to the translated one, IE for german its should say:
define('WPLANG', 'de_DE');
Transaction callback is an extra process used by PayEx to verify that the webshop is informed of the result of the payment processing. It is useful if your server goes down during payment or if customer close the webbrowser or lose connection just after payment. Callback is a required functionality.
Use the following URL: http://siteurl.net/?wc-api=WC_Gateway_Payex
Change siteurl.net for your shop's url
-
You'll find logfiles of the payment module at [wordpress-root]/wp-content/uploads/wc-logs
-
There have been cases where the total cost of a product in the cart and the total in the payex payment view isn’t the same. That would be because of woocommerce rounding the total up or down because of lack of decimals. To fix this you have to add decimals to your products cost.
- To do this you login as admin
- Click woocommerce and then settings
- There under general look for “Number of decimals” and set them to 2 and then save the changes.