Benutzer-Werkzeuge

Webseiten-Werkzeuge


public:faqoxid2mollie

Mollie Payments for Oxid 6

Requirements

Installation

  • 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:
"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

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“

no.configuration optiondescription
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.

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“.

FAQ

1. Where can I see orders in the backend?

  1. Login to the OXID-Admin.
  2. Click on the elements as shown in the screenshot below to
    1. Open the menu “Administer Orders”
    2. Select the menu entry “Orders”
    3. Select a specific order
    4. See the tab “Overview” (opened by default)
    5. See the tab “Main” a.s.o.

2. Where can I see refunds in the backend?

  1. Login to the OXID-Admin.
  2. Click on the elements as shown in the screenshot below to
    1. Open the menu “Administer Orders”
    2. Select the menu entry “Orders”
    3. Select a specific order
    4. See the tab “Mollie”, here the refund-functions are provided.

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.

  1. Overview gives a general overview to the order.
    1. To whom?
    2. What?
    3. Price / sum calculation
    4. Status of payment and shipment
    5. Information for internal organization
    6. Shop-wide overview
    7. Shipping-information / setting /sending
  2. Main gives a deeper look at
    1. Order/Invoice-number
    2. Payment
    3. Shipping
  3. Addresses shows
    1. Invoice-address
    2. Shipping-address
  4. Products shows
    1. an editable list of the ordered products
    2. a calculation / sum for this order
  5. History is of no real use and can be safely ignored
  6. Downloads shows information about download-products contained in this order.
  7. Mollie (see question 2.) allows the admin to
    1. perform a full refund of the whole order-sum or
    2. to perform a partial refund on order-position-base

4. Where can I find the settings of the Mollie plugin?

  1. Login to the OXID-Admin.
  2. Click on the elements as shown in the screenshot below to
    1. Open the menu “Extensions”
    2. Select the menu entry “Modules”
    3. Choose “Mollie Payments”
    4. Click on the tab “Settings”
    5. Click on “Basic configuration” to get the settings displayed

5. What settings are possible within the backend?

See the question 4. to get to the settings for the Mollie Payment module.

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?

  1. Try to reproduce the problem in the demo-shop, i.e. go to https://demoshop.rocks/, currently you find here
    1. https://ox611.mollie.demoshop.rocks/admin and try out if the problem exists here, too.
  2. 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.
  3. If you’re technically able: Check the table “mollierequestlog” (see qestion 6 above)in the database for helpful information.
  4. If you don't get the problem solved yourself feel free to contact support@fatchip.de.

8. What are the installation instructions?

  1. Change to the directory „source/modules“ in your OXID eShop installation and create the directory „mollie“.
  2. In this directory create a sub-directory „molliepayment“ and change to it. You find yourself in the path „source/modules/mollie/molliepayment“ now.
  3. 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.
  4. 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"]
    }
  5. Open a command-line on your webserver and execute the following command to regenerate the autoloader-files: vendor/bin/composer dump-autoload
  6. 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.

9. What are the update instructions?

  1. Make a backup of all the shop files. Do not proceed before a complete backup is created and stored locally.
  2. See the installation instructions in question 8.
  3. Copy the files being addressed in 8.3. to their destination and overwrite the existing files with the new ones.
  4. See 8.6.: Go to the OXID-Admin and click the button “Deactivate” and after it changed to “Activate” click it again.
  5. Check the settings and configuration in the OXID-Admin.
  6. Test the Mollie Payment in the frontend, i.e. perform a test-order for each activated Mollie payment-method.

Support

public/faqoxid2mollie.txt · Zuletzt geändert: 2020/03/02 13:07 von ruedigerhaegele