Benutzer-Werkzeuge
public:klarna-en
Unterschiede
Hier werden die Unterschiede zwischen zwei Versionen gezeigt.
| Beide Seiten der vorigen Revision Vorhergehende Überarbeitung Nächste Überarbeitung | Vorhergehende Überarbeitung | ||
|
public:klarna-en [2022/04/11 15:56] josefineleuschner [Klarna Checkout and Klarna Payments Modul] |
public:klarna-en [2024/04/29 07:35] (aktuell) 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.4 – Stand 29.04.2024 | |
| | 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: [[oxid@klarna.com|oxid@klarna.com]] | | ||
| - | | 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 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]] | | ||
| Zeile 34: | Zeile 34: | ||
| ==== Supported OXID eShop versions ==== | ==== Supported OXID eShop versions ==== | ||
| - | * Community Edition: from version 6.0.0 | + | * Community Edition: Version 6.0.x - 6.5.x |
| - | * Professional Edition: from version 6.0.0 | + | * Professional Edition: Version 6.0.x - 6.5.x |
| - | * Enterprise Edition: from version 6.0.0 | + | * Enterprise Edition: Version 6.0.x - 6.5.x |
| **Please check if you have the right package for your OXID eShop version.** \\ | **Please check if you have the right package for your OXID eShop version.** \\ | ||
| **Do not install this module version if you use another version of the shop!** \\ | **Do not install this module version if you use another version of the shop!** \\ | ||
| 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.4 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.4. \\ |
| 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.4"</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.4</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.4"</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 173: | Zeile 173: | ||
| * Klarna Financing | * Klarna Financing | ||
| * Klarna Pay Now* | * Klarna Pay Now* | ||
| + | * Pay with Klarna | ||
| Assign suitable user groups to the newly created Klarna payment methods, which you would like to use, just as you would for other payment methods in the OXID eShop. This does not apply to the Klarna Checkout (see above). | Assign suitable user groups to the newly created Klarna payment methods, which you would like to use, just as you would for other payment methods in the OXID eShop. This does not apply to the Klarna Checkout (see above). | ||
| Zeile 280: | Zeile 281: | ||
| In Klarna Payments mode, you simply select on this page which Klarna Payments you would like to offer: | In Klarna Payments mode, you simply select on this page which Klarna Payments you would like to offer: | ||
| - | {{:public:faq:klarna-en:konfig-klarna-payments.png?nolink&800|}} | + | {{:public:faq:klarna-en:konfig-klarna-payments_new.png?nolink&800|}} |
| You can find further settings for Klarna Payments on the Design Settings page. | You can find further settings for Klarna Payments on the Design Settings page. | ||
| Zeile 434: | Zeile 435: | ||
| 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 504: | ||
| 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 596: | ||
| 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. |
| ---- | ---- | ||
| ===== Updates of this module ====== | ===== Updates of this module ====== | ||
| - | Updates of the Klarna Checkout and Klarna Payments Module for the OXID eShop will be published in the OXID eXchange marketplace. You can see the current version of your installed module, when you go to „Klarna“ in the OXID Admin area and click „Start“. | + | Updates of the Klarna Checkout and Klarna Payments module for OXID eShop are published on Github. You can see the current version status of your installed module by clicking "Start" in the "Klarna" section of the OXID Admin area. |
| - | + | ||
| - | 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 | + | |
| + | Github repository: https://github.com/FATCHIP-GmbH/OXID-Klarna-6/releases | ||
| ---- | ---- | ||
public/klarna-en.1649685400.txt.gz · Zuletzt geändert: 2022/04/11 15:56 von josefineleuschner
Seiten-Werkzeuge
