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:
www.payu.com
En la ruta /servidor/apache/rutapublicacion/oscommerce/catalog/includes/languages/english/modules/ payment debe estar el archivo ‘payu_latam.php’. Este archivo está dentro del .zip descargado en la 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-latam1.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 descargado en la ruta
4. Estando en el escritorio de administrador de Oscommerce accede al menú “Modules” y haz clic en “Payment”.
www.payu.com
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”.
www.payu.com
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.
www.payu.com
2. Podrás ver el formulario de configuración.
3. Configura los datos de tu cuenta en PayU Latam de la siguiente manera:
Campo Habilitar/Deshabilitar Merchant ID Account ID API Key
Gateway URL
Modo Transacciones
Página de respuesta
Valor Selecciona la opción ‘True’ para indicar que habilitas la pasarela de pago en Oscommerce. ID del comercio en PayU Latam. ID de la cuenta según el país. Esta es proporcionada por PayU Latam y es único para el comercio. URL de PayU Latam. Para hacer pruebas puedes utilizar la URL https://sandbox.gateway.payulatam.com/ppp-webgateway y para producción https://gateway.payulatam.com/pppweb-gateway/ Si deseas hacer transacciones en modo de prueba, selecciona la opción ‘Test’ de lo contrario seleccione ‘Live’. URL de la página de respuesta. De manera predeterminada aparece la URL http://su.dominio.com/yourOscommerce folder/catalog/response_payu.php, en la cual debe reemplazar “http://su.dominio.com” por el que corresponda
www.payu.com
Página de confirmación
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 Oscommerce. URL de la página de confirmación. De manera predeterminada aparece la URL http://su.dominio.com/yourOscommerce folder/catalog/confirmation_payu.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 Oscommerce.
www.payu.com
4. Por último guarde los cambios 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
www.payu.com
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.