Skip to content

Latest commit

 

History

History
157 lines (119 loc) · 7.95 KB

README.EN.md

File metadata and controls

157 lines (119 loc) · 7.95 KB

Wersja polska

PayU module for Magento 2 version 2.4

BREAKING CHANGES

Due to changes described in CHANGELOG after updating plugin from version 1.X to 2.X, you must reconfigure plugin.

If you have any questions or if you want to report an error, please contact our support at the address: tech@payu.pl.

Table of contents

  1. Properties
  2. Requirements
  3. Installation
  4. Configuration
  5. Information about properties

Properties

PayU payment module adds a PayU payment option to Magento 2. The module works together with Magento 2 version 2.4

The following operations are possible:

  • Creation of payment in the PayU system
  • Automatic receipt of notifications and change of order status
  • Receipt or rejection of payment (in case of switched off automatic receipt)
  • Display of payment method and selection of the method on the order summary page
  • Payment by card directly on the order summary page
  • Remembering of cards and payment with the remembered card
  • Repeat payment
  • Creation of online refund (full or partial)

The module adds two payment methods:

methods

  • PayU payment - selection of payment method and redirection a bank or card form
  • Card payment - entry of the card number directly on the store's website and payment by card

Requirements

Important: The module works only with the REST API (Checkout) POS, if you don't have an account in the PayU system yet, register yourself in the production system or in the sandbox system

  • PHP compliant with the requirements of the installed version of Magento 2
  • PHP extension: cURL and hash.

Installation

Using Composer

composer require payu/magento24-payment-gateway

By copying files to a server

  1. Download the latest version of the module from the GitHub repository
  2. Unzip the downloaded file
  3. Connect to the ftp server and copy the unzipped files to the folder app/code/PayU/PaymentGateway of your Magento 2 store. If there is no such folder, create it.

After installation using Composer or copying files from the console's level, run:

  • php bin/magento module:enable PayU_PaymentGateway
  • php bin/magento setup:upgrade
  • php bin/magento setup:di:compile
  • php bin/magento setup:static-content:deploy

Configuration

  1. Go to the administration page of your Magento 2 store [http://adres-sklepu/admin_xxx].
  2. Go to Stores > Configuration.
  3. On the Configuration page in the menu on the left-hand side, in the section Sales choose Payment Methods.
  4. On the list of available payment methods choose PayU or PayU - Cards to configure the plugin's parameters.
  5. After changing the parameters click Save config.

API Parameters

Point of sale (POS) parameters

Parameter Descripction
POS IdD POS ID from PayU system
Second MD5 key Second MD5 key from PayU system
OAuth - client_id client_id for OAuth protocol from PayU system
OAuth - client_secret client_secret for OAuth from PayU system

POS parameters - Test mode (Sandbox)

Available when the parameter Test Mode (Sandbox) is set for Yes.

Parameter Description
POS ID POS ID from PayU system
Second MD5 key Second MD5 key from PayU system
OAuth - client_id client_id for OAuth protocol from PayU system
OAuth - client_secret client_secret for OAuth from PayU system

"PayU Payment" parameters

Parameter Description
Activate the plugin? Determines whether the payment method will be available in the store on the list of payments.
Sandbox mode Determines whether payments will be performed in PayU (sandbox) test environment.
Order of payment methods Determines the order of the payment methods being displayed more information.
Activate repeat payment? more information

"PayU - Cards" parameters

Parameter Description
Activate the plugin? Determines whether the payment method will be available in the store on the list of payments.
Sandbox mode Determines whether payments will be performed in PayU (sandbox) test environment.
Activate repeat payment? more information
Activate remembering of cards? more information

Information about properties

Order of payment methods

To determine the order of display of payment method icons indicate the payment method symbols, separating them with a comma. List of payment methods.

Repeat payment

To use this option the POS should be properly configured in PayU and automatic receipt of payments should be disabled (auto-receipt is on by default). To do that log in to the PayU panel, go to the tab "Electronic payments", then click "My stores" and POS in the given store. The "Automatic payment receipt" option can be found at the bottom under the list of payment methods.

Repeat payment makes it possible to activate multiple payments in PayU to a single order in Magento. The plugin will automatically take receipt of the first successful payment while the other ones will be cancelled. Repeat payment from the buyer's point of view is also possible through the list of orders in Magento (a link "Pay again" will appear there). The buyer will also automatically receive an e-mail with such link. Thus, the buyer is able to successfully pay for his order even if the first payment was unsuccessful (for instance, no funds on the card, problems logging in to the bank, etc.).

Saving cards

Saving card allows logged in users to remember the card for future payments. Each such remembered card is "tokenized", however, Magento does not process the card's full details in any way (they are entered using an embedded widget hosted by PayU) and does not save card tokens in its database (before use, current tokens for the given user are always downloaded from PayU).

To ensure proper functioning of the service additional configuration in PayU, consisting in creating and receiving tokens, is required. Additionally, the principles of authenticating payments with the remembered card can also be determined (by default every payment with a saved card requires providing a CVV code and being authenticated by 3DS but, for instance, an amount limit up to which this will not be necessary can be defined).

The buyer may save the card while making a payment, using the option "Use and save" on PayU widget while entering the card's details. Each card being remembered is subject to strong authentication during first payment (CVV and 3DS). A saved card will appear after choosing to pay with a card through PayU for the order and is visible in the user's account (tab "My saved cards"), where an option to delete it is also available.