DocsPrestaShop
Integra Cost+ con tu tienda PrestaShop (9.x, 8.x y 1.7)
Integra Cost+ como metodo de pago en tu tienda PrestaShop. El modulo Cost+ esta disponible para PrestaShop 9.x, PrestaShop 8.x y PrestaShop 1.7.
Requisitos previos
- Cuenta de comerciante Cost+ activa
- PrestaShop 9.1 o posterior
- PHP 8.1 o posterior
- SSL/HTTPS habilitado
- Acceso de administrador a tu back office de PrestaShop
- Cuenta de comerciante Cost+ activa
- Instalacion de PrestaShop 8.x
- PHP 8.0 o posterior
- Acceso de administrador a tu back office de PrestaShop
- MySQL 5.4 o superior
- Cuenta de comerciante Cost+ activa
- Instalacion de PrestaShop 1.7.x
- PHP 5.4 o posterior
- Acceso de administrador a tu back office de PrestaShop
- MySQL 5.4 o superior
1. Instalar el modulo
Descarga el modulo desde GitHub.
Metodo A: Subir desde el panel de administracion (recomendado)
- Ve a Modules → Module Manager en tu panel de administracion
- Haz clic en Upload a module
- Arrastra y suelta el archivo ZIP o seleccionalo manualmente
- Espera a que la instalacion termine
- Busca "NoPayn" y haz clic en Configure
Metodo B: Subida manual
- Copia la carpeta
nopaynpayment/en el directoriomodules/de tu PrestaShop - Ve a Modules → Module Manager
- Busca "NoPayn" y haz clic en Install
- Haz clic en Configure para abrir la configuracion
Descarga el modulo desde GitHub.
Metodo A: Subir desde el panel de administracion (recomendado)
- Ve a Improve > Module Manager en tu panel de administracion
- Haz clic en Upload a module
- Arrastra y suelta el archivo ZIP o seleccionalo manualmente
- Espera a que la instalacion termine
- Desplazate hasta la seccion "Other" y haz clic en Configure bajo Cost+
Metodo B: Subida manual via (S)FTP
- Extrae el archivo ZIP descargado
- Usando un cliente SFTP (ej. FileZilla, WinSCP), sube todas las carpetas al directorio
/modules/de tu instalacion de PrestaShop - Ve a Improve > Modules > Module Catalog
- Busca "Cost+" -- revisa la pestana Uninstalled Modules si es necesario
- Haz clic en Install
Descarga el modulo desde GitHub.
Metodo A: Subir desde el panel de administracion (recomendado)
- Ve a Improve > Module Manager en tu panel de administracion
- Haz clic en Upload a module
- Arrastra y suelta el archivo ZIP o seleccionalo manualmente
- Espera a que la instalacion termine
- Desplazate hasta la seccion "Other" y haz clic en Configure bajo Cost+
Metodo B: Subida manual via (S)FTP
- Extrae el archivo ZIP descargado
- Usando un cliente SFTP (ej. FileZilla, WinSCP), sube todas las carpetas al directorio
/modules/de tu instalacion de PrestaShop - Ve a Modules > Module Manager
- Busca "Cost+" -- revisa la pestana Uninstalled Modules si es necesario
- Haz clic en Install
2. Introducir las credenciales de la API
Inicia sesion en el portal de comerciante y navega a Websites, luego haz clic en el sitio web que deseas conectar. Haz clic en Integration donde encontraras tu clave API.
En la configuracion del modulo NoPayn, introduce tu API Key y configura los siguientes ajustes:
| Ajuste | Descripcion |
|---|---|
| API Key | Tu clave API de NoPayn |
| Credit / Debit Card | Habilitar/deshabilitar pagos con tarjeta de credito |
| Apple Pay | Habilitar/deshabilitar Apple Pay |
| Google Pay | Habilitar/deshabilitar Google Pay |
| Vipps MobilePay | Habilitar/deshabilitar Vipps MobilePay |
| Manual Capture | Solo autorizar pagos con tarjeta de credito — capturar al enviar |
| Debug Logging | Habilitar registro detallado en var/logs/nopayn_debug.log |
Pega la clave en el campo API Key en la pagina de configuracion de Cost+ Library y haz clic en Save.
Pega la clave en el campo API Key en la pagina de configuracion de Cost+ Library y haz clic en Save.
Para entornos de alojamiento de PrestaShop 8.x y 1.7, habilita la opcion cURL CA bundle durante la configuracion para evitar problemas con certificados SSL.
3. Habilitar metodos de pago
Los metodos de pago se configuran directamente en los ajustes del modulo (ver paso 2 arriba). Activa o desactiva cada metodo segun sea necesario.
Solo activa los metodos de pago para los que hayas sido aprobado y hayas recibido confirmacion.
Despues de guardar tu clave API, sube cada modulo de metodo de pago por separado via Upload a module.
Regresa a Improve > Module Manager, haz clic en Upload a module de nuevo y sube cada archivo ZIP para los metodos de pago que deseas habilitar (ej. Credit Card, MobilePay, Swish).
Solo activa los metodos de pago para los que hayas sido aprobado y hayas recibido confirmacion.
Los modulos de pago tendran una opcion Configure (si se necesita configuracion adicional) o simplemente un toggle de Habilitar/Deshabilitar.
Despues de guardar tu clave API, sube cada modulo de metodo de pago por separado via Upload a module.
Regresa a Improve > Module Manager, haz clic en Upload a module de nuevo y sube cada archivo ZIP para los metodos de pago que deseas habilitar (ej. Credit Card, MobilePay, Swish).
Solo activa los metodos de pago para los que hayas sido aprobado y hayas recibido confirmacion.
Los modulos de pago tendran una opcion Configure (si se necesita configuracion adicional) o simplemente un toggle de Habilitar/Deshabilitar.
Flujo de pago
- El cliente selecciona un metodo de pago de Cost+ en el checkout
- El cliente es redirigido a la pagina de pago alojada de Cost+ (HPP)
- Despues de completar el pago, el cliente es redirigido de vuelta a la tienda
- Un webhook confirma el estado del pago servidor a servidor
Webhook
La URL del webhook se configura automaticamente por pedido:
https://your-shop.com/module/nopaynpayment/webhookNo se requiere configuracion manual de webhooks — el modulo gestiona el registro automaticamente.
Captura manual
Cuando esta habilitada para pagos con tarjeta de credito:
- El pago es autorizado pero no capturado en el checkout
- La captura ocurre cuando el pedido se envia / se marca como completado
- Si el pedido se cancela, la autorizacion se anula automaticamente
Reembolso automatico
Si un pedido con pago capturado se cancela, el modulo emite automaticamente un reembolso total. Los reembolsos parciales pueden procesarse a traves de las notas de credito de PrestaShop.
Etiquetas del boton de checkout
Para una mejor experiencia de usuario con flujos de redireccion externa, considera actualizar la etiqueta del boton de checkout a "Review order" en lugar de "Confirm and pay", ya que el pago real ocurre en la pagina alojada de Cost+. Este es un ajuste global de PrestaShop, no especifico del modulo.
Webhook
El webhook se configura automaticamente por el modulo. No se requiere configuracion manual.
Webhook
El webhook se configura automaticamente por el modulo. No se requiere configuracion manual.
4. Pasos finales y pruebas
- Verifica todos los metodos de pago habilitados
- Realiza algunas transacciones de prueba -- tanto exitosas como fallidas -- para asegurarte de que todo fluye correctamente
- Configura el comportamiento avanzado como captura manual vs. automatica segun tu proceso de cumplimiento
Soporte
Necesitas ayuda? Contacta a nuestro equipo de soporte en support@costplus.io.