Plugin Pagadito para VirtueMart plg_joomla_1.0.0 Junio 2012 developers@pagadito.com
En toda comunicación con Pagadito respecto a este documento, por favor refiérase a la fecha ubicada en la portada. Copyright El uso, divulgación, reproducción, modificación, transferencia o transmisión de este documento; para cualquier propósito, en cualquier forma o medio, sin el consentimiento escrito de Pagadito, queda prohibido. Copyright 2012 Pagadito, S. de R.L. Reservados todos los derechos. Pagadito y el Logo de Pagadito son marcas registradas de Pagadito S. de R.L. Todas las otras marcas son propiedad de sus respectivos dueños.
Licenciamiento Pagadito Plugin para VirtueMart PLG_JOOMLA_1.0.0 Copyright 2012 Pagadito S. de R.L. Este programa es Software Libre: puede redistribuirlo y/o modificarlo bajo los términos de la Licencia Pública General Reducida de GNU (GNU Lesser Public Licence), tal como se encuentra publicada por la Free Software Foundation, ya sea por su versión 3 o cualquier otra versión superior. Este programa es distribuido en el espíritu de que sea útil, pero SIN NINGUNA GARANTÍA: sin garantía implícita de MERCANTIBILIDAD o ADAPTABILIDAD PARA UN USO PARTICULAR. Vea la licencia GNU LGPL para mayores detalles. Si desea una copia de la licencia GNU LGPL puede visitar http://www.gnu.org/licenses/ Información Importante Pagadito PlugIn Todo desarrollo de aplicación utilizando el Plugin de Pagadito está regido por el Acuerdo de Tecnología de Pagadito. Los siguientes son requerimientos clave para este acuerdo. Para mayor información, refiérase al Acuerdo de Tecnología de Pagadito. Países Permitidos Este documento solamente puede ser usado en los países en que Pagadito S. de R.L. tiene operaciones. Uso Ninguna aplicación podrá ser desarrollada o modificada de manera que permita la distribución a terceros de la información recibida por medio de API, Web Service, Plug In o cualquier otra pieza de software liberada por Pagadito, que no sean las personas que tengan derecho legítimo a dicha información y con fines distintos a los expresados en el registro del Pagadito Comercio.
Requerimientos Técnicos Para hacer uso de este plugin, deberá cumplir con los siguientes requerimientos: Cuenta Válida y Activa en Pagadito Comercios o Pagadito SandBox. Instalación funcional de Joomla! o 1.5 o 1.6 o 1.7 o 2.5 Componente VirtueMart 2.0.+ Descargas Puede descargar nuestro Plugin Pagadito para procesamiento de pagos para VirtueMart 2.0.+ y para otras tecnologías en esta URL: https://dev.pagadito.com/ Requisitos para el uso del Plugin - Tener un sitio web propio, funcionando en VirtueMart, Joomla. - Tener conocimientos de administración del sitio web. - Tener acceso a las opciones de administración del sitio web.
Instalación Ingrese a Administración del web en Joomla! Por lo general, se ingresar a través de la URL de su sitio web: Ejemplo: www.misitioweb.com/administrator/ (cambie misitioweb por el nombre de su sitio) Una vez haya ingresado al Administrador, sitúese en el menú Extensiones e ingrese la opción Gestor de Extensiones. En el Gestor de Extensiones, busque la opción Instalar. En la sección de Subir Archivo de Paquete, haga clic en el botón Seleccionar archivo: seleccione el archivo que descargó del Plugin Pagadito (plg_pgvm-v.1.0.0.zip) y haga clic en el botón Subir e Instalar.
Se mostrará un mensaje de confirmación: plugin Instalada correctamente
Activación Una vez instalado Plugin Pagadito, necesita activarlo. En el menú Extensiones ingrese a la opción Gestor de Plugins. En la lista de Gestor de Plugins, busque el Plugin Pagadito: VM Payment, Pagadito. Para encontrarlo más rápido, haga clic en Seleccionar Tipo (recuadro rojo en la imagen) y luego en vmpayment.
En la columna Estatus, haga clic sobre el círculo de color rojo correspondiente al Plugin. Luego, se mostrará un mensaje de confirmación: Plugin publicado correctamente
Configuración Ingrese a Administración del componente VirtueMart. En el menú, busque la opción Componentes y haga clic sobre VirtueMart. En el Panel de Control de VirtueMart ubique y haga clic en el botón Métodos de Pago.
En la pantalla Métodos de Pago, haga clic en el Botón Nuevo (recuadro rojo en la imagen) En la pestaña Información del método de pago, complete la información. Ponga especial atención a los campos Publicado y Método de pago, los cuales tienen que quedar así: Publicado Método de pago Si VM Payment, Pagadito
Haga clic sobre el botón Aplicar (recuadro rojo en la imagen) y se mostrará un mensaje de confirmación: Método de pago guardado correctamente
Haga clic en la pestaña Configuración. En esta pantalla, complete la información solicitada, de acuerdo a sus necesidades y a su cuenta de Pagadito creada. A continuación de la imagen se detallan los campos que se solicitan. Logos En la instalación por default del Plugin Pagadito se incluyen dos imágenes de botones Pagadito para mostrar en el sitio a la hora de efectuar el pago. btn_pagadito1.png btn_pagadito2.png UID WSK Sandbox UID Id de usuario de nuestra cuenta Pagadito Comercios. El key o clave de conexión para el web service de Pagadito. Id de usuario de nuestra cuenta Pagadito Sandbox.
Sandbox WSK Sandbox Currency Minimum Amount Maximum Amount Fee per transaction El key o clave de conexión para el web service en Pagadito Sandbox. Permite activar o desactivar la conexión, a través de Pagadito Sandbox, en un ambiente para pruebas y desarrollo Acá se muestran el listado del as monedas que habilitó en las configuraciones de su tienda en VirtueMart. NOTA: Pagadito solo acepta las siguientes monedas: Quetzales, Dólares (US), Lempiras, Córdobas, Balboas y Pesos Dominicanos. Acá puede fijar el mínimo de las transacciones a procesar para pagos. Acá puede fijar el máximo de las transacciones a procesar para pagos. Podemos establecer un cargo fijo por transacción realizada para cada pago que se realice. Finalmente haga clic en el botón Guardar y luego en Cerrar. En la pantalla de Método de pago, se mostrará el listado de las configuraciones ya guardadas correctamente en su Plugin Pagadito.
Credenciales y URL de Retorno. Estos datos puede encontrarlos en su Cuenta Pagadito Comercio (Producción o Sandbox) al iniciar sesión bajo Configuraciones -> Credenciales de Conexión. Configure la URL de Retorno de la siguiente manera: Cambie únicamente www.mitienda.com por la URL de su tienda y deje intacto el resto. Ejemplo: http://www.mitienda.com/index.php?option=com_virtuemart&view=pluginresponse&task=pluginresponsereceived& token={value} Puede copiar y pegar las credenciales UID y WSK en las configuraciones de Pagadito, pero asegúrese que al copiarlos no lleve espacios. developers@pagadito.com