Resumen rápido
- Para aceptar tarjetas en PrestaShop necesitas un TPV virtual o proveedor de pagos y un módulo compatible.
- Si tu banco utiliza Redsys, puedes integrar su pasarela mediante un módulo específico para PrestaShop.
- Configura primero el entorno de pruebas y no pases a producción hasta comprobar varias situaciones.
- No basta con que la tarjeta sea aceptada: PrestaShop debe recibir la confirmación y actualizar correctamente el pedido.
- Si todavía no tienes proveedor, compara costes, compatibilidad, soporte, métodos de pago y funcionamiento de las devoluciones antes de elegir.
- Utilizar una pasarela externa puede reducir la exposición de tu tienda a datos de tarjeta, pero no elimina automáticamente todas tus responsabilidades de seguridad.
Qué necesitas para cobrar con tarjeta en PrestaShop
PrestaShop no procesa por sí solo los datos de una tarjeta bancaria. La tienda se conecta a un proveedor que autoriza el pago y devuelve el resultado de la operación.
Ese proveedor puede ser el TPV virtual que te ofrece una entidad bancaria o una pasarela de pagos especializada. Si quieres entender bien esta diferencia antes de tocar la configuración, conviene tener claro qué es un TPV virtual y cómo funciona.
No debes confundirlo con el terminal que utilizas en un mostrador. Un datáfono sirve para pagos presenciales; un TPV virtual está pensado para operaciones online. Aquí explicamos con más detalle la diferencia entre TPV físico y TPV virtual.
Antes de instalar nada, comprueba que tienes:
- Una tienda PrestaShop operativa.
- HTTPS correctamente configurado.
- Acceso de administrador al back office.
- Una copia de seguridad reciente.
- Un TPV virtual contratado o una cuenta activa con el proveedor.
- Las credenciales correspondientes.
- Un módulo compatible con tu instalación de PrestaShop.
- Acceso al entorno de pruebas, cuando el proveedor lo ofrezca.
Consejo práctico: no descargues un módulo de pago desde cualquier web simplemente porque aparece en un tutorial antiguo. Para una parte tan sensible de la tienda merece la pena utilizar el módulo del propio proveedor o una solución mantenida y con compatibilidad conocida.
Si todavía no has contratado el servicio, revisa antes cómo solicitar un TPV virtual. Así podrás llegar a la configuración con las credenciales y condiciones necesarias ya preparadas.
Cómo configurar el pago con tarjeta en PrestaShop paso a paso
Aunque cada proveedor utiliza nombres y campos diferentes, el proceso suele seguir la misma lógica.
1. Instala el módulo de pago adecuado
En el back office de PrestaShop puedes gestionar e instalar módulos. Debes utilizar el correspondiente al proveedor con el que vayas a procesar las tarjetas.
No confundas módulo y pasarela:
- El módulo es el componente que instalas en PrestaShop.
- La pasarela de pago es la infraestructura que procesa o canaliza la operación.
- El banco o proveedor adquirente es quien mantiene la relación comercial que corresponda con tu negocio.
Si quieres profundizar antes de elegir, nuestra guía sobre cómo funcionan las pasarelas de pago explica esta estructura con más detalle.
2. Introduce las credenciales del comercio
Una vez instalado el módulo, tendrás que vincularlo con tu comercio.
Según el proveedor, pueden solicitarse datos como:
- identificador del comercio;
- número de terminal;
- clave de firma;
- API key;
- API secret;
- identificador de cuenta;
- URL de notificaciones;
- entorno de pruebas o producción.
Nunca publiques estas claves ni las envíes en una captura sin ocultarlas. Un identificador público no tiene la misma sensibilidad que una clave secreta, pero ante la duda trátalo como información confidencial.
3. Empieza siempre por pruebas
Uno de los errores más evitables es configurar las credenciales reales y probar directamente con clientes.
Cuando exista un entorno de test, utilízalo.
Una operación de prueba debería permitirte comprobar no solo que aparece una pantalla diciendo “pago aceptado”, sino también que:
- PrestaShop crea el pedido.
- El importe es correcto.
- El pedido recibe el estado adecuado.
- Se actualiza el stock.
- Se genera el email esperado.
- La operación aparece en el panel del proveedor.
4. Configura correctamente la notificación del pago
Esta es una de las partes más importantes y menos entendidas.
Imagina que el cliente paga correctamente y después cierra la pestaña antes de volver a tu tienda. La confirmación del pedido no debería depender exclusivamente de que ese usuario regrese a una página de “gracias por tu compra”.
El proveedor de pagos dispone de mecanismos para comunicar a tu tienda el resultado de la operación. Dependiendo de la integración se hablará de notificación, callback o webhook.
La idea importante es la misma: PrestaShop necesita recibir una confirmación fiable desde el sistema de pagos.
Por eso puede producirse este problema aparentemente extraño:
El cliente tiene el cargo autorizado, pero el pedido sigue pendiente o ni siquiera aparece correctamente en PrestaShop.
Cuando sucede, antes de tocar manualmente el pedido hay que comprobar qué ha ocurrido con esa comunicación.
5. Pasa a producción solo después de validar todo el circuito
Una vez que las pruebas funcionan, puedes activar el entorno real siguiendo las instrucciones del proveedor.
No des por hecho que basta con cambiar un interruptor. Puede haber:
- credenciales diferentes;
- claves de firma distintas;
- URLs distintas;
- parámetros específicos de producción.
Después de activarlo, realiza una compra real controlada de pequeño importe y comprueba tanto la operación en el proveedor como el pedido dentro de PrestaShop.
Cómo configurar Redsys en PrestaShop
Redsys es una integración especialmente habitual cuando el TPV virtual contratado a través de una entidad financiera utiliza su infraestructura.
El proceso normal consiste en obtener los datos del comercio, instalar el módulo correspondiente y configurar inicialmente las credenciales de pruebas.
Para evitar módulos desactualizados, utiliza la documentación oficial de módulos de Redsys.
En una configuración Redsys puedes encontrarte con conceptos como:
FUC o número de comercio. Identifica al comercio dentro de la plataforma.
Terminal. Identifica el terminal lógico utilizado para realizar las operaciones.
Clave de firma. Permite verificar y proteger las comunicaciones entre sistemas. Debe mantenerse secreta.
Entorno. Determina si estás enviando operaciones a pruebas o a producción.
La recomendación aquí es sencilla: no copies parámetros de otro comercio ni credenciales tomadas de un tutorial. Utiliza los datos que correspondan a tu propio TPV y el material de prueba facilitado específicamente por el proveedor cuando estés realizando la integración.
Cómo configurar Worldline en PrestaShop
Worldline también dispone de integración para PrestaShop y separa el entorno de prueba del entorno real.
El flujo es parecido:
- Tener una cuenta habilitada.
- Instalar el plugin.
- Introducir las credenciales.
- Configurar las notificaciones.
- Seleccionar los métodos de pago.
- Hacer pruebas.
- Pasar a producción.
La documentación oficial de Worldline para PrestaShop es el punto adecuado para comprobar requisitos y parámetros concretos de su integración.
Error muy fácil de cometer: utilizar las credenciales del entorno de pruebas mientras el módulo está configurado para producción, o al revés. Si la conexión falla justo después de cambiar de entorno, este debería ser uno de los primeros puntos que revises.
Qué pasarela elegir si todavía no tienes proveedor
No hay una única pasarela adecuada para todas las tiendas PrestaShop.
Una tienda que factura poco y tiene 30 pedidos mensuales puede valorar cosas diferentes a otra que procesa miles de operaciones, vende internacionalmente o necesita múltiples métodos de pago.
Antes de decidir, compara al menos:
| Criterio | Qué deberías mirar |
|---|---|
| Coste | Porcentaje, importe fijo, cuotas y otros cargos |
| Compatibilidad | Si existe un módulo mantenido para tu PrestaShop |
| Liquidación | Cuándo recibes el dinero |
| Métodos | Tarjeta, Bizum, wallets y otros sistemas que necesites |
| Divisas | Qué ocurre si vendes fuera de la zona euro |
| Devoluciones | Si puedes gestionarlas fácilmente |
| Soporte | Qué ayuda recibes si la tienda deja de cobrar |
| Checkout | Si el pago se hace fuera o integrado en tu tienda |
| Seguridad | Cómo se gestionan los datos de tarjeta y la autenticación |
Si todavía estás en esta fase, es mejor comparar primero los TPV virtuales para PrestaShop y configurar la tienda después. Evitarás invertir tiempo en un módulo que luego tengas que sustituir.
También puedes ampliar la comparación con nuestra selección de pasarelas de pago para ecommerce.
Checkout alojado o pago integrado
Otra decisión importante es dónde introduce el cliente los datos de su tarjeta.
En un checkout alojado, el comprador es enviado al entorno controlado por el proveedor de pagos para completar la operación.
En un checkout integrado, la experiencia permanece más integrada visualmente en la tienda, aunque la arquitectura concreta puede variar mucho de un proveedor a otro.
No asumas que la segunda opción es automáticamente mejor porque haya menos cambios visuales. Hay que valorar seguridad, mantenimiento, conversión y complejidad técnica.
Puedes ver las diferencias con más detalle en nuestra comparativa de checkout alojado frente a checkout integrado.
Además, si quieres ofrecer más opciones que la tarjeta tradicional, algunos proveedores permiten incorporar wallets. En ese caso te interesa revisar cómo aceptar Apple Pay y Google Pay en una tienda online.
Cómo probar el TPV de PrestaShop antes de vender de verdad
Una prueba correcta no consiste en hacer una única compra y comprobar que aparece un mensaje verde.
Hay que intentar romper el proceso de forma controlada.
Esta es la checklist que utilizaríamos antes de poner el TPV en producción:
- El pago con tarjeta aparece en el checkout.
- Aparece solo para los países y monedas correctos.
- El total enviado al TPV coincide con el carrito.
- Los gastos de envío están incluidos correctamente.
- Los descuentos se reflejan bien.
- El IVA y el total final coinciden.
- Un pago aceptado crea el pedido.
- Un pago rechazado no crea un pedido como pagado.
- El cliente vuelve correctamente a la tienda.
- PrestaShop recibe la notificación del proveedor.
- El estado del pedido se actualiza.
- El stock se descuenta cuando corresponde.
- El email de confirmación se genera correctamente.
- La operación puede localizarse en el panel del proveedor.
- Una devolución puede gestionarse correctamente.
- El proceso funciona desde móvil.
- El checkout sigue funcionando con caché y optimizaciones activadas.
Prueba especialmente útil: crea un pedido con descuento, gastos de envío e impuestos. Un carrito de 1 € sin ninguna condición apenas comprueba nada.
También merece la pena simular una tarjeta rechazada. Una tienda debe comportarse bien tanto cuando cobra como cuando no cobra.
Qué hacer si el pago con tarjeta no funciona en PrestaShop
Los errores de TPV suelen parecer más complejos de lo que son porque intervienen varias capas: PrestaShop, el módulo, el hosting, la pasarela y el proveedor.
La forma más rápida de encontrar el problema es comprobarlas en orden.
El pago con tarjeta no aparece
Revisa primero:
- Que el módulo esté instalado.
- Que esté activado.
- Que la moneda utilizada esté permitida.
- Que no existan restricciones por país.
- Que el grupo de clientes pueda utilizarlo.
- Que el transportista elegido sea compatible.
- Que el módulo sea compatible con tu instalación.
- Que la configuración obligatoria esté completa.
- Que no haya caché mostrando una versión anterior del checkout.
Si desaparece solo para determinados clientes, las restricciones de país, moneda o transportista son especialmente sospechosas.
El cliente paga pero el pedido sigue pendiente
Aquí conviene evitar decisiones precipitadas.
Primero comprueba la operación directamente en el panel del proveedor. Si allí aparece aceptada, el problema puede estar en la comunicación entre la pasarela y PrestaShop.
Revisa:
- notificaciones o webhooks;
- URL configurada;
- registros del módulo;
- registros del servidor;
- errores PHP;
- firewall o sistemas de seguridad;
- credenciales;
- cambios recientes en plugins o módulos;
- modo mantenimiento.
No marques varios pedidos como pagados manualmente sin comprobar cada cobro. Puedes terminar enviando pedidos que realmente fueron rechazados.
Funciona en pruebas pero falla en producción
Es uno de los fallos más fáciles de diagnosticar.
Comprueba:
- que realmente has cambiado al modo producción;
- que utilizas las credenciales reales;
- que la clave pertenece al comercio correcto;
- que terminal e identificadores coinciden;
- que no has dejado una URL de pruebas;
- que la configuración real está habilitada por el proveedor.
También puede ocurrir lo contrario: una tienda parece correctamente configurada, pero está enviando operaciones a test y nunca llegará a cobrar dinero real.
Seguridad, costes y errores que merece la pena evitar
Un TPV virtual es una pieza crítica de la tienda. Si deja de funcionar, tu ecommerce puede seguir recibiendo visitas y pedidos iniciados, pero no ventas completadas.
Protege la integración de pagos
Como mínimo:
- Mantén PrestaShop actualizado.
- Mantén actualizado el módulo de pagos.
- Usa HTTPS.
- Protege el acceso de administrador.
- Usa contraseñas únicas y autenticación adicional cuando esté disponible.
- No compartas claves secretas.
- No almacenes por tu cuenta números completos de tarjeta salvo que tu arquitectura y obligaciones estén específicamente diseñadas para ello.
- Revisa copias de seguridad antes de modificar un módulo de pagos.
- Evita alterar el código del plugin si no sabes exactamente qué estás cambiando.
Externalizar el procesamiento de la tarjeta puede reducir bastante la superficie que tienes que gestionar, pero no significa olvidarte de PCI DSS. Las obligaciones concretas dependen de cómo esté construida la integración y de tu entorno. Si necesitas determinar el alcance aplicable a tu negocio, consulta al adquirente o proveedor y la información del PCI Security Standards Council.
Mira el coste total, no solo la comisión anunciada
Dos TPV con un porcentaje parecido pueden acabar teniendo costes distintos.
Comprueba:
- comisión porcentual;
- coste fijo por operación;
- cuota mensual;
- alta;
- devolución;
- contracargo;
- tarjetas extranjeras;
- conversión de divisa;
- servicios adicionales.
Puedes profundizar en nuestra guía de comisiones de TPV.
Ejemplo hipotético: imagina que una tienda procesa 10.000 € al mes. Una diferencia de solo 0,40 puntos porcentuales supone 40 € mensuales. Si, además, existe un cargo fijo de 0,10 € y realizas 500 operaciones, añadirías otros 50 €.
No significa que debas elegir siempre el porcentaje más bajo. Un módulo estable, buen soporte y menos pagos fallidos también tienen valor económico.
Cinco errores especialmente evitables
1. Elegir primero el módulo y después el proveedor.
Hazlo al revés: elige la solución de cobro que encaja con tu negocio y después instala su integración.
2. Probar únicamente un pago aceptado.
También necesitas comprobar rechazos, abandonos y devoluciones.
3. Dar por bueno el pago porque el cliente vuelve a la web.
La tienda debe recibir correctamente la confirmación del proveedor.
4. Tocar una integración que funciona justo antes de una campaña importante.
Si necesitas actualizarla, hazlo con margen para probar.
5. Elegir solo por precio.
Un ahorro pequeño en comisiones puede salir caro si el módulo falla, el soporte es deficiente o las devoluciones son complicadas.
Conclusión
Para cobrar con tarjeta en PrestaShop necesitas un proveedor de pagos, un módulo compatible y una configuración correctamente probada. Instalar el plugin es solo una parte del trabajo: lo realmente importante es asegurarte de que el dinero, las notificaciones y los pedidos quedan sincronizados.
Si ya tienes un TPV Redsys o una cuenta con Worldline, puedes centrarte directamente en instalar el módulo, configurar pruebas y validar el circuito antes de pasar a producción. Si todavía no has elegido proveedor, compara primero compatibilidad, costes, soporte y métodos de pago. Cambiar de pasarela después de tener toda la tienda configurada suele dar más trabajo que elegir bien desde el principio.
