Documentación del Módulo de Pago para PrestaShop – Efipay Payments

Introducción

El módulo de pago Efipay Payments para PrestaShop permite integrar de manera fácil y segura la pasarela de pago Efipay con tu tienda en línea. Este módulo ofrece dos opciones de pago:

1. Redirección externa: El cliente es redirigido a la página segura de Efipay para completar el pago.
2. Integración incrustada: El cliente realiza el pago directamente en tu tienda sin salir de la página.

Ambos métodos están diseñados para garantizar una experiencia de compra cómoda y segura.

Requisitos del Sistema

Asegúrate de que tu sistema cumpla con los requisitos que se listan en la parte derecha, antes de instalar el plugin:

• PrestaShop: Versión 8.1.0 o superior.
• PHP: Versión 7.1 o superior (se recomienda PHP 7.4 o superior).
• SSL: Certificado SSL configurado en tu tienda para transacciones seguras.
• Cuenta Efipay: Necesitarás credenciales como el Id Sucursal/Oficina, API Key y Token Webhook.

Instalación del Módulo

Paso 1: Descargar el Módulo

1. Descarga el archivo comprimido del módulo haciendo clic sobre (efipaypayment.zip) desde el siguiente enlace: Descargar módulo Efipay.

Paso 2: Subir e Instalar el Módulo

1. Accede al panel de administración de tu tienda PrestaShop.
2. Navega a Módulos > Administrador de módulos.
3. Haz clic en el botón Subir un módulo.
4. Selecciona el archivo comprimido descargado y haz clic en Subir este módulo.
5. Una vez cargado, el módulo se instalará automáticamente.

Paso 3: Verificar la Instalación

1. Ve a Módulos > Administrador de módulos > Módulos.
2. Busca el módulo "Efipay Payments" en la sección "Payment" y verifica que esté instalado y activo.

Configuración del Módulo

Paso 1: Acceder a la Configuración

1. Una vez instalado, haz clic en el botón Configure que aparece junto al módulo en la lista de módulos.
   • También puedes acceder a la configuración desde Módulos > Administrador de módulos y buscando "Efipay Payments" en la sección "Payment".

Paso 2: Completar los Campos de Configuración

1. Proporciona las credenciales requeridas:

   • Id Sucursal/Oficina: Proporciona el identificador de tu sucursal del comercio. https://sag.efipay.co/Documentation/api-key
   • API Key: Ingresa la clave API Key que se puede generar en la plataforma Efipay en Documentación >Desarrollador API key > Crear token. https://sag.efipay.co/Documentation/api-key
   • Token weebhook Token para validar la firmas en las solicitudes Webhook https://sag.efipay.co/Documentation/api-key

2. Selecciona los métodos de pago que deseas habilitar:

   • Pagar con método external (Redirección externa).
   • Pagar con método embedded (Integración incrustada).

3. Haz clic en Guardar.

   

Paso 3: Realizar una Prueba de Pago

1. Simula una compra en tu tienda para verificar que los métodos de pago funcionen correctamente.
2. Comprueba que las notificaciones de pago lleguen al panel de administración de PrestaShop.

Detalle de los Métodos de Pago

1. Efipay pago externo (Redirección Externa)

Descripción: Este método redirige al cliente a la página de pago segura de Efipay para completar la transacción.

Flujo de Uso:

1. El cliente selecciona productos y procede al proceso de pago.
2. Elige Efipay pago externo como método de pago.
3. Acepta terminos y condiciones.
4. Clic en Realizar pedido
5. Es redirigido a la página de Efipay, donde completa la transacción.
6. Una vez completado el pago, el cliente es redirigido automáticamente a tu tienda con una confirmación del pedido.

2. Efipay pago embebido (Integración Incrustada)

Descripción: Este método permite al cliente completar la transacción directamente en tu tienda PrestaShop sin ser redirigido.

Flujo de Uso:

1. El cliente selecciona productos y procede al proceso de pago.
2. Elige Efipay pago embebido como método de pago.
3. Completa los datos en el formulario de pago incrustado en tu tienda.
4. Acepta terminos y condiciones.
5. Clic en Realizar pedido
6. Una vez confirmado el pago, el cliente recibe un mensaje de éxito en la misma página.

Solución de Problemas

Problemas Comunes

• El módulo no se instala:
  • Verifica que el archivo ZIP no esté corrupto.
  • Asegúrate de que tu versión de PrestaShop cumpla con los requisitos.
• Errores en los pagos:
  • Confirma que las credenciales (Id Sucursal/Oficina, API Key y Token Webhook) sean correctas.
  • Revisa que el certificado SSL esté configurado y activo.

Habilitar Modo de Depuración

1. Accede a la configuración del módulo.
2. Activa el modo de depuración para registrar detalles de errores.
3. Consulta los registros generados para identificar problemas específicos.

Soporte

Si necesitas ayuda adicional con la instalación, configuración o uso del módulo, puedes contactar a nuestro equipo de soporte:

• Correo electrónico: soporte@efipay.co
• Documentación en línea: https://sag.efipay.co/docs/1.0/overview
• Foro de soporte: Disponible en el sitio oficial de Efipay.

Notas Finales

• Mantén el módulo y tu tienda PrestaShop actualizados para garantizar compatibilidad y seguridad.
• Realiza copias de seguridad de tu tienda antes de instalar nuevos módulos o realizar cambios importantes.

¡Gracias por elegir Efipay como tu proveedor de pagos!