mspPayU

Getting started

Download mspPayU from the MODX Simple Dream add-on store.

To accept PayU payments you must first apply for registration.

For integration help contact technical support, the developer in Minsk, or PayU support. PayU also has detailed documentation.

PayU setup

Important

Use only the test environment to verify payments.

Basic store–PayU integration flow

1. Customer visits your site and builds a cart.
2. Customer goes to PayU to pay.
3. PayU notifies your site of successful payment; your site confirms receipt.
4. Your site requests payment confirmation from PayU; PayU responds.
5. Optional refund: your site requests cancellation from PayU. (not yet supported in this module)

In short: your site builds an LU request with payment data and sends it to PayU; PayU processes it and calls your callback URL to report the result.

Set the URL for IPN notifications in PayU: https://secure.payu.ru/cpanel/ipn_settings.php.

URL format: http://site.ru/assets/components/minishop2/payment/payu.php?action=notify, where site.ru is your site.

Installation and MODX setup

During installation enter your PayU credentials.

1. Merchant ID — store (merchant) ID from registration.
2. Secret key — issued at registration.

You can skip and fill these later in system settings.
Enable the payment method in miniShop2 and add it to the required delivery method.

To switch from test to live, set ms2_payment_payu_developer_mode from "Yes" to "No".

System settings reference

Key	Name	Default	Description
ms2_payment_payu_merchant_id	Store (merchant) ID in PayU		Unique merchant ID from registration.
ms2_payment_payu_secret_key	Secret key		Issued at registration. Used for signature and payment verification.
ms2_payment_payu_checkout_url	Checkout URL	https://secure.payu.ru/order/lu.php	URL where the user is sent to pay.
ms2_payment_payu_developer_mode	Test payment mode	Yes	"Yes" — all requests go to PayU test environment.
ms2_payment_payu_currency	Payment currency	RUB	ISO 4217 code.
ms2_payment_payu_language	PayU language	RU	Two-letter language code for the payment page.
ms2_payment_payu_success_id	Success page	0	Resource ID after successful payment. Use cart page.
ms2_payment_payu_failure_id	Failure page	0	Resource ID after failed payment. Use cart page.
ms2_payment_payu_success_payment_id	Order status on success	2	Order status ID on successful payment. Edit in miniShop2.
ms2_payment_payu_cancel_payment_id	Order status on cancel	4	Order status ID on cancelled payment. Edit in miniShop2.