Benutzer-Werkzeuge
public:klarna-en
Unterschiede
Hier werden die Unterschiede zwischen zwei Versionen gezeigt.
| Nächste Überarbeitung | Vorhergehende Überarbeitung Letzte Überarbeitung Beide Seiten der Revision | ||
|
public:klarna-en [2022/04/11 15:55] josefineleuschner angelegt |
public:klarna-en [2024/02/01 14:52] markusmichalski |
||
|---|---|---|---|
| Zeile 3: | Zeile 3: | ||
| OXID eShop Documentation / Manual | OXID eShop Documentation / Manual | ||
| - | | modul version | 5.5.1 – 30.06.2021 | | + | | modul version | 5.5.3 – Stand 22.07.2022 | |
| | modul name | Klarna Checkout and Klarna Payments Module for the OXID eShop | | | modul name | Klarna Checkout and Klarna Payments Module for the OXID eShop | | ||
| | modul category | Bezahlmethoden / Payments \\ This module adds additional payment methods to the OXID eShop. | | | modul category | Bezahlmethoden / Payments \\ This module adds additional payment methods to the OXID eShop. | | ||
| - | | Module vendor | Klarna AB [[https://www.klarna.com/de/verkaeufer/plattformen-und-partner/oxid/|www.klarna.com]] Mail: [[oxid@klarna.com|oxid@klarna.com]] | | + | | Module vendor | Klarna AB [[https://www.klarna.com/de/verkaeufer/plattformen-und-partner/oxid/|www.klarna.com]] Mail: [[shop@klarna.de|shop@klarna.de]] | |
| - | | Development of module | cgrd GmbH [[https://www.cgrd.de|www.cgrd.de]] Mail: [[support@cgrd.de|support@cgrd.de]] | | + | | Development of module | Fatchip GmbH [[https://www.fatchip.de|www.fatchip.de]] Mail: [[support@fatchip.de|support@fatchip.de]] | |
| - | | Klarna Integrations-Support: If no technical contact has been assigned to you by Klarna, please contact: ...\\ If you already process Klarna transactions: [[shop@klarna.de|shop@klarna.de]]\\ Or if you are integrating Klarna right now:[[oxid@klarna.com|oxid@klarna.com]] | | + | | Klarna integrations-support | If you have any questions about Klarna, please contact:[[shop@klarna.de|shop@klarna.de]] | |
| Lizenz: Copyright © 2021 Klarna AB \\ Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at | Lizenz: Copyright © 2021 Klarna AB \\ Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at | ||
| Zeile 47: | Zeile 47: | ||
| === Supported PHP versions === | === Supported PHP versions === | ||
| - | The Klarna Checkout and Klarna Payments Module for the OXID eShop runs with PHP 7.1 up to PHP 7.4. | + | The Klarna Checkout and Klarna Payments Module for the OXID eShop runs with PHP 7.1 up to PHP 8.1. |
| === Update of an already installed Klarna OXID module === | === Update of an already installed Klarna OXID module === | ||
| Zeile 53: | Zeile 53: | ||
| Please make sure to backup your shop files and database before updating. \\ | Please make sure to backup your shop files and database before updating. \\ | ||
| - | If you have OXID eShop version 6.1.3 for instance, this was shipped with Klarna OXID module version 4.2.2. To upgrade the module to latest 5.5.1 version, please follow these steps: | + | If you have OXID eShop version 6.1.3 for instance, this was shipped with Klarna OXID module version 4.2.2. To upgrade the module to latest 5.5.3 version, please follow these steps: |
| Edit the following files in your shop folder: \\ | Edit the following files in your shop folder: \\ | ||
| <code> vendor/oxid-esales/oxideshop-metapackage-ce/composer.json\\ | <code> vendor/oxid-esales/oxideshop-metapackage-ce/composer.json\\ | ||
| vendor/composer/installed.json</code> | vendor/composer/installed.json</code> | ||
| - | find all rows which contain „Klarna“ and replace the version number 4.2.2 with 5.5.1. \\ | + | find all rows which contain „Klarna“ and replace the version number 4.2.2 with 5.5.3. \\ |
| Next, edit the composer.json in your shop root-directory. \\ | Next, edit the composer.json in your shop root-directory. \\ | ||
| Within the „require“ section please add: \\ | Within the „require“ section please add: \\ | ||
| - | <code>"topconcepts/oxid-klarna-6": "v5.5.1"</code> | + | <code>"fatchip-gmbh/oxid-klarna-6": "v5.5.3"</code> |
| Then please delete the file composer.lock from your shop root-directory. \\ | Then please delete the file composer.lock from your shop root-directory. \\ | ||
| Then please remove the following folder completely with its contents: \\ | Then please remove the following folder completely with its contents: \\ | ||
| Zeile 101: | Zeile 101: | ||
| ==== Supported countries / markets ==== | ==== Supported countries / markets ==== | ||
| - | The present Klarna Checkout and Klarna Payments Module for the OXID eShop provides the Klarna Checkout and Klarna Payments for the following countries: SE, NO, FI, DE, AT, CH, NL, UK, BE, IT, ES, FR + KCO global (see https://developers.klarna.com/documentation/klarna-checkout/kco-global/implementation-guidelines – KCO global is available in most other countries in the world, which means that customers from these countries can at least pay by credit card in the Klarna Checkout Iframe.) | + | The present Klarna Checkout and Klarna Payments Module for the OXID eShop provides the Klarna Checkout and Klarna Payments for the following countries: SE, NO, FI, DE, AT, IE, CH, NL, UK, BE, IT, ES, FR + KCO global (see https://developers.klarna.com/documentation/klarna-checkout/kco-global/implementation-guidelines – KCO global is available in most other countries in the world, which means that customers from these countries can at least pay by credit card in the Klarna Checkout Iframe.) |
| To see which products are supported by country, please see the Klarna Developers page: | To see which products are supported by country, please see the Klarna Developers page: | ||
| Zeile 134: | Zeile 134: | ||
| ** (edit composer.json file) ** | ** (edit composer.json file) ** | ||
| - | In your project folder containting the composer.json execute the following command: <code>composer require topconcepts/oxid-klarna-6:v5.5.1</code> | + | In your project folder containting the composer.json execute the following command: <code>composer require fatchip-gmbh/oxid-klarna-6:v5.5.3</code> |
| - | or add the following line to the central composer.json file of your project within the section „require“: <code>"topconcepts/oxid-klarna-6": "v5.5.1"</code> | + | or add the following line to the central composer.json file of your project within the section „require“: <code>"fatchip-gmbh/oxid-klarna-6": "v5.5.3"</code> |
| and then execute the following command: <code>composer update</code> | and then execute the following command: <code>composer update</code> | ||
| There might be dependencies with OXID metapackage when installing deviating module versions which should be taken care of manually. \\ | There might be dependencies with OXID metapackage when installing deviating module versions which should be taken care of manually. \\ | ||
| Zeile 434: | Zeile 434: | ||
| You are not allowed to use the field "Price increase / discount" for Klarna payment methods. | You are not allowed to use the field "Price increase / discount" for Klarna payment methods. | ||
| - | **Do not assign user groups to Klarna Checkout**\\ | + | **Do not assign user groups to Klarna Checkout when allowing guest orders**\\ |
| - | As the Klarna Checkout is also displayed to guest users before registration or login takes place, the payment method "Klarna Checkout" must not be restricted to certain user groups. | + | As the Klarna Checkout is also displayed to guest users before registration or login takes place, the payment method "Klarna Checkout" must not be restricted to any user groups. \\ |
| + | The following also applies to the Shipping Methods and Shipping Cost Rules: There has to be at least one Shipping Method and one Shipping Cost Rule which are not restricted to any user groups. | ||
| ==== Multilingualism ==== | ==== Multilingualism ==== | ||
| Zeile 502: | Zeile 503: | ||
| Regardless of the Klarna Checkout and Klarna Payments Module for the OXID eShop, unfortunately there are some known problems in OXID eShop when processing orders via the OXID Admin Backend: | Regardless of the Klarna Checkout and Klarna Payments Module for the OXID eShop, unfortunately there are some known problems in OXID eShop when processing orders via the OXID Admin Backend: | ||
| - | Bundled products will be deleted from their orders after using forms in order_main or order_article\\ | + | Bundled products will be deleted from their orders after using forms in order_main or order_article https://bugs.oxid-esales.com/view.php?id=5610 |
| - | https://bugs.oxid-esales.com/view.php?id=5610 | + | |
| - | Discount removed from orderitem when adding another discount in oxid admin backend\\ | + | Discount removed from orderitem when adding another discount in oxid admin backend https://bugs.oxid-esales.com/view.php?id=6807 |
| - | https://bugs.oxid-esales.com/view.php?id=6807 | + | |
| We therefore recommend that you refrain from making extensive adjustments to orders using OXID Admin Backend. Only perform the standard processes such as "Capture complete order" or "Cancel order". Since module version 5.4.0 even the full refund of a previously fully captured order can be triggered from the OXID admin backend. All other necessary adjustments to orders and also e.g. partly returns can be carried out conveniently via the Klarna portal. | We therefore recommend that you refrain from making extensive adjustments to orders using OXID Admin Backend. Only perform the standard processes such as "Capture complete order" or "Cancel order". Since module version 5.4.0 even the full refund of a previously fully captured order can be triggered from the OXID admin backend. All other necessary adjustments to orders and also e.g. partly returns can be carried out conveniently via the Klarna portal. | ||
| Zeile 596: | Zeile 595: | ||
| Then another call from Klarna to the push URL in the shop (Klarna field merchant_urls.push, by default in this module: index.php?cl=KlarnaAcknowledge) is made. The result of calling this controller is that the OXID eShop checks once again whether the order has been created and saved properly in the OXID eShop. If successful, the shop sends another confirmation to Klarna. Otherwise the shop will send a cancellation for this order to Klarna. | Then another call from Klarna to the push URL in the shop (Klarna field merchant_urls.push, by default in this module: index.php?cl=KlarnaAcknowledge) is made. The result of calling this controller is that the OXID eShop checks once again whether the order has been created and saved properly in the OXID eShop. If successful, the shop sends another confirmation to Klarna. Otherwise the shop will send a cancellation for this order to Klarna. | ||
| - | **Important** In order for these calls to arrive at the shop and be processed, the shop must be accessible on the one hand via the internet without password protection and on the other hand, both the validation URL and the push URL have to begin with "https: //". Please pay attention to the chapters "SSL encryption" and "Availability of the shop from the internet" in this manual. | + | **Important** In order for these calls to arrive at the shop and be processed, the shop must be accessible on the one hand via the internet without password protection and on the other hand, both the validation URL and the push URL have to begin with <nowiki>"https: //"</nowiki>. Please pay attention to the chapters "SSL encryption" and "Availability of the shop from the internet" in this manual. |
| ---- | ---- | ||
| Zeile 604: | Zeile 603: | ||
| Moreover you can find the current status of development on the Github Repository: | Moreover you can find the current status of development on the Github Repository: | ||
| - | For OXID eShop version 6: https://github.com/topconcepts/OXID-Klarna-6 | + | For OXID eShop version 6: https://github.com/FATCHIP-GmbH/OXID-Klarna-6 |
| ---- | ---- | ||
public/klarna-en.txt · Zuletzt geändert: 2024/04/29 07:35 von markusmichalski
Seiten-Werkzeuge
