If you have any questions or issues, feel free to contact our technical support.
Note: Plugin version 2.x supports PrestaShop versions 1.4 and 1.5, but is not developed anymore.
The PayU payments PrestaShop plugin adds the PayU payment option and enables you to process the following operations in your e-shop:
Plugin version 3.x supports PrestaShop versions 1.6 and 1.7
| Feature | PrestaShop 1.6 | PrestaShop 1.7 / 8 / 9 |
|---|---|---|
| Creating a payment order (with discounts included) | ✅ | ✅ |
| Capturing a payment order (when auto-capture is disabled) | ✅ | ✅ |
| Conducting a refund operation (whole or partial) | ✅ | ✅ |
| Displaying payment methods on Presta checkout summary page | ✅ | ✅ |
| Card payment as separate method | ✅ | ✅ |
| Card payment via widget on summary page | ✅ | ✅ |
| Payment retry for cancelled payments | ✅ | ✅ |
| Repayment | ✅ | ✅ |
| Multi-currency support | ✅ | ✅ |
| Payment method order | ✅ | ✅ |
| PayU Installments payment as separate method | ✅ | ✅ |
| Klarna payment as separate method | ✅ | ✅ |
| PayPo payment as separate method | ✅ | ✅ |
| Twisto payment as separate method | ✅ | ✅ |
| Twisto Pay in 3 payment as separate method | ✅ | ✅ |
| PragmaPay as separate method | ✅ | ✅ |
| Present credit widget on product and listing page | ✅ | ✅ |
| Present credit widget in checkout view | ✅ | ✅ |
| Present credit widget in cart view | ❌ | ✅ |
| Excluding credit payment methods from credit widget | ✅ | ✅ |
More information on the features can be found in the More on features section
All instructions regard PrestaShop 1.7, for other versions corresponding options should be used.
Important: This plugin works only with 'REST API' (Checkout) points of sale (POS). If you do not already have PayU merchant account, please register in Production or please register in Sandbox
The following PHP extensions are required: cURL and hash.
recommended for users without FTP access to their PrestaShop installation
- Download file
payu_prestashop_plugin_X.Y.Z.zipfrom releases - Go to the PrestaShop administration page [http://store-address/adminxxx].
- Go to 'Modules and Services' > 'Modules and Services'.
- Use 'Add a new module' option and point the archive containing the plugin (downloaded in step 1)
- Load the plugin
recommended for users with FTP access to their PrestaShop installation
- Download file
payu_prestashop_plugin_X.Y.Z.zipfrom releases - Unzip locally downloaded file
- Upload all unzipped files from your computer to
modules/payucatalog of your PrestaShop installation.
- Update plugin files according to Installing
- Go to 'Modules and Services' > 'Modules and Services' - automated upgrade will be performed if required
- Go to Advanced Parameters > 'Performance' and click 'Clear cache'
- Go to the PrestaShop administration page [http://store-address/adminxxx].
- Go to 'Modules and Services' > 'Modules and Services'.
- Search and select 'PayU' and click 'Configure'.
| Parameter | Description |
|---|---|
| Bank List | Yes choosing the PayU payment method will be possible on checkout page when selected Pay by online transferNo after placing an order on PrestaShop, you will be automatically redirected to PayU.Do not enable these options if you are using PrestaShop and OPC modules more info. |
| Payment method order | enables custom payment method ordering more info |
| Card payment as separate method | sets card payment as separate method more info |
| Card payment widget | renders a widget on Presta summary instead of redirecting to PayU more info |
| BLIK payment as separate method | sets BLIK payment as separate method |
| Sandbox mode | Yes - transactions will be processed on PayU Sandbox environmentNo - transactions will be processed on PayU production environment |
| Save logs | Specifies whether the plugin will save information to logs. |
For each currency defined in Presta please configure the below parameters (separately for sandbox and production environment).
| Parameter | Description |
|---|---|
| POS ID | Unique ID of the POS |
| Second Key | MD5 key for securing communication |
| OAuth - client_id | client_id for OAuth |
| OAuth - client_secret | client_secret for OAuth |
Mapping PayU payment statuses to PrestaShop order statuses
| Name | PayU payment status | Default value in Presta |
|---|---|---|
| Started - status after placing order | PayU payment started | |
| Complete status | COMPLETED |
Payment accepted |
| Canceled status | CANCELED |
PayU payment canceled |
If the Control of status changes option is enabled for statuses "Complete" and "Canceled", it is possible to switch only from statuses "Pending" and "Waiting For Confirmation".
Applies only to Payment methods displayed on Presta checkout summary page switched to Yes
To set the order of the payment method icons enter payment method values separated by comma.
Payment method values.
POS in PayU system has only one currency defined. Therefore to accept payments in more currencies, POS for each currency has to be separately configured. Error ERROR_INCONSISTENT_CURRENCIES means an unsupported currency by POS. Contact with PayU service is required when approving the payment option in a different currency for the sandbox mode and a separate agreement for the production mode.
When the Payment methods displayed on Presta checkout summary page parameter is set to Yes, payment method icons will be displayed directly within the PrestaShop page when the 'PayU with PayU' button is clicked.
The icons are displayed basing on POS configuration.
After payment method icon is selected and 'I confirm my order' button clicked, the buyer is redirected to bank or PayU card form.
If Card payment as separate method option is enabled, a method named Pay by card will be displayed in PrestaShop checkout process.
If the Payment methods displayed on PrestaShop checkout summary page option is set to Yes, then Pay by card will be displayed only if card payments are configured on your POS ID. If this option is set to No, then Pay by card will always be visible, but may fail if card payments are not configured.
IMPORTANT - this feature will work only if "tokenization" is enabled on your POS ID in PayU. To enable it, please contact our technical support.
If Card payment as separate method and Payment methods displayed on Presta checkout summary page are set to Yes then the Pay by card option will render a widget to collect card data instead of redirection to PayU card form page.
If the Enable Google Pay option is enabled in the configuration, the Pay with Google Pay method will appear in the list of payment methods during the PrestaShop checkout process. After selecting this method, the buyer will be redirected to the Google Pay payment window.
Parameters available for Google Pay:
| Parameter | Description |
|---|---|
| Google Merchant Id | Merchant identifier in Google. You need to verify your shop in Google, following the instructions. |
| Google Merchant name | Merchant name is rendered in the payment sheet. |
This feature enables the payer to create a new payment for the same order if the previous payment was not successful.
To use this feature, you need to properly configure your POS in PayU by disabling "Automatic collection" (it is enabled by default). This option is available in the PayU panel. Go to Online payments, then My shops, and then POS. Automatic collection is configured for every payment type, but to disable all at once you can use the button at the very bottom, under the payment type list.
Repayment allows creating multiple payments in PayU for a single PrestaShop order. The plugin will automatically collect the first successful payment, all others will be canceled. From the user point of view, repayment is possible:
- by clicking a link in the order confirmation email
- in order details
All PayU payments created for a PrestaShop order are displayed on the Order screen in the PrestaShop admin panel.
Plugin provides a functionality of promoting installments and Buy Now Pay Later payment methods (also called "credit payments") by separating individual payment methods in the checkout view and displaying a credit payments widget on product and listing pages, in the checkout, and cart views. Promoting installment and Buy Now Pay Later payment methods is configured in the "Credit payments" section of the plugin's configuration page. Separating PayU Installments and credit payments widget are enabled by default. Support for given functionalities has been described in Features section.
Presenting credit widgets is dependent on gateways availability for the given point of sale (POS). The plugin automatically checks whether "ai", "dpt", "dpcz", "dpts", "dpkl", "dpklczk", "dpkleur", "dpklhuf", "dpp", "dppron", "ppf" gateways are enabled. If a given credit payment method hasn't been enabled on the configured POS, it won't be presented in the checkout view or the credit payments widget even if it is enabled in the plugin's configuration.
| PrestaShop Version | Category | How it looks |
|---|---|---|
| 1.7 | Products listing |  |
| 1.7 | Product page |  |
| 1.7 | Cart |  |
| 1.7 | Installments as separate method |  |
| 1.7 | PayPo payment as separate method |  |
| 1.7 | Klarna payment as separate method |  |
| 1.7 | Twisto payment as separate method |  |
| 1.7 | Twisto Pay in 3 payment as separate method |  |
| 1.7 | PragmaPay payment as separate method |  |
| 1.6 | Products listing |  |
| 1.6 | Product page |  |
Depending on the available credit payment methods, hyperlinks appear in the above-mentioned site sections in one of three variants: "Installment from", "0% installment from" or "Pay later". After clicking such a hyperlink, the newest version of the "miniInstallment" component will appear on the screen. It comes with the PayU Installments - best practices package, which can be found in the official documentation.
The credit payments widget ("miniInstallment" component) looks as below:
Since version 3.3.0 it's possible to exclude the specified credit payment methods from the widget using the "Exclude credit payment methods from widget" field in the plugin's configuration. For example, filling the field with these values: dpp,dpkl,dpt will result in PayPo, Klarna, and Twisto disappearing from the widget:
Due to the fact that OPC modules build their own checkout page, some options (e.g. Card payment as separate method, BLIK payment as separate method, and separation of installment methods) may not work.