Joomla Integration Guide V1.0.0
User Manual:
Open the PDF directly: View PDF 
.
Page Count: 10
Guía de Integración Joomla versión 1.0.0
1. 1. Pasos para configurar el plugin First Data Gateway en Joomla
Requerimientos del Servidor:
El primer paso en la configuración es instalar Joom junto con el plugin First Data Gateway y
VirtueMart. Pero antes de hacerlo, debería verificar su entorno de hosting. A modo de guía,
recomendamos:
PHP : 5.6 + o 7 +( memory_limit=64M,upload_max_filesize = 20M,post_max_size =
20M,max_execution_time=120)
MySQL :5.5.3 +. (soporte InnoDB requerido)(Joomla soporta PostgreSQL y SQL Server
también)
Apache : 2.4 + (con mod_mysql, mod_xml y mod_zlib habilitados)
VirtueMart: El primer plugin First Data Gateway compatible con VirtueMart 3.2.14 La
instalación de VirtueMart necesita los mismos requerimientos que Joomla. Para más detalles
sobre los requerimientos técnicos de Joomla y VirtueMart, visite:
https://downloads.joomla.org/technical-requirements
http://virtuemart.net/download
2. Cómo instalar nuestro plugin First Data Gateway en Joomla y VirtueMart
En la solapa “Extensiones”de Joomla, ir a “Instalar”. Aquí puede cargar el código fuente del
plugin First Data Gateway a través del cargador de archivos.
En la sección “Administrar”, puede encontrar el plugin cargado como se muestra a
continuación. Habilitar el módulo si el estado aparece como deshabilitado con una cruz
roja.
En la solapa VirtueMart de Joomla, ir a la sección “Métodos de Pago” y crear un nuevo
Método de Pago. Puede ver la siguiente página
Seleccionar el Método de Pago “VM-Payment, firstdata “.Configurar los otros campos
según sus requerimientos y hacer clic en “Guardar”
Ahora puede configurar el plugin First Data en la solapa configuración.
Configuración de Plugin:
Localización: Seleccionar el país y un distribuidor que desee configurar para el plugin First
Data Gateway del menú desplegable de país y distribuidor respectivamente.
Mostrar el logo: Si desea mostrar el logo del Distribuidor en la página de revisión, habilite
la casilla “Mostrar logo”. Al habilitarla, el logo del distribuidor aparecerá en la página de
revisión como se muestra a continuación
Descripción: Ingrese la descripción de plugin que desee mostrar en la pantalla de revisión
Entorno: Seleccionar el entorno que desee configurar para el plugin First Data Gateway.
Ingrese “Secreto Compartido” y “Nombre de local” válidos en los campos respectivos
Configuración de URL: Plugin contará con valores incorporados por defecto para URL de éxito,
falla y notificación, si no lo provee el Vendedor en la Configuración
El Vendedor puede personalizar la URL de éxito, falla y notificación a su exclusivo
riesgo de actualizar los datos de orden, inventario y modificaciones de carrito según
la respuesta de First Data Gateway
La casilla de Autorización se utiliza para habilitar las operaciones que deben enviarse para
liquidación automática; en caso de estar deshabilitada, la operación deberá enviarse
manualmente para su liquidación
El menú desplegable Modo Revisión dará la opción de seleccionar uno de lo siguiente:
Página Combinada (Consolida las opciones de método de pago y método de pago en una
única página)
Clásica ( Divide el proceso de pago en múltiples páginas)
El menú desplegable Modo de Pago dará las siguientes opciones de selección. Esta
configuración está disponible solo cuando el “Modo de Revisión” está configurado como
Página “Clásica”
PayOnly (Solo se recoge el Número de Tarjeta, Fecha de Vencimiento y CVC en
First Data Gateway)
PayPlus (Se recoge el Número de Tarjeta, Fecha de Vencimiento, CVC e información de
facturación completa en First Data Gateway)
FullPay (Se recoge Número de Tarjeta, Fecha de Vencimiento, CVC e información completa
de facturación y envío en First Data Gateway)
Al habilitar el Uso de Tokens se almacenará los datos de tarjeta del cliente en First
Data Gateway para futuras operaciones. Haga clic en la casilla Uso de Tokens para
habilitarla
El menú desplegable 3D Secure tendrá opciones activas o inactivas. Los vendedores deben
registrarse para disponer de este servicio, para ello deberán contactar al equipo de soporte de
First Data Gateway
Conversión Dinámica de Moneda: La Conversión Dinámica de Moneda ofrece a los clientes la
posibilidad de pagar en su moneda o en su propia moneda al momento de pago, según el tipo
de cambio en tiempo real
Habilitar el Registro de Depuración ahorrará mensajes de depuración en el archivo de registro
presente en la ruta mencionada cerca del campo Registro de Depuración
El Menú desplegable Método de Autorización dará las siguientes opciones de selección:
Pago Alojado (el Método de Pago Alojado redireccionará al usuario a la página de First
Data Gateway para información de pago tal como datos de tarjeta )
Autorización Oculta (La Autorización Oculta cargará la forma de pago en la página web del
vendedor en lugar de re direccionar al cliente fuera de la Página de Pagos Alojados)
Nota: El sitio del Vendedor es responsable en caso de usar la Autorización Oculta (forma de pago) del
cumplimiento de PCI-DSS
Configuración de Cuotas:
El vendedor puede configurar diferentes opciones de cuotas en plugin. Habilitando las cuotas
y la Configuración de Cuotas en plugin, el Cliente tendrá la opción en la página de Revisión de
elegir el pago total o pago en cuotas
Etiqueta: La opción etiqueta se mostrará en la interfaz
Monto mínimo: Monto mínimo para habilitar la opción de pago
Monto máximo: monto máximo para habilitar la opción de pago
Cálculo: Número total de pagos
Período: Período de tiempo (en días) entre pagos (Disponible solo para Revendedores de First Data en México)
Método de Pago Local:
El listado de pago local disponible para distribuidores seleccionados estará incluido en el menú
desplegable de Método de Pago. El Vendedor puede habilitar o deshabilitar el pago local
utilizando la casilla “Habilitado”. El Vendedor puede elegir múltiples métodos de pago del menú
desplegable Método de Pago
Al habilitar el Método de Pago Local, la pantalla de Revisión tendrá la opción para que el
usuario elija el método de pago local
Anulaciones y Reembolsos:
Configurar API
Configurar las credenciales API y cargar los archivos Trust Server, certificado PEM y Certificado Key
para Reembolsar mediante el plugin First Data Gateway. Por favor, asegurarse de que el servidor
hosting está habilitado con las recomendaciones del servidor API (Referirse a las Recomendaciones del
Servidor API al final de esta guía)
Pasos para realizar un reembolso en Joomla :
Iniciar sesión en la consola de administrador para el sitio
En la solapa VirtueMart, seleccionar Pedidos
Encontrar el pedido que requiere un reembolso/anulación
Para Reembolsos o Anulaciones Totales:
Seleccionar "Reembolsado" en la casilla desplegable en la columna de "Estado". Hacer clic en
“Actualizar Estado del Pedido” para iniciar la operación de reembolso.
Para Reembolsos Parciales (Aplicable a pedidos solo con más de un producto):
Hacer clic en el número de pedido, que mostrará los detalles del pedido
Seleccionar un producto del pedido
Seleccionar "Reembolsado" en la casilla desplegable en la columna "Estado de productos
ordenados "
Hacer clic en el botón “Guardar” para guardar la configuración.
La opción First Data Gateway debería estar disponible en la página de revisión. Asegúrese que
su página web cumple con PCI
Felicidades, ha integrado con éxito el plugin First Data Gateway con Joomla y VirtueMart
3. Soporte en múltiples idiomas
Cómo instalar el paquete de idiomas:
Descargar el paquete deseado desde la página web de traduciones de Joomla
http://joomlacode.org/gf/project/jtranslation3_x/frs/?action=FrsReleaseBrowse&frs_package_i
d=6445
Instalar el paquete de idiomas cargando el zip en la solapa Extensiones>>Instalar de Joomla
Ir a la sección Idiomas en la solapa Extensiones
En la barra de navegación lateral “Sitio instalado”, definir el idioma predeterminado para el
paquete de idiomas recientemente instalado. (Actualmente, el plugin First Data Gateway
soporta traducciones en inglés y español)
La pantalla de revisión traducida en su selección se muestra a continuación
4. Recomendaciones del Servidor API
Verificar que su host soporte la extensión php_fileinfo y curl. Si no lo hace, siga las
instrucciones detalladas a continuación para habilitarla.
Se recomienda hacer una copia de respaldo del código del sitio y la configuración de la base de
datos antes de efectuar cualquier cambio en el entorno hosting antes de instalar el módulo.
Por favor, evaluar detalladamente el módulo en el entorno de “Prueba” antes de cambiar al
modo “Producción
¿Cómo identificar que la extensión curl y fileinfo están instalados en el host?
Agregar un nuevo archive en su sitio web nombrado phpinfo.php e incluir el siguiente código:
<? php phpinfo ();?>
Visualizar el siguiente URL en su navegador: example.com/phpinfo.php
Debería ver lo siguiente en la página que aparece:
Para verificar la extensión del fileinfo
Para verificar la extensión curl
Cómo instalar la extensión curl en el servidor Linux
Para instalar curl, tipear el siguiente comentario en terminal
sudo apt-get install php5-curl
Editar el archivo php.ini
nano /etc/php5/apache2/php.ini
Necesitará reiniciar el servidor: sudo service
apache2 restart
Cómo instalar la extensión curl en el servidor de Windows
Agregar o descomentar la extensión =php_curl.dll en el archivo
php.ini extension=php_curl.dll
Necesitará reiniciar el servidor para verificar la ejecución phpinfo.php
Cómo instalar la extensión fileinfo en el servidor de windows
Esta extensión se habilita por defecto a partir de PHP 5.3.0; para versiones menores de PHP seguir los
siguientes pasos.
Agregar php_fileinfo.dll a la lista de extensiones
extension=php_fileinfo.dll
Descargar el paquete de archivos GNU para windows
Obtenerlo de aquí: http://gnuwin32.sourceforge.net/downlinks/file-bin-zip.php
Extraer la carpeta del archivo llamado shared\file que contiene 4 archivos magic (magic,
magic.mgc, magic.mime, magic.mime.mgc)
Colocar estos 4 archivos en un lugar conocido
Agregar el entorno variable del sistema MAGIC que indica el archive llamado magic. Por
ejemplo si colocó los archivos magic en una carpeta llamada magic en c:\php esto significa que
la ruta adecuada es c:\php\magic\magic
Reiniciar el servidor IIS y verificarlo ejecutando el phpinfo.php
Cómo instalar extensión fileinfo en el servidor Linux
Esta extensión se deshabilita por defecto a partir de PHP 5.3.0. Para versiones menores, seguir los
siguientes pasos.
Editar el archivo php.ini
nano /etc/php5/apache2/php.ini
Agregar php_fileinfo.dll a la lista de extensiones habilitadas
extension=fileinfo.so
Deberá reiniciar el servidor después de ejecutar ejecutando
sudo service apache2 restart
Verificarlo ejecutando el phpinfo.php
