MANUAL DE INSTALACIÓN Y CONFIGURACIÓN

PLUGIN PAYU LATAM
OSCOMMERCE
MANUAL DE INSTALACIÓN Y CONFIGURACIÓN
PLUGIN PAYU LATAM PARA OSCOMMERCE
Oscommerce es una plataforma desarrollada en PHP que facilita la creación de una tienda en
línea. Para que tus clientes puedan pagar a través de PayU desde su sitio en Oscommerce se debe
instalar el plugin de PayU Latam para Oscommerce el cual integra a PayU Latam como una
pasarela de pago válida.
Prerrequisitos:
-
Tener una cuenta en PayU Latam.
Tener instalado Oscommerce versión 2.3.
Instalación del plugin de PayU Latam en Oscommerce:
1. Descargar el plugin de PayU Latam para Oscommerce que encontrarás en esta sección.
2. Descargarás un archivo .zip con nombre ‘oscommerce-payu-latam-1.0.zip’.
3. Por FTP o ingresando como administrador al servidor donde está instalado tu sitio de
Oscommerce, ubica manualmente los archivos del plugin de la siguiente forma:
En la ruta /servidor/apache/rutapublicacion/oscommerce/catalog deben estar los archivos
‘confirmation_payu.php’ y ‘response_payu.php’. Estos archivos están dentro del .zip descargado
en la ruta C:\usuario\Descargas\oscommerce-payu-latam-1.0\catalog:
En la ruta
/servidor/apache/rutapublicacion/oscommerce/catalog/includes/languages/english/modules/pay
ment debe estar el archivo ‘payu_latam.php’. Este archivo está dentro del .zip descargado en la
PAYU LATAM / www.payulatam.com
1
PLUGIN PAYU LATAM
OSCOMMERCE
ruta C:\usuario\Descargas\oscommerce-payu-latam1.0\catalog\includes\languages\english\modules\payment:
Así debe hacer con los lenguajes español y portugués si los tiene instalados en su sitio
Oscommerce. Estos archivos están dentro del .zip descargado en la ruta
C:\usuario\Descargas\oscommerce-payu-latam-1.0\catalog\
includes\languages\(español/portugues)\modules\payment.
NOTA: El plugin de PayU Latam para Oscommerce está disponible para los idiomas inglés,
portugués y español únicamente.
En la ruta /servidor/apache/rutapublicacion/oscommerce /catalog/includes/modules/payment
debe estar el archivo ‘payu_latam.php’. Este archivo está dentro del .zip descargado en la ruta
C:\usuario\Descargas\oscommerce-payu-latam-1.0\catalog\ includes\modules\payment:
4. Estando en el escritorio de administrador de Oscommerce accede al menú “Modules” y haz clic en
“Payment”.
PAYU LATAM / www.payulatam.com
2
PLUGIN PAYU LATAM
OSCOMMERCE
5. Luego haz clic en el botón “Install Module” y elije el módulo “PayU Latam”. En la parte derecha
aparecerá la información del plugin, haz clic en el botón “Install Module”.
PAYU LATAM / www.payulatam.com
3
PLUGIN PAYU LATAM
OSCOMMERCE
PAYU LATAM / www.payulatam.com
4
PLUGIN PAYU LATAM
OSCOMMERCE
6. Después de instalar el módulo aparecerá la lista de los módulos instalados con el módulo de PayU
Latam elegido.
Configuración de la pasarela de pago PayU Latam en Oscommerce:
1. Haz clic en el botón “Edit” ubicado en la parte derecha de la página.
2. Podrás ver el formulario de configuración.
PAYU LATAM / www.payulatam.com
5
PLUGIN PAYU LATAM
OSCOMMERCE
3. Configura los datos de tu cuenta en PayU Latam de la siguiente manera:
Campo
Valor
Habilitar/Deshabilitar
Selecciona la opción ‘True’ para indicar que habilitas la
pasarela de pago en Oscommerce.
Merchant ID
ID del comercio en PayU Latam.
Account ID
ID de la cuenta según el país.
API Key
Esta es proporcionada por PayU Latam y es único para el
comercio.
Gateway URL
URL de PayU Latam. Para hacer pruebas puedes utilizar la
URL https://stg.gateway.payulatam.com/ppp-web-gateway
y para producción https://gateway.payulatam.com/pppweb-gateway/
Modo Transacciones
Si deseas hacer transacciones en modo de prueba,
selecciona la opción ‘Test’ de lo contrario seleccione ‘Live’.
Página de respuesta
URL de la página de respuesta. De manera predeterminada
PAYU LATAM / www.payulatam.com
6
PLUGIN PAYU LATAM
OSCOMMERCE
aparece
la
URL
http://su.dominio.com/wpcontent/plugins/woocommerce-payu-latam/response.php,
en la cual debe reemplazar “http://su.dominio.com” por el
que corresponda a su sitio. El resto de la URL debes dejarla
como está si deseas utilizar la página de respuesta que
viene integrada en el plugin de PayU Latam para
Woocommerce.
Página
confirmación
de URL de la página de confirmación. De manera
predeterminada
aparece
la
URL
http://su.dominio.com/wpcontent/plugins/woocommerce-payu-latam/response.php,
en la cual debes reemplazar “http://su.dominio.com” por
el que corresponda a su sitio. El resto de la URL debes
dejarla como está si desea utilizar la página de
confirmación que viene integrada en el plugin de PayU
Latam para Woocommerce.
PAYU LATAM / www.payulatam.com
7
PLUGIN PAYU LATAM
OSCOMMERCE
4. Por último guarde los cambios.
PAYU LATAM / www.payulatam.com
8
PLUGIN PAYU LATAM
OSCOMMERCE
5. Asegúrate de que los estados de las órdenes fueron creados según los idiomas (inglés, español y
portugués) que tienes instalados en Oscommerce.
6.
-
Los estados que deben existir son:
Para español: ‘Aprobada’, ‘Rechazada’, ‘Fallida’ y ‘Pendiente’.
Para ingles: ‘Approved’, ‘Rejected’, ‘Failed’ y ‘Pending’.
Para portugués: ‘Aprovado’, ‘Recusada’, ‘Falha’ y ‘Pendente’.
Si al momento de la instalación del plugin no tienes instalado uno o dos de los idiomas nombrados
anteriormente los estados no se van a crear pero si más adelante instalas alguno puedes crear los
estados manualmente pero estos deben llamarse exactamente como se indicaron anteriormente.
Ahora tus clientes podrán pagar mediante PayU Latam cuando hagan checkout en el carrito de
compras de Oscommerce.
PAYU LATAM / www.payulatam.com
9
PLUGIN PAYU LATAM
OSCOMMERCE
PAYU LATAM / www.payulatam.com
10
PLUGIN PAYU LATAM
OSCOMMERCE
PAYU LATAM / www.payulatam.com
11
PLUGIN PAYU LATAM
OSCOMMERCE
Oscommerce redirigirá al cliente a la pasarela de pagos de PayU Latam.
PAYU LATAM / www.payulatam.com
12
PLUGIN PAYU LATAM
OSCOMMERCE
PAYU LATAM / www.payulatam.com
13