If you have any questions or want to report a bug please contact our technical support.
Note: This module works only with REST API
POS type.
If you do not have a PayU merchant account register a production account or register a sandbox account
The following PHP libraries are required: cURL i hash.
Use automatic installation and activation available in the Wordpress admin panel. Look out for WooCommerce PayU EU Payment Gateway
.
The plugin offers the following payment methods:
No. | Method | Blocks | Description |
---|---|---|---|
1 | PayU - standard | ✅ | payer will be redirected to PayU's hosted payment page where any available payment type configured on your POS can be chosen |
2 | PayU - bank list | ✅ | payment type list will be displayed, depending on chosen type the payer will be either redirected directly to the bank or to PayU's hosted payment page |
3 | PayU - payment card | ✅ | payer will be redirected to PayU's hosted card form where credit, debit or prepaid card data can be securely entered |
4 | PayU - secure form | ✅ | a secure form collecting credit, debit or prepaid card data will be displayed |
5 | PayU - Blik | ✅ | payer will be redirected to Blik's page |
6 | PayU - installments | ✅ | payer will be redirected to installment payment form |
7 | PayU - Klarna | ✅ | payer will be redirected to Klarna payment form |
8 | PayU - Twisto | ✅ | payer will be redirected to Twisto payment form |
9 | PayU - PayPo | ✅ | payer will be redirected to PayPo payment form |
- Methods
PayU - standard
andPayU - bank list
enable payments of any type and differ only with the way the payment type is chosen. Should not be configured both at once. - Methods
PayU - payment card
andPayU - secure form
enable card payments and differ only with the way the card data is entered. Should not be configured both at once. - In case
PayU - bank list
method is switched on, the following payment types are removed from the list: cards ifPayU - payment card
orPayU - secure form
is on, Blik ifPayU - Blik
is on, installments ifPayU - installments
is on, Klarna ifPayu - Klarna
is on, Twisto ifPayU - Twisto
is on, PayPo ifPayU - PayPo
is on. PayU - secure form
method requires the shop to be available via HTTPS (for local tests, the address should be http://localhost)- Even if
PayU - payment card
,PayU - secure form
,PayU - Blik
,PayU - installments
,PayU - Klarna
,PayU - Twisto
andPayU - PayPo
are on, they may be not visible in case they are not configured on your POS in PayU system or if the amount is outside min-max range for the given payment type.
Global configuration is available in the main menu as PayU Settings
POS parameters:
Parameter | Opis |
---|---|
POS ID | POS (point of sale) ID in PayU system |
Second key MD5 | Second key (MD5) in PayU system |
OAuth - client_id | OAuth protocol - client_id in PayU system |
OAuth - client_secret | client_secret for OAuth in PayU system |
Sandbox - POS ID | POS (point of sale) ID in Sandbox |
Sandbox - Second key MD5 | Second key (MD5) in Sandbox |
Sandbox - OAuth - client_id | OAuth protocol - client_id in Sandbox |
Sandbox - OAuth - client_secret | client_secret for OAuth in Sandbox |
- In case of using more than one currency, there will be a separate configuration for each available currency - more information in Multicurrency section
- By default, each payment method uses global POS parameters
Other parameters - applicable to all modules:
Parameter | Description |
---|---|
Default order status | Status set after payment is started. Possible values on-hold or pending .< br/>According to the WooCommerce documentation, when warehouse management is enabled for on-hold status, the number of products in the warehouse will be reduced and restored when the order changes to canceled status, for pending status, the inventory levels will not be changed. |
Enable repayment | Allows the payer to try again after failed payment. Before using this option please check Repayment. |
Parameters available for every payment method:
Parameter | Description |
---|---|
Enable / Disable | Enables payment method. |
Name | Name displayed during checkout. |
Sandbox mode | If enabled, payments are done in Sandbox environment using Sandbox settings. |
Use global settings | If not enabled, you need to provide specific settings for given payment method. |
Description | Payment method description displayed during checkout. |
Enable for shipping method | Payment method may be enabled only for specific shipping methods. In case no shipping method is provided, the payment method is enabled for every shipping method. |
Virtual orders | Payment method will be enabled for virtual orders |
Parameters available for PayU - bank list
:
Parameter | Description |
---|---|
Own ordering | To use your own ordering of payment types, you need to provide a comma-separated list of payment types codes from PayU system. Payment types list. |
Show inactive payment methods | In case a given payment type is not active it is still displayed, but greyed out, otherwise not displayed. |
There are two ways to handle multicurrency:
For every currency added to WPML
plugin you can find separate point of sale configuration.
The plugin provides two filters, that allow to add support for multiple currencies during payment
Filter name | Description | Type |
---|---|---|
woocommerce_payu_multicurrency_active |
Should multicurrency service be enabled | bool |
woocommerce_payu_get_currency_codes |
List of currencies ISO codes in ISO 4217 standard e.g. "PLN". | array |
Example:
function payu_activate_multicurrency($active)
{
return true;
}
function payu_set_currency_list($currencies)
{
return ['PLN', 'EUR'];
}
add_filter('woocommerce_payu_multicurrency_active', 'payu_activate_multicurrency');
add_filter('woocommerce_payu_get_currency_codes', 'payu_set_currency_list');
Notes:
- When the
WMPL
plugin is installed and filters are configured, the availability of currencies is checked inWMPL
then through the filters. - Seperate point of sale configurations are available when number of currencies is greater than 1.
Filter Name | Description | Type | Parameters |
---|---|---|---|
woocommerce_payu_status_cancelled |
Order status for CANCELED notification |
string | Order |
This feature enables the payer to create a new payment for the same order if the previous payment was not successful. To use the feature it is necessary to properly configure your POS in PayU, by disabling "Automatic collection" (it is enabled by default). This option is available in PayU panel. You need to 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 button at the very bottom, under the payment type list.
Repayment allows to create many payments in PayU for a single WooCommerce order. The plugin will automatically collect the first successful payment, all other will be canceled. From user point of view, repayment is possible:
- by clicking a link in the order confirmation email
- by clicking "Pay with PayU" link in Actions column in order list
- by clicking "Pay with PayU" link over order details section
Plugin provides seamless integration of installments widget, responsible for presenting minimal installment amount for a given product. Functionality is enabled by default. It can be deactivated in administration panel (WooCommerce->Settings->Payments->PayU - installments). Integration points of a widget have been described in a table below.
Checkbox Installments widget | Description | Presentation |
---|---|---|
Enabled on product listings | Presents "installment from" widget on all product listings. |
|
Enabled on product page | Presents widget on product page. |
|
Enabled on cart page | Presents widget on cart page - relates to a total cart amount and shipping costs. |
|
Enabled on checkout page | Presents widget on checkout page - relates to a total cart amount and shipping costs. |
Widget is presented only for PLN currency and products or carts with amount in allowed installment amount range.
The plugin does not send any additional emails and does not interfere with any mailing process.
In case repayment is configured, the mail confirming order placement is enhanced with information about the possibility to pay the order.