PostCode iDeal for nopCommerce 3.50+

Quick installation guide

1. Is this your first purchase at actOpus? If yes then first copy the License Manager plugin folder to the plugins directory

2. Copy the purchased plugin folder to the plugins directory

3. reload your plugins in nopCommerce

4. Is this your first purchase at actOpus? If yes then first install the License Manager plugin. No config needed

5. Install the purchased plugin

6. Register your plugin in the License Manager configuration screen.

7. Configure the purchased plugin

To install this plugin, follow this procedure:

1. First check if you have installed the actOpus License Manager. You should see that plugin in group 'misc' of your plugins. If you don't see the actOpus License Manager then follow the procedure 'How to install the actOpus License Manager'  to install the license plugin.
2. Locate the root folder of your webshop. This folder should contain other folders like 'Administration, bin, Content, Plugins, Themes' and more.
3. Next open the folder 'Plugins'
4. Unzip the contents of the downloaded file into this 'Plugins' folder. The zip file already contains a folder for the plugin 'Payments.Mollie.iDeal' so when you unzip make sure you select the 'use folder names' option. 

Now your 'Plugins' folder should contain a folder named '\Payments.PostcodeiDeal'. Latter should contain a dozen files.

To configure this plugin, follow this procedure:

1. Go to your nopCommerce administration environment.
2. From the top menu 'Configuration', select the sub menu 'Plugins'.
3. Click the button 'Reload list of plugins', usually located just below the right top of the screen.
4. After a minute or so, the list is renewed and you will see the plugin 'iDeal'. Its system name is: Payments.PostcodeiDeal
5. Click on the button 'Install' at the end of the row and wait for the plugin to be installed
6. Now add your license using the actOpus License Manager by following the procedure 'How to add your licenses to the actOpus License Manager' at the end of this page. 
7. Now locate the plugin again in your 'Configuration' page.
8. Click on the button 'Edit', it's just below the plugin. Check 'is enabled' and save.
9. Back in the list: Click on the button 'Configure', it's just below the plugin.

*************Postcode iDeal Settings

0) Download en installeer/plaats OpenSSL. (hier te vinden: 'https://www.openssl.org/source/') 

Voor uw gemak hebben we de 64bits versie van OpenSSL ook in de zipfile plugins gezet.

1) In het Postcode ideal dashboard:
1. Genereer Certificaat
2. Download en open de zipfile
3. Open de file readme.php en zoek de PrivateKeyPass op (zoek op 'Private Key Pass:')
4. Start in de command line 'OpenSSL'
5. Start in de OpenSSL command: pkcs12 -export -in certificate.cer -inkey private.key -out certificate.pfx
6. Geef het gevonden PrivateKeyPass (uit stap 3) op zodra daar om gevraagd wordt (3x achter elkaar waaronder 2x voor EXPORT)

=> Er is nu een 'certificate.pfx' file gemaakt.

7. Maak nu in je webshop onder de directory 'App_Data' de volgende directory aan: 'certificates'
8. Copieer de 'certificate.pfx' file naar je 'certificates' directory (Uit stap 7).

2) Terug in het Postcode ideal dashboard:
9. Download het certificaat met de naam 'postcodenl-testing.cer' of 'postcodenl-production.cer' (afhankelijk van of je een testsysteem of productiesysteem inricht)
10. Copieer de '.cer' file naar je 'certificates' directory. (Uit stap 7)

=> Nu staan er de volgende bestanden in je 'App_Data\certificates\' directory:
certificate.pfx
postcodenl-production.cer of postcodenl-testing.cer

11. Copieer het volledige pad + bestandsnaam naar notepad. Dit heb je nodig in stapen 16 en 18. Doe dit voor beide bestanden

3) in nopCommerce admin

12. Open de Postcode iDeal plugin configuratie
13. Stel de 'Merchant Id:' in op het Merchant ID uit je Postcode Dashboard
14. Stel de 'Merchant Sub Id:' in op 0
15. Stel de 'Acquired url' in op de waarde van Endpoint uit je Postcode Dashboard (Dit is 'https://ideal-test.postcode.nl/ideal' of 'https://ideal.postcode.nl/ideal')
16. Stel de 'Acceptant certificate path' in op het volledige bestandspad naar het certificate.pfx bestand(Uit stap 11).
17. Stel de 'Acceptant certificate password:' in op je PrivateKeyPass uit stap 3.
18. Stel de 'Acquirer certificate path:' in op het volledige bestandspad naar het 'postcodenl-production.cer' of 'postcodenl-testing.cer' bestand.
19. Stel de waarde van 'Poll for payments every n minutes:' in op 10 (De standaardwaarde). Let op: Deze waarde is afgestemd op de eisen van de banken, verander deze daarom niet.
20. Stel de waarde van 'Payment transaction time out' in op 15 (De standaardwaarde). Let op: Deze waarde is afgestemd op de eisen van de banken, verander deze daarom niet.

*****************

1. Set 'Additional fee' to 0.0 if you don't want to charge your customers for this payment method. 
2. 1. When 'Additional fee' is set to a value <> 0.0 then check 'Additional fee. Use percentage' if you want to charge your customer based on a percentage of the order value. In that case the value for 'Additional fee' is interpreted as a percentage in stead of fixed fee.
3. Select 'Direct user to the order details screen' if your want your customer to be redirected to their order screen upon payment (succesfull or unsuccesfull)
4. Click 'Save' 

How to install the actOpus License Manager

1. Locate the root folder of your webshop. This folder should contain other folders like 'Administration, bin, Content, Plugins, Themes' and more.
2. Next open the folder 'Plugins'
3. Unzip the contents of the downloaded file into this 'Plugins' folder. The zip file already contains a folder for the plugin 'Actopus.LicenseManager' so when you unzip make sure you select the 'use folder names' option. 

How to add your licenses to the actOpus License Manager

1. Go to your nopCommerce administration environment.
2. From the top menu 'Configuration', select the sub menu 'Plugins'.
3. Click the button 'Reload list of plugins', usually located just below the right top of the screen.
4. After a minute or so, the list is renewed and you will see the plugin 'actOpus License Manager'. Its system name is:  Actopus.Misc.LicenseManager
5. Click the button 'Configure' (or 'Instellingen'), it's just below the plugin.
6. Click the button 'Add another license', it's just below the wrench icon.
7. In 'the license key' field, paste your license key that has been sent to you by email. Next click the 'Update' button at the end of the row. The license manager will now contact the actOpus server and retrieve the information about your license. 
8. Make sure the Domain/Url column matches your webshop's domain. Contact us if it doesn't match. Remember that your license is linked to the said domain/url and will only work for that domain.
9. Repeat steps 6, 7 and 8 for subsequent licenses.

Continue with the installation of you other plugin.