VirtueMart

This article shows you the procedure to enable PayU on your VirtueMart website.

Prerequisites

  • You need an active account in PayU Latam.
  • For VirtueMart version 2 or higher:
    • Having the PayU’s VirtueMart plugin downloaded and stored in an accessible location. Click here to download it.
    • Having VirtueMart version 2 or higher installed.
    • Your VirtueMart website must be installed on Joomla!® 2.5 or higher with MySQL 5.1 or higher.
  • For VirtueMart version 3.0.6:
    • Having the PayU’s VirtueMart plugin downloaded and stored in an accessible location. Click here to download it.
    • Having VirtueMart version 3.0.6 installed.
    • Your VirtueMart website must be installed on Joomla!® versions 3.3.6, 2.5.28 or 2.5.27.

Plugin for VirtueMart 2 or higher

Follow the next procedure to install and configure the plugin on your website.

Installation

  1. Open the Joomla!® Administrator Console and select the Extension Manager option located in the Extension menu.

PrintScreen

  1. In the Upload Package File section, click Browse and locate the .zip file of the PayU plugin downloaded.

PrintScreen

  1. Once the installation procedure completes, a message appears to inform that the installation was successful.

PrintScreen

Configuration

  1. Expand the option Shop in the VirtueMart menu and select Payment methods. Then, click New at the top right of the screen.

PrintScreen

  1. In the Payment Method Information tab, set Payulatam as Payment Name and select PayuLatam in the Payment Method field.

PrintScreen

  1. Go to the Configuration tab and provide the information of your account and your API key.

PrintScreen

Furthermore, provide the connection URL to the gateway and the configuration variables explained in the Configuration variables section.

The URLs for test and production environments are:

  • Test: https://sandbox.gateway.payulatam.com/ppp-web-gateway
  • Production: https://gateway.payulatam.com/ppp-web-gateway/
  1. Finally, click Save or Save & Close button. At this point, your customers can pay with PayU Latam using the VirtueMart shopping cart.

Plugin for VirtueMart 3.0.6

Follow the next procedure to install and configure the plugin on your website.

Installation

  1. Open the Joomla!® Administrator Console and select the option Extension Manager inside the Extensions menu.

PrintScreen

  1. In the Extension package file field, choose the previously downloaded .zip file.

PrintScreen

  1. Once the .zip file is loaded, click Upload & Install.

PrintScreen

  1. Once the installation procedure completes, a message appears to inform that the installation was successful.

PrintScreen

Configuration

  1. In the left menu, click Manage. Find and enable the PayuLatam plugin.

PrintScreen

A message appears informing that you have enabled the plugin. Furthermore, the icon changes to a check mark.

PrintScreen

  1. Open the Components menu and expand the Virtuemart option. Then, select Payment Methods.

PrintScreen

  1. In the opened window, click New to create a payment method using the PayuLatam plugin.

PrintScreen

  1. In the Payment Method Information tab, set Payulatam as Payment Name and select PayuLatam in the Payment Method field.

PrintScreen

  1. Go to the Configuration tab and provide the information of your account and your API key.

PrintScreen

Furthermore, provide the connection URL to the gateway and the configuration variables explained in the Configuration variables section.

The URLs for test and production environments are:

  • Test: https://sandbox.gateway.payulatam.com/ppp-web-gateway
  • Production: https://gateway.payulatam.com/ppp-web-gateway/
  1. Finally, click Save or Save & Close button. At this point, your customers can pay with PayU Latam using the VirtueMart shopping cart.

Configuration variables

Regardless of the VirtueMart version you use, set and configure the following variables in your plugin:

Field Value
Logo Logo displayed for the PayuLatam payment method.
Test URL Gateway URL for test: https://sandbox.gateway.payulatam.com/ppp-web-gateway.
Production URL Gateway URL for production: https://gateway.payulatam.com/ppp-web-gateway.
Test Mode Select Yes if you want to make transactions in the test environment. When you enable this option, VirtueMart uses the URL configured in the Test URL variable
Merchant ID ID of your commerce in PayU Latam.
Account ID ID of the PayU account according to the country where you want to sell.
API Key Unique key of your commerce, you can find this key in the PayU module.
Section ORDER STATUS PARAMS
  • Approved Transactions
  • Pending Transactions
  • Declined Transactions
Defines the order state in VirtueMart according to the transaction state returned by PayU. We suggest keeping the default states; nevertheless, you can configure them according to your business needs.
Currency Set USD. Also, you can configure the currency of the Account ID country.
Minimum Value / Maximum value The total value of an order must be within this range to activate the PayuLatam payment method.
Tax To use this option, configure the corresponding VirtueMart rule to the associated tax. For example, IVA for Colombia.
Last modified June 24, 2022: clon issue (d73e43fe)