=== Woo Swish e-commerce === Contributors: BjornTech Tags: swish, ecommerce, payment, woocommerce, swish-handel Requires at least: 4.9 Tested up to: 5.2.2 Requires PHP: 7.0 Stable tag: 2.0.7 License: GPLv3 or later License URI: http://www.gnu.org/licenses/gpl-3.0.html Accept Swish payments in your webshop. == Description == Our plugin makes it possible for you to accept Swish as payment method in your webshop. This payment method suits you if you want to offer your customers fast, simple and safe mobile payments. As addition to the plugin you need the service "Swish för handel" that you order from one of the Swedish banks offering the service. Ask your bank if it does. "Swish för handel" is a special service developed for e-commerce and differs from the normal private "Swish" service and the corporate "Swish företag". Some banks have made it possible to order the service online in their internet bank but most of the banks still require a filled in and signed form to be sent in. The plugin supports three connection methods described below: ### Technical supplier Swish offers the possiblity to use a technical supplier when connecting your webshop to your bank. This is the easiest way to use the plugin. You select BjornTech as "Teknisk leverantör" in your internet bank and configure the plugin to use a technical supplier. The possibility to select a technical supplier is new and all banks have not yet implemented the functionalty in their systems. We have an ongoing dialouge whith the banks and will update the table below with information on when they are ready with their implementations. Swedbank: Yes, you can select "Teknisk leverantör" in the internet bank. SEB: Not ready. Work ongoing. No date set for go-live. Nordea: Not ready. Work ongoing. Ready "after summer". Handelsbanken: Not ready. Work ongoing. No information on go-live. Länsförsäkringar Bank: Not ready. No information on status Danske Bank: Not ready. No information on status `If your bank is not ready yet, please ask them.` ### Local certificate If your bank is not supporting the choice of technical supplier you can create a certificate of your own and place it on your webserver. You will find instructions for doing this in our installation description. The creation and installation of a local certificate is a complicated process that requires technical competence. If you do not have this technical competence you can let us do the work. We do this based on a fixed cost. Contact us at swish@bjorntech.se for more information. ### Simulator If you just want to see how the plugin will look like in your webshop or if you need to test payments in your staging or test environment you can configure the plugin to simulate payments. A payment done via the simulator is done by a pre-configured fictive mobile number and will be automatically approved by the system. Because of this you can not see how the payment will look like in the Swish-app == Installation == ### Installation instructions for technical supplier 1. Locate and add the plugin in wordpress by searching for "Swish". 2. Activate the plugin through the "Plugins" menu in WordPress. 3. Order the "Swish handel" service from your local Swedish bank. 4. Select BjornTech as your Technical provider. This is done in your bank website. 5. Select "BjornTech Swish Service" as Connection type. 6. Enter your merchant swish number in the field "Swish merchant number" and your mail address in the "Account mail address" field. Save the settings. 7. Click "Connect to service". 8. When the confirmation mail arrives in your inbox open it and click on the activation link. 9. Make a test payment to confirm that everything is working. ### Installation instructions for local certificate `The process below requires technical skills.` 1. Locate and add the plugin in wordpress by searching for "Swish". 2. Activate the plugin through the "Plugins" menu in WordPress. 3. Order the "Swish handel" service from your local Swedish bank. 4. Generate private key and CSR, at https://comcert.getswish.net/ (see https://developer.getswish.se/content/uploads/2019/03/Swish-Certificate-Management-Guide.pdf) ##### Using cpanel: > Select "SSL/TLS" at the "Security" section > Select "Private Keys (KEY)" > Scroll down to "Generate a New Private Key" and select the key size of 4096. Type "Swish" in the "Description"-field Click "Generate" > Select "Return to SSL Manager" > Select "Certificate Signing Requests (CSR)" > In the "Key" field select the keyname that you entered creating the keys (in our example it was "Swish") > > Enter the following: > Domains: yourwebsite.name > State: State/Province > Country : Sweden > Company: Your company name > Company Division: Department or leave blank > Email: your@email.se > Passphrase: Select password if you want (remember if and enter it in the Payment-Swish admin screen) > Description: A description or leave blank > > Select "Generate" > > copy the data in the "Encoded Certificate Signing Request"-field and use it at in step 5 below. ##### Using MacOs terminal or Linux via SSH: `` $ openssl genrsa -out ./swish.key 4096 $ openssl req -new -sha256 -key ./swish.key -out ./swish.csr `` > Enter the following: > Country Name (2 letter code) - SE > State or Province Name (full name) - State/Province > Locality Name (eg, city - City > Organization Name (eg, company) - Your company name > Organizational Unit Name (eg, section) - Department or leave blank > Common Name (eg, fully qualified host name) - yourwebsite.name > Email Address - your@email.se > A challenge password - Select password if you want (remember if and enter it in the Payment-Swish admin screen) 5. Use the data that you copied from cpanel or the file "swish.csr" created in command line to create a swish-certificate at https://comcert.getswish.net/cert-mgmt-web/authentication.html (must be done by a certified person from step 3) Login using your (swedish) personal id, your organisation number and your swish-number (starting with 123) Click on the tab "new certificate" Paste the contents from cpanel or your "swish.csr"-file from step 4 into the field "Paste CSR" and make shure that the format "PEM" is selected. Click "Generate" to create the certificate. Copy and paste the certificate data to a file with the ending .pem (in our example swish.pem) 6. Open your swish.pem file and paste the content from your swish.key file in the top of the file. Copy everything (including the header and footer) between: -----BEGIN RSA PRIVATE KEY----- and -----END RSA PRIVATE KEY----- and put it before -----BEGIN CERTIFICATE----- -----END CERTIFICATE----- -----BEGIN CERTIFICATE----- -----END CERTIFICATE----- -----BEGIN CERTIFICATE----- -----END CERTIFICATE----- 7. Place the certificate file somewhere in your server filesystem. Use FTP or filemanager in cpanel if avaliable. Make a note on the full file-path and name of your certificate. 8. Configure and activate plugin. Select "Use local Swish certificate" as your connection preference Input the location of the certificate from step 7. If you did create the certificate in step 4 using a password, you need to input this on the configuration screen Input your merchant swish number Change the rest of the configuration parameters as you wish. Save the settings. 9. Make a test payment to ensure that everything is working as it should. == Frequently Asked Questions == Q: I have a private Swish account (using my mobile number). Can I use this number as merchant number in the plugin? A: No, you need the service "Swish handel". Contact your bank to order it. Q: I have a corporate Swish account (starting with 123). Can I use this number as merchant number in the plugin? A: No, you need the service "Swish handel". Contact your bank to order it. == Screenshots == == Changelog == = 2.0.7 = * Fix: Some translations did not upload to Wordpress correctly. = 2.0.6 = * Fix: Config from previous version was not properly converted to the new. = 2.0.5 = * New: Certificate service added, no creation of certificate needed for customers using Swedbank (more banks coming soon). * New: New modal checkout layout, select it in the configuration page. It is not working with all themes. Contact us if you have issues with modal checkout in your theme. = 1.6.2 = * Verified to work with WooCommerce 3.6.2 = 1.6.1 = * Fix: Incompatibility with WooCommerce easy table rate shipping caused a fatal error. = 1.6.0 = * Verified to work with Wordpress 5.1 * Change: Minor text changes. = 1.5.0 = * Added: Support for systems using NSS = 1.4.0 = * Verified to work with Wordpress 5.0.0 * New: Start Swish-app can be shown in checkout page, setting possibility also added. = 1.3.0 = * Added: Nonce used for callback to increase security. * Fix: Customer number now correct on transaction = 1.2.3 = * Fix: Wrong link to swish settings page from the plugins page. * Change: Test mode moved to own section and described better. Test mode disabled as default. * Change: Removed activation hook, certificate distributed in pluin. = 1.2.2 = * Added how to merge the key-file and the certificate file = 1.2.1 = * Better instructions on how to create the Swish certificate (still not optimal and to complex) = 1.2.0 = * Tested and verified with WooCommerce 3.5 * Test cert now distributed with plugin, download if missing = 1.1.2 = * One more fix to make sure that test certs will be loaded when downloading from Wordpress = 1.1.1 = * Test-certificate was not working Fix to make the test certificate do download when activating * Description for the gateway was missing in settings = 1.1.0 = * Test certificate is now included in the package. You can run test transactions just by enabling test mode, nothing more required. * Some logging removed = 1.0.5 = * Better Installation instructions = 1.0.4 = * Minor changes = 1.0.3 = * Minor changes (language, images) = 1.0.2 = * Correcting stable release number. = 1.0.1 = * Small fix to check the correct Wordpress version. = 1.0.0 = * Initial public release. == Upgrade Notice ==