This plugin is released under the GPL license.
If you have any questions or issues, feel free to contact our technical support: tech@payu.pl.
PayU account is a web application designed as an e-wallet for shoppers willing to open an account, define their payment options, see their purchase history, and manage personal profiles.
Note: This is an alpha release and we are still working on plugin improvements.
- Business area
- Configuration Parameters (Poland)
- Configuration Parameters (Romania, Turkey, Russia, Ukraine, Hungary)
- Settings of external resources
The PayU payments Prestashop plugin adds the PayU payment option and enables you to process the following operations in your e-shop:
- Creating a payment order (with discounts included)
- Cancelling a payment order
- Conducting a refund operation (for a whole or partial order)
Important: This plugin works only with checkout points of sales (POS).
The following PHP extensions are required:
- cURL to connect and communicate to many different types of servers with many different types of protocols.
- hash to process directly or incrementally the arbitrary length messages by using a variety of hashing algorithms.
- XMLWriter to wrap the libxml xmlWriter API.
- XMLReader that acts as a cursor going forward on the document stream and stopping at each node on the way.
To install the plugin, copy folders from the repository and activate the plugin on the administration page:
- Download plugin from the plugin repository to local directory as zip.
- Unzip locally downloaded file
- Create zip archive of payu directory
- Go to the PrestaShop administration page [http://your-prestashop-url/admin].
- Go to Modules > Modules.
- Add new module and point archive contained plugin (created at point 3)
- Load the plugin
To configure the PrestaShop plugin:
- Go to the PrestaShop administration page [http://your-prestashop-url/admin].
- Go to Modules > Payments & Gateways.
- Select PayU and click Configure.
Important: In order to enable the customers to make payments with OneStepCheckout, you must go to Preferences > Orders and set Enable guest checkout to Yes.
This section define merchant business area. Other seection depends on this setup. It means that there might be different merchant configuration for Poland and Turkey merchant. Details are described in next sections.
The tables below present the descriptions of the configuration form parameters.
The main parameters for plugin configuration are as follows:
Parameter | Values | Description |
---|---|---|
Self-Return Enabled | Yes/No | If self-return is disabled, the payment must be confirmed manually. |
Order Validity Time | 24h/12h/6h/1h/30min | Specifies the time during which the order is valid in the PayU system. When validity time expires, the order is cancelled, and you are notified that the transaction failed. |
Ship Abroad | Enabled/Disabled | If ship abroad is disabled, you can only choose the country of the shop for shipping. |
OneStepCheckout Enabled | Yes/No | Specifies whether buying from cart via Payu is enabled. Important: In order to enable the customers to make payments with OneStepCheckout, you must go to Preferences > Orders and set Enable guest checkout to Yes. |
Important: There is no test environment (Sandbox) for this version of module and you can set Test Payment method in your POS settings in the PayU system, before you deploy your shop to production enivronment.
Parameter | Description |
---|---|
POS ID | Unique ID of the POS |
Second Key | MD5 key for securing communication |
The tables below present the descriptions of the configuration form parameters. The main parameters for plugin configuration are as follows:
Parameter | Values | Description |
---|---|---|
Merchant | - | Unique ID of the merchant |
Secret Key | - | Key for securing communication |
IPN | On/Off | Instant Payment Notification makes possible the automated processing of each authorized order in the online payment system, being a link between the PayU servers and your servers. When your shop receives an IPN for an order, if IPN is set to On, the status of the order will become Payment accepted. If IPN is set to Off and your merchant account settings in PayU are in accordance with this, the status of the order will become Payment accepted when the buyer is redirected from PayU payment page back to your shop. |
IPN URL | - | After an order gets authorized and approved, the PayU sends a data structure containing all the order related info to this URL on your system. |
IDN | On/Off | Instant Delivery Notification -- This request will be sent by your shop to PayU when you click Confirm delivery in the order page. Confirming delivery triggers the capture of the order amount from the credit card. Confirm delivery will be available for an order only if its status is Payment accepted and IDN is On. If PayU confirms the success of the IDN, the order status in your shop will be Delivered. If IDN fails for some reason, the status of the order will remain unchanged. |
IRN | On/Off | Instant Refund/Reverse Notification makes it possible for you to automate the sending of reverse/refund requests for orders paid through PayU, directly from your shop's order page. You may perform multiple refunds if your merchant account in the PayU platform allows it. If PayU confirms the success of the IRN, the status of the order in your shop will be Refund. If IRN fails for some reason, the status of the order will remain unchanged. |
Notes:
- The parameters must be set in accordance with your merchant account's settings in the PayU platform.
- IPN, IDN and IRN will automatically change the status of the orders. When you manually change the status of the order, your shop will not send any notification to PayU.
You can set external resources for the following:
Parameter | Description |
---|---|
Payment button | URL address of the button image for OneStepCheckout |
Payment logo | URL address of the logo image that is visible in the list of payment methods |
Payment adverts | URL address of the PayU advertisement for your page |
Payment accept | URL address of the We accept PayU payments banner |