Hier werden die Unterschiede zwischen zwei Versionen gezeigt.
Beide Seiten der vorigen Revision Vorhergehende Überarbeitung Nächste Überarbeitung | Vorhergehende Überarbeitung Nächste Überarbeitung Beide Seiten der Revision | ||
public:faqoxid2mollie [2020/02/27 11:32] ruedigerhaegele [Konfiguration] |
public:faqoxid2mollie [2020/03/02 13:07] ruedigerhaegele [FAQ] |
||
---|---|---|---|
Zeile 33: | Zeile 33: | ||
Click on "activate" in case you find the module still being deactivated. | Click on "activate" in case you find the module still being deactivated. | ||
====Configuration==== | ====Configuration==== | ||
- | The configuration options of the Mollie Payment module are available in the OXID-admin here: //Extensions -> Modules -> Mollie Payment -> tab "Settings" | + | 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.png?400|}} | ||
- | |**Konfiguration**|**Beschreibung**| | + | {{:public:mollie_konfiguration_details.png?400|}} |
- | |Modus Test/Live|Auswahl zwischen Tesbetrieb und Livebetrieb| | + | |
- | |Test API Key|Tragen Sie hier den Test API Key aus Ihrem Mollie Account ein| | + | |
- | |Live API Key|Tragen Sie hier den LiveAPI Key aus Ihrem Mollie Account ein| | + | |
- | |Ergebnisse von Transaktions-Verarbeitung loggen|Logging von Transaktionen| | + | |
- | |Deaktivierte Zahlarten entfernen|Zahlarten, die im Mollie Account nicht aktiviert wurden werden im Frontend ausgeblendet| | + | |
- | |Icons Anzeigen|Icons der Zahlarten anzeigen| | + | |
- | |Status Ausstehend|Legen Sie den Bestell-Status fest, bevor der Kunde zum Zahlungs-Gateway umgeleitet wird| | + | |
- | |Status In Bearbeitung|Legen Sie den Bestell-Status für Abgeschlossene Zahlungen fest| | + | |
- | ====Usage==== | + | |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| | ||
- | Aktivieren Sie die Mollie Zahlungsarten wie gewohnt unter //Shopeinstellungen -> Zahlungsarten//. | ||
- | Mollie Zahlungsarten werden in den Stammdaten als solche gekennzeichnet. Sollten diese im Mollie Account noch nicht aktiviert sein, wird Ihnen das ebenfalls angezeigt. | + | ====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|}} | {{:public:mollie_zahlart.png?400|}} | ||
- | Sobald die Zahlungarten in Ihrem Mollie account und im Oxid Admin korrekt eingerichtet und aktiviert wurden, stehen Ihnen diese im Checkout des Shops zur Verfügung. | + | 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. |
- | ====Aktivierung von Mollie Components für Kreditkarte==== | + | ====Activation of Mollie Components for credit card==== |
- | Damit Kunden das Kreditkarten-Formular direkt in Ihrem Shop ausfüllen können, müssen Sie in der Konfiguration der Zahlart Credit Card die Option | + | |
- | Kreditkarten-Daten auf "Eingabe im Checkout über Iframe Formular-Felder" stellen: | + | 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|}} | {{:public:molliecreditcardcomponents.png?400|}} | ||
====FAQ==== | ====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==== | ====Support==== |