Documentación de la App Efipay Gateway Payment para Shopify
Descripción
La app Efipay Gateway Payment para Shopify permite integrar tu tienda en línea de Shopify con la pasarela de pagos de Efipay. Con esta aplicación, tus clientes podrán realizar pagos de forma segura y rápida directamente desde el checkout de Shopify utilizando los medios de pago habilitados por Efipay.
Requisitos del Sistema
Antes de instalar la app, asegúrate de cumplir con los siguientes requisitos:
Tienda Shopify activa: Con un plan que permita instalar aplicaciones de terceros.
Cuenta de comercio en Efipay: Con acceso al panel de administración de Efipay.
API Key (pruebas y producción) y Token Webhook de Efipay: Credenciales generadas desde el panel de Efipay.
Id Sucursal/Oficina en Efipay: Identificador de la sucursal de tu comercio registrada en Efipay.
Instalación
Actualmente la app Efipay Checkout no aparece listada de forma pública en la búsqueda de la Shopify App Store.
Para instalarla, debes acceder mediante enlace directo.
Instalación mediante enlace directo
Ingresa al panel de administración de Shopify de tu tienda.
Si es necesario, inicia sesión con la misma cuenta de Shopify de tu tienda.
En la pantalla de la app, selecciona tu tienda (si Shopify te lo solicita) y haz clic en Instalar.
Revisa los permisos solicitados por la aplicación y haz clic en Instalar o Aceptar para continuar.
Espera a que Shopify complete el proceso de instalación y serás redirigido a la pantalla de configuración inicial de la app.
Verificación de Instalación
En el panel de Shopify, ve a Configuración > Apps y canales de ventas.
Verifica que la app checkout-efipay aparezca en la lista de aplicaciones instaladas.
Opcionalmente, abre la app para confirmar que carga correctamente y que muestra la pantalla de configuración.
Configuración
La configuración de Efipay se realiza desde el panel de administración de Shopify, ya sea desde la propia app o desde la sección de pagos.
Paso 1: Accede a la Configuración de Pagos
En el panel de Shopify, ve a Configuración (parte inferior izquierda).
Haz clic en Pagos.
En la sección de formas de pago admitidas, ubica Efipay como método de pago y selecciona.
Haz clic en Más acciones > Gestionar, Configurar o Editar junto al proveedor de pagos de Efipay.
Paso 2: Configura Efipay como método de pago en Shopify
En la pantalla de Configuración de pagos de Shopify (donde ves la lista de métodos de pago), encontrarás las siguientes opciones generales del proveedor Efipay:
Habilitar/Deshabilitar Efipay: Activa esta opción para que Efipay esté disponible como método de pago en el checkout.
Modo de operación (Prueba/Producción): Selecciona el entorno que usarás. Utiliza el Modo prueba para probar y Producción para ventas reales.
Estas opciones se configuran directamente en la vista de pagos de Shopify, no en la pantalla de credenciales de Efipay.
Paso 3: Configura las credenciales de tu cuenta Efipay
Para configurar las credenciales de Efipay (API Key, Token Webhook e Id Sucursal/Oficina), accede a la pantalla de configuración de la app desde Más acciones > Gestionar en el proveedor Efipay, o ingresando a la app desde Configuración > Apps y canales de ventas.
En la pantalla de configuración de Efipay, completa los siguientes campos:
API Key: Ingresa la API Key generada en la plataforma de Efipay en Documentación > Desarrollador API key > Crear token.
Enlace de referencia: https://sag.efipay.co/Documentation/api-key
Revisa que todos los campos estén completos y correctos.
Haz clic en Guardar, Guardar cambios o el botón equivalente en la interfaz.
Espera a que Shopify confirme que la configuración se ha actualizado correctamente.
Uso
Una vez instalada y configurada la app de Efipay, tus clientes podrán utilizar este método de pago en el checkout de tu tienda Shopify.
Proceso para el Cliente
El cliente agrega productos al carrito y procede al checkout.
En la sección de Método de pago, selecciona Efipay (tarjetas débito, crédito, PSE, efectivo u otros medios según lo habilitado en tu cuenta Efipay).
El cliente es redirigido o visualiza el formulario de pago de Efipay.
Completa los datos requeridos y confirma el pago.
Una vez procesada la transacción, el cliente será redirigido a la página correspondiente según el resultado (rechazo, pendiente o confirmación).
Video Tutorial de Integración
A continuación, se incluye el video oficial utilizado como referencia para este paso a paso de instalación, configuración y uso de la app de pagos de Efipay para Shopify. Puedes reproducirlo directamente desde esta documentación para seguir visualmente cada uno de los pasos.
Solución de Problemas
Si presentas inconvenientes durante la instalación o configuración de la app, revisa lo siguiente:
Credenciales incorrectas:
Verifica que la API Key, Token Webhook y Id Sucursal/Oficina coincidan exactamente con los valores configurados en tu panel de Efipay.
Modo de prueba vs producción:
Confirma que estás utilizando el entorno correcto (Pruebas o Producción) según el tipo de pruebas o transacciones reales.
Problemas en el checkout:
Revisa si hay otras apps de pago o personalizaciones que puedan estar interfiriendo con el flujo de pago.
Si el problema persiste, habilita registros de depuración (si la app lo permite) y contacta al equipo de soporte con capturas de pantalla y mensajes de error.
Soporte
Si necesitas ayuda adicional con la integración de Efipay en Shopify, contáctanos:
Se recomienda probar primero el flujo de pago en modo Pruebas antes de habilitar Producción para tus clientes.
Mantén tu tienda Shopify y la app de Efipay siempre actualizadas para contar con las últimas mejoras y correcciones.
Realiza pruebas periódicas de pago para asegurar que todo el flujo de cobro continúa funcionando correctamente después de cambios en la tienda o en la configuración de Efipay.