The 'ING – iDEAL Advanced V3' variant of the Pronamic Pay plugin can be used to receive iDEAL payments via WordPress with an iDEAL Advanced connection at ING Bank.
Before you start: It is important that the iDEAL Professional contract with ING bank has been completed prior to configuration.
To link the Pronamic Pay plugin to this variant, you need to go through the following steps twice. First time in test mode, with iDEAL dashboard it becomes iDEAL Test Dashboard meant. The second time you enter the steps live mode off and it becomes iDEAL Dashboard meant.
Create iDEAL Advanced v3 configuration
Time needed: 10 minutes
- Installation
Install and activate the Pronamic Pay plugin (refer to the Getting Started manual for instructions).
- Create a configuration
Go to in the menu Payment » Configurations. Choose at the top Add new. Give the configuration a name (for example 'ING – iDEAL Advanced (test)').
- Fill in data
Select or fill in all information. More information.
- Publish
Choose now Publish in the frame Publish.
Data configuration
- Payment Provider: ING – iDEAL Advanced – New platform – Sandbox (or the Production variant for live mode);
- Retailer ID: the Merchant ID (can be found in the bank's iDEAL Dashboard);
- Organisation: legal company name (according to iDEAL Dashboard);
- Department: responsible department within the organization (not mandatory);
- City: location (according to iDEAL Dashboard);
- State or province: province in which the place of business is located;
- Country: 2-letter country code (for example
NL
) - E-mail address: e-mail address of the commercial or technical contact person (according to iDEAL Dashboard)
- Number of days valid: 1825 (this is the maximum of 5 years);
- Private key password: change the randomly generated password if desired (generate via e.g. http://www.random.org/passwords);
Generate private key and certificate
When publishing the configuration, in most cases a private key and private certificate will be automatically created. If so, a button Download certificate displayed to download the certificate. The key and certificate are required for secure communication with the bank. Follow the steps for macOS or Windows to manually create the key and certificate if necessary, then continue with the steps Set private key and certificate.
On macOS:
- Open the program Terminal (to be found in: Programs » Utilities);
- copy the text of the field Private key at the bottom of the configuration and paste it into the terminal window, confirm the input by pressing the ENTER key;
- copy the text of the field Private certificate at the bottom of the configuration and paste it in the terminal window, confirm the input again with the ENTER-keys;
- the private key and certificate are now stored on your computer (probably in the root of the user account).
On Windows:
- Install the OpenSSL Light program (download openssl.zip);
- Start OpenSSL on (found in: installation directory /bin/openssl.exe);
- copy the text of the field Private key at the bottom of the configuration and run it in OpenSSL;
- copy the text of the field Private certificate at the bottom of the configuration and run it in OpenSSL;
- the private key and certificate are now stored on your computer.
The created files must be set in the configuration:
- choose at the field Private key the option to upload a file and select the newly created file filename.key;
- choose at the field Private certificate the option to upload a file and select the newly created file filename.cer;
- choose Updating in the frame To publish.
Set private key and certificate
- Go to it iDEAL Dashboard and choose Profile » 'Security' tab;
- upload the newly created file filename.cer;
- Now open the page of the created iDEAL configuration again in the WordPress dashboard. If no error messages are displayed by Pronamic Pay at the top of the page, the certificate has been successfully set.
Mandatory testing of iDEAL configuration
- Go through the test payments as stated in the box Test;
- check per payment whether it has been successfully checked at Login process » 'Status' tab in the iDEAL Test dashboard;
- if all test payments have been successfully completed and it concerns a new contract with ING Bank, ING Bank will activate the new iDEAL connection. You will receive a message from ING Bank as soon as the activation has taken place;
- with an activated contract, the above steps for setting up a certificate must be completed again, but with the mode set to Live and using the iDEAL Dashboard (instead of the iDEAL Test Dashboard).