Joomla Integration Guide V1.0.0

User Manual:

Open the PDF directly: View PDF PDF.
Page Count: 10

DownloadJoomla Integration Guide-v1.0.0
Open PDF In BrowserView PDF
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 












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”











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

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:

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



Source Exif Data:
File Type                       : PDF
File Type Extension             : pdf
MIME Type                       : application/pdf
PDF Version                     : 1.5
Linearized                      : No
Page Count                      : 10
Language                        : es-AR
Tagged PDF                      : Yes
Author                          : Windows User
Creator                         : Microsoft® Word 2010
Create Date                     : 2019:02:07 11:00:44-03:00
Modify Date                     : 2019:02:07 11:00:44-03:00
Producer                        : Microsoft® Word 2010
EXIF Metadata provided by EXIF.tools

Navigation menu