nexi-ecom/oxid6_easy

Nexi Payment Module for Oxid 6

Maintainers

Details

github.com/Nets-eCom/oxid6_easy

Homepage

Source

Issues

Installs: 76

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 2

Forks: 2

Open Issues: 0

Type:oxideshop-module

2.0.1 2023-10-05 14:03 UTC

Requires

  • php: >=7.0

AGPL-3.0-or-later eae6572d5b8b1cf8fb13829d510a8f61549a6ebc

moduleseshopOXID

This package is not auto-updated.

Last update: 2024-05-17 11:56:00 UTC

README

==============================================================

Module Nets Easy Payment Module for Oxid 6
Author Nets eCom
Prefix EASY-OX6
Shop Version 6+
Version 2.0.1
Guide https://tech.nets.eu/shopmodules
Github https://github.com/Nets-eCom/oxid6_easy

📝 NOTE :

1. After version update, we advise to deactivate and reactivate extension again.
2. This version upgrade contains significant changes that can prevent charges/refunds on past transactions. Shall you experience any issue with charges/refunds from Oxid Admin Panel, we advise to proceed to charges/refunds directly from the Easy portal.

Download / Installation

1] Install Nets Plugin:

Run command: composer require nexi-ecom/oxid6_easy

2] Activate the Nets module:

vendor/bin/oe-console oe:module:activate esnetseasy

Configuration

  1. To configure and setup the plugin navigate to : Admin > Extensions > Modules
  2. Locate and select Nets Easy plugin from the list of installed plugins.
  3. Select the Overview tab and press the Activate button. If the Nets Easy has been installed correct you will now see a green checked circle under active column next Nets Easy on your list.
  4. To activate your new payment method and setup the plugin for your shop navigate to : Admin > Shop Settings > Payment Methods
  5. Payment methods are listed in alphabetical order on multiple pages. Find or search for Nets Easy and select.
  6. On Main tab make sure to check the Active box. NOTE : Name and Payment Description input fields can be used for a customized description of the Nets Easy plugin to your customers on selection of payment methods.
  7. Once assigned User Groups and Countries and translations if needed then remember to Save.
  8. Navigate back to the plugin settings : Admin > Extensions > Modules > Nets Easy
  9. Select the Settings tab and press on Nets Easy settings to reveal the content of configuration settings.

Configuration for split payment methods

You can either activate the Nets Easy Payment Method, which allows the user to choose all payment methods that are enabled for you, or you can activate individual payment methods. To configure individual payment methods, go to Admin > Shop Settings > Payment Methods. There you can see a list of all of the Nets payment methods that you can activate.

Note: Be careful while activating the payment method. You have to enable only those payment methods that are enabled for you. If you activate a payment method that is not enabled for you, then the user will not be able to complete the transaction.

If you don't want to enable the individual payment method, you can simply activate the "Nets Easy" payment method. It shows all payment options to the user in the Nets payment window that are enabled for you.

Steps to activate an individual payment method: Here we are activating the "Nets Easy - Cards" payment method.

  1. Go to Admin > Shop Settings > Payment Methods. There, you can see the payment method "Nets Easy - Cards"
  2. To activate that payment method, click on it, then go to the main tab and check the Activate box and click on Save.
  3. Once you activate that payment method, assign user groups and countries.
  4. You can assign the payment method to specific shipping methods. To configure that, go to Admin > Shop Settings > Shipping Methods.

Here, you can see a list of all shipping methods. Select the shipping method for which you want to add it above the payment method. Then go to the Payment tab of the shipping method, where you can assign a payment method by simply dragging and dropping.

Nets plugin configuration settings

  1. Mode. Select between Test/Live transactions. Live mode requires an approved account. Testcard information can be found here : https://tech.dibspayment.com/easy/test-information
  2. Test / Live keys. Login to your Nets Easy account. Keys can be found in Company > Integration : https://portal.dibspayment.eu/
  3. Terms Url. Set the url for your Terms and Conditions page.
  4. Merchant Terms Url. Set the url for your Terms of use and Cookies page. NOTE : Term Links can be found inside the Nets Easy payment window.
  5. Icons bar url. Set and customize icons listing by editing directly in parameters in the url or visit our custom Icons url generator : https://easymoduler.dk/icon/
  6. Checkout Type. Hosted / Embedded. Select between 2 checkout types. Hosted - Nets Hosted loads a new payment page. Embedded checkout inserts the payment window directly on the checkout page.
  7. Embedded Checkout Layout. Layout 1 / Layout 2. Select between 2 layouts for your Embedded checkout
  8. Auto-capture. This function allows you to instantly charge a payment straight after the order is placed. NOTE. Capturing a payment before shipment of the order might be liable to restrictions based upon legislations set in your country. Misuse can result in your Easy account being forfeit.
  9. Debug. This function will reveal raw api data that you can copy / paste in case you experience errors on your transactions. Data will be visible in order details. This is intended to be used when contacting Nets support.

Operations

  • cancel / capture / refund - Partial capture/refund
  1. Navigate to admin > Administer Orders > Orders. Select an Order payed through Nets Easy.
  2. Choose your desired function :
    • Fully cancel / charge / refund your order.
    • Partially charge / refund your order. NOTE :
    • Partial functionality handles items in your order as blocks. Custom amount is not possible.
    • Use -/+ to adjust quantity for partial functionality.
    • Press partial button to execute action per line.
  3. All transactions by Nets are accessible in our portal : https://portal.dibspayment.eu/login
  4. Payment status is real-time and updated in Order details even if you make the changes in Nets Easy Portal.

Troubleshooting

  • Nets payment plugin is not visible as a payment method
  • Ensure the Nets plugin is activated in Shop Settings and in the Extensions plugin configuration.
  • Ensure the Nets plugin is assigned in available listings in various User Groups and Countries.
  • Various User Groups, Countries and Payment Methods setup listings can be found in Admin > Shop Settings : Payment Methods and Shipping Methods
  • Nets payment window is blank
  • Ensure your keys in Nets plugin Settings are correct and with no additional blank spaces.
  • Temporarily deactivate 3.rd party plugins that might effect the functionality of the Nets plugin.
  • Check if there is any temporary technical inconsistencies : https://nets.eu/Pages/operational-status.aspx
  • Payments in live mode dont work
  • Ensure you have an approved Live Easy account for production.
  • Ensure your Live Easy account is approved for payments with selected currency.
  • Ensure payment method data is correct and supported by your Nets Easy agreement.
  • How do I choose currency or language in the payment window?
  • Currency and Language is based on customers selection on the frontend shop page.
  • A complete list of supported currencies and languages can be found here

Contact

  • Nets customer service
  • Nets Easy provides support for both test and live Easy accounts. Contact information can be found here

** CREATE YOUR FREE NETS EASY TEST ACCOUNT HERE : https://portal.dibspayment.eu/registration **