Hier werden die Unterschiede zwischen zwei Versionen gezeigt.
Beide Seiten der vorigen Revision Vorhergehende Überarbeitung Nächste Überarbeitung | Vorhergehende Überarbeitung | ||
public:faqoxid2mollie [2020/03/02 13:07] ruedigerhaegele [FAQ] |
public:faqoxid2mollie [2021/04/01 14:06] (aktuell) markusmichalski |
||
---|---|---|---|
Zeile 1: | Zeile 1: | ||
- | =====Mollie Payments for Oxid 6===== | + | ====== OXID Plugin - Mollie Payments ====== |
+ | for Oxid 6 | ||
- | ====Requirements==== | + | ==== Installation and configuration ==== |
- | * Oxid eShop Version 6 or above | + | Read more about the installation, configuration and more of the Mollie-Plugin on the [[https://github.com/mollie/mollie-oxid/wiki|Mollie-Wiki]]. |
- | + | ||
- | * Mollie Account (www.mollie.com) | + | |
+ | ---- | ||
- | ====Installation==== | + | ==== Support ==== |
- | * Change to the directory "source/modules" in your OXID eShop installation and create the directory "mollie" | + | If you need help from FATCHIP, please send a detailed error description including plug-in and shop version to //support@fatchip.de//. |
- | * In this directory create a sub-directory "molliepayment" and change to it. You find yourself in the path "source/modules/mollie/molliepayment" now. | + | |
- | * Use a Git or SVN client to check out the module-files or download the ZIP-file https://github.com/mollie/mollie-oxid/archive/master.zip and extract its content to this directory. | + | |
- | * Open the file **composer.json** in the root-directory of your shop and add this autoload-configuration or add/complete an existing configuration with the following: | + | |
- | + | ||
- | "autoload": { | + | |
- | "psr-4": { | + | |
- | "Mollie\\Payment\\": "./source/modules/mollie/molliepayment" | + | |
- | }, | + | |
- | "files": ["./source/modules/mollie/molliepayment/lib/mollie-api-php/vendor/autoload.php"] | + | |
- | }, | + | |
- | + | ||
- | + | ||
- | Open a command-line on your webserver and execute the following command to regenerate the autoloader-files: | + | |
- | + | ||
- | ''vendor/bin/composer dump-autoload'' | + | |
- | + | ||
- | Login to the OXID-admin of your shop and see the module "Mollie Payment" in the list of modules at //Extensions -> Modules// | + | |
- | + | ||
- | {{:public:mollie_aktivieren.png?400|}} | + | |
- | + | ||
- | Click on "activate" in case you find the module still being deactivated. | + | |
- | ====Configuration==== | + | |
- | The configuration options of the Mollie Payment module are available in the OXID-admin here: //Extensions -> Modules -> Mollie Payment -> tab "Settings"// | + | |
- | + | ||
- | + | ||
- | {{:public:mollie_konfiguration.png?400|}} | + | |
- | + | ||
- | {{:public:mollie_konfiguration_details.png?400|}} | + | |
- | + | ||
- | + | ||
- | |no.|**configuration option**|**description**| | + | |
- | |1|"Mode": "Test" or "Live"|choose if you're still testing or already run the shop live / in production-mode| | + | |
- | |2|"Test API Key"|paste here the "Test API Key" you can find in your Mollie account| | + | |
- | |3|"Live API Key"|paste here the "Live API Key" you can find in your Mollie account| | + | |
- | |4|"Log result of transaction handling"|choose to log the result of transactions being performed| | + | |
- | |5|"Remove deactivated payment types"|choose not to display payment types which haven't been activated in the Mollie account| | + | |
- | |6|"Show icons"|display the icons of the payment types| | + | |
- | |7|"Status Pending"|set the order-status before the customer gets redirected to the payment-gateway| | + | |
- | |8|"Status Processing"|set the order-status for completed payments| | + | |
- | + | ||
- | + | ||
- | ====Usage==== | + | |
- | + | ||
- | Activate payment-types as usual at //Shop Settings -> Payment Methods//. You see if a payment-type is provided by Mollie by selecting it with a click on a list-item, e.g. to "Belfius" or "Credit card". You'll get displayed "This is a Mollie payment type" on top in the tab "Main". It will be displayed, too, if a Mollie payment-type is not activated. | + | |
- | + | ||
- | {{:public:mollie_zahlart.png?400|}} | + | |
- | + | ||
- | As soon as the payment-types are correctly configured in your Mollie Account and the OXID-Admin they are available in the checkout of your online-shop. | + | |
- | ====Activation of Mollie Components for credit card==== | + | |
- | + | ||
- | To allow the customers to enter their credit card data without leaving your online-shop you have to | + | |
- | * select the payment-type "Credit Card" | + | |
- | * choose from the selectbox "Creditcard data": "Input in shop checkout with iframe form inputs". | + | |
- | + | ||
- | {{:public:molliecreditcardcomponents.png?400|}} | + | |
- | + | ||
- | ====FAQ==== | + | |
- | + | ||
- | ===1. Where can I see orders in the backend?=== | + | |
- | + | ||
- | - Login to the OXID-Admin. | + | |
- | - Click on the elements as shown in the screenshot below to | + | |
- | - Open the menu “Administer Orders” | + | |
- | - Select the menu entry “Orders” | + | |
- | - Select a specific order | + | |
- | - See the tab “Overview” (opened by default) | + | |
- | - See the tab “Main” a.s.o. | + | |
- | + | ||
- | {{:public:mollie_faq_1.png?400|}} | + | |
- | + | ||
- | ===2. Where can I see refunds in the backend?=== | + | |
- | - Login to the OXID-Admin. | + | |
- | - Click on the elements as shown in the screenshot below to | + | |
- | - Open the menu “Administer Orders” | + | |
- | - Select the menu entry “Orders” | + | |
- | - Select a specific order | + | |
- | - See the tab “Mollie”, here the refund-functions are provided. | + | |
- | + | ||
- | {{:public:mollie_faq_2.png?400|}} | + | |
- | + | ||
- | ===3. Where can I see shipping information/ship items in the backend?=== | + | |
- | In Question 1. and 2.is already described how to get in the OXID-Admin to the place where information about an order can be found. The tabs (numbered with 4 to 10) mentioned in question 1. will be described one by another below. | + | |
- | + | ||
- | {{:public:mollie_faq_3.png?400|}} | + | |
- | + | ||
- | - Overview gives a general overview to the order. | + | |
- | - To whom? | + | |
- | - What? | + | |
- | - Price / sum calculation | + | |
- | - Status of payment and shipment | + | |
- | - Information for internal organization | + | |
- | - Shop-wide overview | + | |
- | - Shipping-information / setting /sending | + | |
- | - Main gives a deeper look at | + | |
- | - Order/Invoice-number | + | |
- | - Payment | + | |
- | - Shipping | + | |
- | - Addresses shows | + | |
- | - Invoice-address | + | |
- | - Shipping-address | + | |
- | - Products shows | + | |
- | - an editable list of the ordered products | + | |
- | - a calculation / sum for this order | + | |
- | - History is of no real use and can be safely ignored | + | |
- | - Downloads shows information about download-products contained in this order. | + | |
- | - Mollie (see question 2.) allows the admin to | + | |
- | - perform a full refund of the whole order-sum or | + | |
- | - to perform a partial refund on order-position-base | + | |
- | + | ||
- | ===4. Where can I find the settings of the Mollie plugin?=== | + | |
- | - Login to the OXID-Admin. | + | |
- | - Click on the elements as shown in the screenshot below to | + | |
- | - Open the menu “Extensions” | + | |
- | - Select the menu entry “Modules” | + | |
- | - Choose “Mollie Payments” | + | |
- | - Click on the tab “Settings” | + | |
- | - Click on “Basic configuration” to get the settings displayed | + | |
- | + | ||
- | {{:public:mollie_faq_4.png?400|}} | + | |
- | + | ||
- | ===5. What settings are possible within the backend?=== | + | |
- | See the question 4. to get to the settings for the Mollie Payment module. | + | |
- | + | ||
- | {{:public:mollie_faq_5.png?400|}} | + | |
- | + | ||
- | ^No. ^configuration-option ^description ^ | + | |
- | |1|„Mode“: „Test“ or „Live“|choose if you're still testing or already run the shop live / in production-mode| | + | |
- | |2|„Test API Key“|paste here the „Test API Key“ you can find in your Mollie account| | + | |
- | |3|„Live API Key“|paste here the „Live API Key“ you can find in your Mollie account| | + | |
- | |4|„Log result of transaction handling“|choose to log the result of transactions being performed| | + | |
- | |5|„Remove deactivated payment types“|choose not to display payment types which haven't been activated in the Mollie account| | + | |
- | |6|„Show icons“|display the icons of the payment types| | + | |
- | |7|„Status Pending“|set the order-status before the customer gets redirected to the payment-gateway| | + | |
- | |8|„Status Processing“|set the order-status for completed payments| | + | |
- | + | ||
- | ===6. Where can I find the logs?=== | + | |
- | There is a logging accessible for technically enabled users which have access to the MySQL-database of the shop. These can access the table “mollierequestlog” and read the request / response logging being written there. | + | |
- | + | ||
- | === 7. What are the basic things to check while debugging?=== | + | |
- | - Try to reproduce the problem in the demo-shop, i.e. go to https://demoshop.rocks/, currently you find here | + | |
- | - https://ox611.mollie.demoshop.rocks/ respectively | + | |
- | - https://ox611.mollie.demoshop.rocks/admin and try out if the problem exists here, too. | + | |
- | - Check the configuration and settings (see question 4 above). Make sure the “Live API Key” is the one the client/merchant is supposed to use. | + | |
- | - If you’re technically able: Check the table “mollierequestlog” (see qestion 6 above)in the database for helpful information. | + | |
- | - If you don't get the problem solved yourself feel free to contact support@fatchip.de. | + | |
- | + | ||
- | === 8. What are the installation instructions?=== | + | |
- | - Change to the directory „source/modules“ in your OXID eShop installation and create the directory „mollie“. | + | |
- | - In this directory create a sub-directory „molliepayment“ and change to it. You find yourself in the path „source/modules/mollie/molliepayment“ now. | + | |
- | - Use a Git or SVN client to check out the module-files or download the ZIP-file https://github.com/mollie/mollie-oxid/archive/master.zip and extract its content to this directory. | + | |
- | - Open the file composer.json in the root-directory of your shop and add this autoload-configuration or add/complete an existing configuration with the following: | + | |
- | <code> | + | |
- | "autoload": { | + | |
- | "psr-4": { | + | |
- | "Mollie\\Payment\\": "./source/modules/mollie/molliepayment" | + | |
- | }, | + | |
- | "files": ["./source/modules/mollie/molliepayment/lib/mollie-api-php/vendor/autoload.php"] | + | |
- | }</code> | + | |
- | - Open a command-line on your webserver and execute the following command to regenerate the autoloader-files: vendor/bin/composer dump-autoload | + | |
- | - Login to the OXID-admin of your shop and see the module „Mollie Payment“ in the list of modules at Extensions → Modules and click on „activate“ in case you find the module still being deactivated. | + | |
- | + | ||
- | {{:public:mollie_faq_6.png?400|}} | + | |
- | + | ||
- | ===9. What are the update instructions?=== | + | |
- | - Make a backup of all the shop files. Do not proceed before a complete backup is created and stored locally. | + | |
- | - See the installation instructions in question 8. | + | |
- | - Copy the files being addressed in 8.3. to their destination and overwrite the existing files with the new ones. | + | |
- | - See 8.6.: Go to the OXID-Admin and click the button “Deactivate” and after it changed to “Activate” click it again. | + | |
- | - Check the settings and configuration in the OXID-Admin. | + | |
- | - Test the Mollie Payment in the frontend, i.e. perform a test-order for each activated Mollie payment-method. | + | |
- | + | ||
- | + | ||
- | ====Support==== | + |