PTS Stripe

Documentación completa para instalar, configurar y utilizar el módulo PTS Stripe en tu tienda PrestaShop.

¿Qué es PTS Stripe?

PTS Stripe conecta tu tienda con Stripe para que puedas cobrar con tarjeta, con carteras digitales como Apple Pay, Google Pay, Link, PayPal o Amazon Pay, con los métodos bancarios habituales de cada país europeo, y con los métodos de comprobante que se usan en Brasil, México o Portugal. Cada uno se activa por separado y puede limitarse a los países y grupos de clientes que quieras.

Además de cobrar dentro del checkout, añade botones de compra rápida en la ficha de producto, el carrito y la página de pago, y una pestaña propia en cada pedido del back-office desde la que consultas el pago y emites reembolsos sin entrar en el panel de Stripe.

5.1.1

Versión

PS 1.7.6+

PS 8.x

PS 9.x

Multitienda

Multi-idioma

Características Principales

Todos los métodos de Stripe

Tarjeta, Apple Pay, Google Pay, Link, PayPal, Amazon Pay, Klarna, iDEAL, Bancontact, EPS, Przelewy24, BLIK, TWINT, Afterpay/Clearpay, Affirm, adeudo SEPA, Multibanco, OXXO, Boleto y Pix. Cada uno con su interruptor, o todos juntos en un único formulario si prefieres que sea Stripe quien elija.

Compra rápida con carteras digitales

Botones de pago en la ficha de producto, el carrito, la página de pago y el carrito lateral de One Page Checkout PS. El cliente elige dirección y envío dentro de la ventana de su cartera, con los portes y los impuestos ya calculados.

Restricciones por país y grupo

Cada método de la lista de pago puede mostrarse solo a los países de entrega y a los grupos de clientes que elijas, para ofrecer en cada mercado lo que allí se usa y no llenar el checkout de opciones que nadie va a elegir.

Reembolsos desde el back-office

Totales o parciales, desde la pestaña Stripe del propio pedido y con el importe reembolsable siempre a la vista. También pueden emitirse solos al crear una nota de abono en PrestaShop.

Requisitos del Sistema

Requisito	Mínimo	Recomendado
PrestaShop	1.7.6	9.x
PHP	7.2.5	8.3+
Cuenta de Stripe	Obligatoria	—
Certificado SSL	Obligatorio	—

Tu tienda tiene que estar accesible por HTTPS antes de cobrar de verdad: Stripe no admite pagos con tarjeta sobre conexiones sin cifrar, y las carteras digitales tampoco aparecen sin él.

Instalación

Existen dos métodos para instalar el módulo en tu tienda PrestaShop, dependiendo de las características de tu servidor.

Método 1: Instalación desde el Back Office

1

Accede al Back Office

Inicia sesión en el panel de administración de tu tienda PrestaShop.

2

Navega a Módulos

Ve a Módulos → Gestor de módulos en el menú lateral.

3

Sube el módulo

Haz clic en "Subir un módulo" y selecciona el archivo ZIP descargado.

4

Instala y activa

Una vez subido, el módulo se instalará automáticamente. Haz clic en "Configurar" para comenzar.

Método 2: Instalación por FTP

Utiliza este método si el archivo ZIP es muy pesado y tu servidor no permite subirlo desde el Back Office debido a limitaciones de tamaño de subida.

1

Descomprime el archivo ZIP

Extrae el contenido del archivo ZIP en tu ordenador local.

2

Conéctate por FTP

Usa un cliente FTP (como FileZilla) para conectarte a tu servidor.

3

Sube la carpeta del módulo

Sube la carpeta del módulo a /modules/ en tu instalación de PrestaShop.

4

Instala desde el Back Office

Ve a Módulos → Gestor de módulos, busca el módulo y haz clic en "Instalar".

Posibles Problemas de Instalación

Conflictos de Override: Durante la instalación o activación del módulo, pueden surgir problemas relacionados con los archivos de override. Esto sucede cuando otro módulo ya ha modificado los mismos archivos del núcleo de PrestaShop.

Si experimentas errores de override al instalar o activar el módulo, no intentes resolverlo por tu cuenta si no tienes experiencia técnica. Contacta con nuestro equipo de soporte para recibir ayuda personalizada y resolver el conflicto de manera segura.

Contactar con Soporte

Ajustes

La configuración del módulo se reparte en pestañas. Las tres primeras se explican aquí: General reúne el diagnóstico, Stripe guarda las credenciales de tu cuenta y Pagos decide qué métodos ve el cliente y cómo. La compra rápida tiene sección propia, justo después.

El orden recomendado la primera vez es: pega tus claves en la pestaña Stripe con el modo sandbox activado, registra la URL del webhook en tu panel de Stripe, activa los métodos que quieras ofrecer y haz un pedido de prueba. Cuando todo funcione, desactiva el modo sandbox y pega las claves reales.

General

Reúne las opciones de diagnóstico del módulo y el comportamiento de los reembolsos automáticos.

Modo de depuración

Al activar esta opción, los métodos de pago del módulo solo se muestran a las direcciones IP que indiques en el campo "IP". Así puedes probar el cobro en tu propia tienda mientras el resto de clientes siguen comprando con los métodos de pago que ya tenías.

Se recomienda habilitar esta opción para probar el módulo en tu tienda antes de habilitarlo para clientes.

IP

Lista las direcciones desde las que el módulo será visible mientras el modo de depuración esté activo. El botón que hay junto al campo añade la dirección desde la que estás navegando en ese momento, que es la forma más cómoda de no equivocarse.

Si dejas este campo vacío con el modo de depuración activado, los métodos de pago del módulo no los verá nadie, tú incluido. Añade al menos tu IP antes de activarlo. Ten en cuenta también que muchas conexiones domésticas cambian de dirección cada cierto tiempo: si un día dejas de ver el módulo, comprueba si tu IP sigue siendo la misma.

Habilitar registros de depuración

Guarda en los registros del back-office el detalle de cada pago: cuándo se crea el intento de cobro, cómo se calculan los portes de la compra rápida y qué avisos llega a mandar Stripe. Está pensada para diagnosticar una incidencia concreta junto con el soporte, no para dejarla encendida a diario.

Los avisos y los errores del módulo se guardan siempre, tengas esta opción activada o no. Lo que añade es el detalle de lo que sí funcionó, que es lo que hace falta para reconstruir un pago que se comportó de forma extraña.

Reembolso automático en nota de abono

Cuando alguien crea una nota de abono en PrestaShop, el módulo emite en Stripe el reembolso por ese mismo importe, sin tener que repetir la operación a mano en la pestaña del pedido. Viene desactivada de fábrica: actívala solo si tu forma de trabajar es emitir siempre la nota de abono primero.

Stripe

Aquí van las credenciales que conectan la tienda con tu cuenta de Stripe y el secreto con el que se comprueban los avisos que Stripe envía. Todas se copian desde tu panel de Stripe.

Modo sandbox (prueba)

Cambia entre el entorno de pruebas de Stripe y el real. Con el modo activado, el módulo trabaja con tus claves de prueba y ningún cobro es real, así que puedes hacer pedidos completos con las tarjetas de prueba de Stripe. Al desactivarlo, pasa a usar las claves en vivo y los pagos se cobran de verdad.

Los campos que aparecen debajo cambian según cómo esté el interruptor: con el modo activado se piden la Clave pública de prueba y la Clave secreta de prueba; con el modo desactivado, la Clave pública en vivo y la Clave secreta en vivo. Las cuatro están en tu panel de Stripe, en Desarrolladores → Claves de API.

Las claves de prueba y las reales no son intercambiables: una clave de prueba en el modo real (o al revés) deja el pago sin funcionar. Si el módulo no conecta con Stripe, esto es lo primero que hay que mirar.

Secreto de webhook

Es la firma con la que el módulo comprueba que un aviso viene realmente de Stripe y no de un tercero. Sin este valor, o con uno que no corresponda al endpoint registrado, los avisos se rechazan y el módulo no se entera de los pagos que se confirman más tarde.

Lo encuentras en tu panel de Stripe, dentro de Webhooks, en el endpoint que hayas creado para tu tienda. En esta misma pantalla el módulo muestra la URL del webhook de tu tienda con un botón para copiarla: es la dirección que hay que dar de alta en Stripe. Tienes el detalle en Webhooks.

Pagos

Esta pestaña decide cómo se le presentan al cliente los métodos de pago: todos juntos dentro de un único formulario, o cada uno como una opción independiente de la lista de pago. Es una elección excluyente, y el propio formulario cambia según lo que escojas.

Habilitar formulario de pago integrado

Muestra todos los métodos disponibles dentro de un solo formulario en lugar de repartirlos como opciones separadas. Quien decide entonces qué métodos ofrecer es Stripe, según el país del cliente, la moneda y el importe del pedido, así que no hace falta que los actives uno a uno.

Al activarla, los interruptores de los métodos individuales dejan de aplicarse y en su lugar aparecen el diseño, el tema y las restricciones del formulario integrado. Si prefieres controlar exactamente qué ve cada cliente, déjala desactivada y configura los métodos uno a uno.

Que Stripe elija no significa que ofrezca todo lo que aparece en esta guía: solo propone los métodos que tu cuenta tiene habilitados y aprobados, y que además encajen con el país del comercio, la moneda y el importe del pedido. Si echas en falta alguno, míralo primero en tu panel de Stripe.

Diseño de formulario integrado

Elige cómo se agrupan los métodos dentro del formulario: Pestañas, Acordeón (con botones de radio) o Acordeón (sin botones de radio). Con pocas opciones las pestañas se leen mejor; con muchas, el acordeón ocupa menos espacio.

Tema de formulario integrado

Aspecto visual del formulario: Stripe, Plano, Noche o Ninguno. Los tres primeros son los estilos que trae Stripe. Con "Ninguno" el formulario se queda sin ninguno de ellos y se dibuja con la apariencia mínima del navegador, que es el punto de partida más neutro si tu checkout tiene un diseño muy propio. Ten en cuenta que el formulario lo pinta Stripe dentro de un marco aislado: no toma los estilos de tu tema, así que "Ninguno" no lo integra en tu diseño por sí solo.

Restringir por países

Limita a qué países de entrega se ofrece el método. Si lo dejas vacío, se muestra en todos. Es la forma de ofrecer en cada mercado lo que allí se usa de verdad, en lugar de enseñar a todo el mundo una lista larga de métodos locales de otros países.

Restringir por grupos de clientes

Limita a qué grupos de clientes se ofrece el método. Si lo dejas vacío, se muestra a todos. Sirve, por ejemplo, para reservar el pago aplazado a los clientes mayoristas o para dejar un método solo a un grupo concreto mientras lo pruebas.

Estas dos restricciones aparecen dentro de cada método, no una sola vez para todos: cada uno lleva las suyas, y también las tiene el formulario integrado. En el formulario integrado se aplican al bloque entero, así que restringirlo esconde de golpe todos los métodos que contiene.

Las restricciones actúan en la lista de pago del checkout, no en los botones de compra rápida. El módulo necesita saber a qué país se envía y a qué grupo pertenece el cliente, y eso solo se conoce cuando ya ha elegido su dirección. Al pulsar un botón de Express Checkout, la dirección se elige después, dentro de la ventana de la cartera, así que ahí no hay nada que comparar y el botón se muestra igualmente. Si necesitas que una cartera no se ofrezca en un mercado, desactívala en las páginas correspondientes en lugar de confiar en la restricción.

Métodos de pago

Con el formulario integrado desactivado, cada método se activa por separado y aparece como una opción propia en la lista de pago del checkout. Todos admiten las mismas restricciones por país de entrega y por grupo de cliente que se explican más arriba.

Método	Cómo paga el cliente	Dónde se usa
Tarjeta de crédito/débito	En el propio checkout	Todos los mercados
BLIK	Código de seis dígitos de su aplicación bancaria	Polonia
Adeudo Directo SEPA	Autoriza el cargo con su IBAN	Zona SEPA
iDEAL	Termina en la web de su banco	Países Bajos
Bancontact	Termina en la web de su banco	Bélgica
EPS	Termina en la web de su banco	Austria
Przelewy24 (P24)	Termina en la web de su banco	Polonia
TWINT	Termina en su aplicación	Suiza
Klarna	Termina en Klarna (pago aplazado)	Europa y Estados Unidos
Afterpay / Clearpay	Termina en Afterpay (pago aplazado)	Reino Unido, Estados Unidos y Oceanía
Affirm	Termina en Affirm (pago aplazado)	Estados Unidos y Canadá
PayPal	Termina en PayPal	Internacional
Multibanco	Recibe una referencia y paga después	Portugal
OXXO	Recibe un comprobante y paga en tienda	México
Boleto	Recibe un documento y paga en el banco	Brasil
Pix	Paga desde su banco con el código	Brasil

Tarjeta de crédito/débito

Cobra con las tarjetas de crédito y débito habituales dentro del propio checkout, sin que el cliente salga de tu tienda. Cuando el banco exige autenticación reforzada, la pantalla de 3D Secure aparece sola y el cliente vuelve al mismo sitio al terminar.

Mostrar código postal en el formulario de tarjeta

Añade el campo de código postal al formulario de tarjeta. En algunos países el banco lo usa como comprobación adicional del titular, así que puede reducir los rechazos; en otros solo es un campo más que rellenar. Solo aparece cuando la tarjeta está activada.

iDEAL

El método más usado en los Países Bajos. Al confirmar, el cliente va a la página de su banco, autoriza la transferencia y vuelve a la tienda con el pedido ya hecho.

Bancontact

El equivalente belga: el cliente autoriza el pago en su banco o con su aplicación y vuelve a la tienda.

Klarna

Permite al cliente pagar más tarde o a plazos, según lo que Klarna le ofrezca en su país. El cliente termina el trámite en Klarna y tú cobras el importe completo igualmente.

EPS

Transferencia bancaria en línea habitual en Austria. El cliente elige su banco y confirma el pago allí.

Przelewy24 (P24)

Pasarela polaca que agrupa a la mayoría de bancos del país. El cliente escoge el suyo y autoriza la transferencia.

BLIK

También polaco, pero sin salir de la tienda: el cliente abre su aplicación bancaria, genera un código de seis dígitos y lo escribe en el checkout.

TWINT

La aplicación de pago móvil más extendida en Suiza. El cliente confirma la compra desde su teléfono.

Afterpay / Clearpay

Pago aplazado en varios plazos sin intereses para el cliente. Se llama Clearpay en el Reino Unido y Afterpay en el resto de mercados donde opera.

PayPal

Cobra por PayPal a través de tu propia cuenta de Stripe, sin instalar el módulo de PayPal aparte. El cliente autoriza el pago en PayPal y vuelve a la tienda.

Adeudo Directo SEPA

El cliente escribe su IBAN y autoriza el cargo en su cuenta. Ten en cuenta que un adeudo tarda días en confirmarse: el pedido no queda cobrado en el momento, sino cuando Stripe avisa de que el banco ha aceptado el cargo.

Pix

Pago instantáneo brasileño. El cliente recibe un código, lo paga desde la aplicación de su banco y el pedido se confirma en cuanto Stripe recibe el dinero.

Requiere una cuenta de Stripe registrada en Brasil. Si la tuya es de otro país, el propio back-office te lo avisa junto al nombre del método.

OXXO

El cliente recibe un comprobante con un número y paga en efectivo en cualquier tienda OXXO de México. El pedido queda a la espera hasta que Stripe confirma el ingreso.

Requiere una cuenta de Stripe registrada en México.

Boleto

El documento de pago habitual en Brasil: el cliente se descarga un PDF y lo paga en su banco o por la aplicación. El pedido se confirma cuando llega el ingreso.

Requiere una cuenta de Stripe registrada en Brasil.

Multibanco

En Portugal, el cliente recibe una entidad y una referencia con las que paga desde su banco o en un cajero. El pedido queda a la espera hasta que se recibe el pago.

Affirm

Pago a plazos en Estados Unidos y Canadá. El cliente contrata la financiación con Affirm y tú cobras el importe completo.

Requiere una cuenta de Stripe registrada en Estados Unidos o Canadá.

Activar un método aquí no basta: también tiene que estar habilitado en tu panel de Stripe, en la sección de métodos de pago de tu cuenta. Si un método no aparece en el checkout aunque su interruptor esté encendido, es lo primero que conviene comprobar, junto con el país y la moneda del pedido.

Express Checkout

Los botones de compra rápida permiten pagar con una cartera digital sin recorrer el checkout completo: el cliente pulsa el botón, elige dirección y envío dentro de la ventana de su propia cartera, y el pedido se crea al confirmar. Los portes y los impuestos se calculan con las reglas de tu tienda mientras esa ventana está abierta, con las tarifas y los transportistas que correspondan a la dirección que vaya eligiendo.

Cuando el carrito no necesita envío, porque solo lleva productos descargables o servicios, la ventana no pide dirección de entrega y el cliente solo confirma el pago.

Cada cartera aparece solo donde está disponible para el cliente. Apple Pay necesita un dispositivo Apple con Safari, y Google Pay, Chrome o un navegador compatible. Que tú no veas un botón en tu ordenador no significa que tus clientes no lo vean en el suyo.

El teléfono del cliente y estas carteras no caben a la vez. Apple Pay, Google Pay y Amazon Pay devuelven el teléfono; Link, PayPal y Klarna no pueden, y Stripe los esconde del botón mientras se pida. Lo decides tú con la opción Solicitar número de teléfono, en lugar de que el módulo lo resuelva por su cuenta.

Dónde aparecen los botones

En el carrito, la página de pago y el carrito lateral, la posición está fijada. En la ficha de producto puedes elegirla, porque es donde más varían los temas.

Página de Producto — Posición del Botón

Elige en qué punto de la ficha de producto se dibujan los botones:

Información adicional del producto (displayProductAdditionalInfo): debajo de los datos del producto. Es el valor de fábrica y el que más temas admiten.
Después del botón Añadir al carrito (displayAfterProductAddCartBtn): justo debajo del botón de compra.
Área de acciones del producto (displayProductActions): dentro del bloque de acciones, junto al botón de añadir al carrito.
Selector CSS personalizado (avanzado): en cualquier punto de la página, indicando tú el elemento de referencia.

Las tres primeras posiciones dependen de que tu tema las tenga previstas. Si eliges una que tu tema no dibuja, los botones no aparecen en ningún sitio: en ese caso, usa el selector CSS personalizado.

Selector CSS

Indica el elemento junto al cual se colocarán los botones, por ejemplo el botón de añadir al carrito. Solo aparece cuando has elegido la posición "Selector CSS personalizado".

Pruébalo antes en las herramientas de desarrollo del navegador, sobre una ficha de producto de tu tienda, y comprueba que coincide con un solo elemento. Un selector que casa con varios coloca los botones en el primero que encuentre, que no siempre es el que tenías en mente.

Posición relativa al elemento

Decide dónde se colocan los botones respecto al elemento que casa con el selector: Antes del elemento (beforebegin), Dentro, al inicio (afterbegin), Dentro, al final (beforeend) o Después del elemento (afterend, predeterminado). También aparece solo en el modo de selector CSS.

Cómo se ven los botones

Estas opciones se aplican a todos los botones de compra rápida a la vez, en todas las páginas donde aparezcan.

Altura del botón (px)

Altura común a todos los botones. Stripe admite valores entre 40 y 55 píxeles; de fábrica son 48. Conviene acercarla a la altura del botón de compra de tu tema para que no desentonen.

Máximo de columnas

Número máximo de botones por fila. Con Ilimitado (predeterminado) los reparte Stripe según el ancho disponible, que suele ser lo más razonable si tienes varias carteras activas.

Máximo de filas

Número máximo de filas de botones. Los que no quepan pasan al menú desplegable, de modo que un cliente con muchas carteras disponibles no se encuentre media pantalla de botones.

Menú desplegable

Decide qué pasa con los botones que no caben en la cuadrícula. Con Auto (predeterminado) lo resuelve Stripe; con Nunca no se agrupa ninguno.

"Nunca" solo es válido si el máximo de filas está en ilimitado. Si limitas las filas y a la vez desactivas el menú, los botones sobrantes no tendrían dónde ir.

Solicitar número de teléfono

Pide a la cartera el teléfono del cliente, que es el que necesita el transportista para avisar de la entrega. Viene activada de fábrica, y conviene dejarla así si vendes productos que se envían: sin ella el pedido llega al transportista sin teléfono de contacto.

Tiene una contrapartida que conviene conocer antes de decidir: Apple Pay, Google Pay y Amazon Pay devuelven el teléfono, pero Link, PayPal y Klarna no pueden, así que Stripe los oculta del botón de compra rápida mientras esta opción esté activada. Si esas tres carteras te importan más que el teléfono, desactívala.

En los carritos que solo llevan productos digitales el teléfono no se pide, aunque la opción esté activada: no hay entrega que avisar, y pedirlo costaría esas tres carteras a cambio de un dato que nadie va a usar. Eso lo decide el módulo, no esta opción.

Ocultar transportistas

Los transportistas que marques aquí no se ofrecen dentro de la ventana de la cartera. Es la opción que resuelve los puntos de recogida: exigen que el cliente elija una ubicación física en un mapa, y esa pantalla no existe en Apple Pay ni en Google Pay, así que un pedido con ese transportista se quedaría sin punto de entrega. Si lo dejas vacío, se ofrecen todos.

Ocultarlos aquí no los desactiva en la tienda: el cliente que compre por el checkout normal los sigue viendo, con su selector de punto de recogida.

Qué carteras se ofrecen

Cada cartera se activa por separado y trae las mismas sub-opciones: en qué páginas aparece y, cuando la cartera lo permite, el texto y el color de su botón.

Encender el interruptor es lo que autoriza a mostrar el botón, no lo que garantiza que se vea. Para que aparezca, la cartera tiene que estar además habilitada en tu cuenta de Stripe y disponible para ese cliente concreto: su navegador, su dispositivo, su país y la moneda del pedido. Por eso un mismo botón puede verse en un móvil y no en el ordenador de al lado, y no es un fallo de configuración.

Apple Pay

Muestra el botón de Apple Pay. Solo aparece en dispositivos Apple con Safari, que es donde el cliente tiene sus tarjetas guardadas.

Google Pay

Muestra el botón de Google Pay. Solo aparece en Chrome y en navegadores compatibles.

Link by Stripe

Muestra el botón de Link, la cartera del propio Stripe: los clientes que ya han guardado sus datos en cualquier tienda que use Stripe pagan sin volver a escribirlos.

PayPal

Muestra el botón de PayPal para los clientes que tienen su cuenta enlazada en el navegador.

Amazon Pay

Muestra el botón de Amazon Pay, con el que el cliente paga usando la dirección y el método guardados en su cuenta de Amazon.

Requiere tener Amazon Pay activado y conectado en tu panel de Stripe.

Klarna

Muestra el botón de Klarna para comprar ahora y pagar después, sin pasar por el checkout completo.

Requiere tener Klarna activado en tu panel de Stripe.

Mostrar como opción de pago

Disponible en Apple Pay y en Google Pay. Además del botón de compra rápida, ofrece la cartera como una opción más dentro de la lista de pago del checkout: como el cliente ya se ha identificado y ha elegido su dirección, le basta un toque para terminar. Es el único flujo de estas carteras en el que se conocen la dirección y el grupo del cliente, y por eso es el único que admite Restringir por países y Restringir por grupos de clientes.

Mostrar en la Página de Producto

Dibuja el botón de esa cartera en la ficha de producto, en la posición que hayas elegido más arriba. El cliente compra ese producto directamente, sin pasar por el carrito.

Mostrar en la Página del Carrito

Dibuja el botón de esa cartera en la página del carrito, junto al botón que lleva al checkout.

Mostrar en el Checkout

Dibuja el botón de esa cartera en la página de pago, como atajo para quien prefiera terminar con su cartera en lugar de rellenar el formulario.

Mostrar en el carrito lateral (One Page Checkout PS)

Dibuja el botón dentro del panel deslizante del carrito de One Page Checkout PS, para que el cliente pueda pagar desde cualquier página de la tienda sin abrir el checkout.

Requiere One Page Checkout PS 5.3.1 o superior. Sin ese módulo instalado, la opción no tiene efecto.

Texto del botón

Texto que se lee en el botón de esa cartera. Cada una admite los suyos: Apple Pay y PayPal ofrecen la lista más larga, Google Pay unos cuantos, y Klarna solo "Pay" o "Continue". Conviene elegirlo según dónde esté el botón: en una ficha de producto encaja mejor "Comprar" y en el carrito, "Pagar".

Tema del botón

Color del botón de esa cartera. Apple Pay admite negro, blanco y blanco con borde; Google Pay, negro y blanco; PayPal, dorado, azul, plata, blanco y negro; y Klarna, oscuro, claro y con borde. Elige el que contraste con el fondo de tu tema, sobre todo si es claro.

Pedidos y reembolsos

El módulo añade a los pedidos que ha cobrado la información del pago y las herramientas para devolverlo, de modo que no tengas que entrar en el panel de Stripe para las operaciones del día a día.

Pestaña Stripe del pedido

En los pedidos pagados con este módulo (Pedidos → Pedidos → el pedido que quieras) aparece una pestaña llamada "Stripe" con todo lo que se sabe del cobro. En un pedido cobrado por otro medio la pestaña no se muestra:

Identificador del cargo, con enlace directo a esa operación en tu panel de Stripe.
Método de pago con el que pagó el cliente, con el nombre de la cartera cuando pagó con una.
Importe cobrado, importe ya reembolsado e importe que queda por reembolsar.
Modo: si el pago se hizo en pruebas o de verdad.

Mientras quede importe reembolsable, debajo aparece un formulario para devolver la cantidad que indiques. Escribe el importe, confirma y el reembolso se emite en Stripe: si devuelves solo una parte, el pedido pasa al estado de reembolso parcial y sigue admitiendo devoluciones posteriores hasta agotar el total.

En los pagos con comprobante (Multibanco, OXXO, Boleto y Pix) esta misma pestaña muestra los datos que necesita el cliente: la entidad y la referencia, el número del comprobante, el PDF descargable, el enlace al documento original y la fecha en que caduca. Son útiles para reenviárselos a quien dice no haberlos recibido.

Estados de pedido

Al instalarse, el módulo crea tres estados propios en PrestaShop para que puedas distinguir de un vistazo estas situaciones:

Estado	Cuándo se asigna
Waiting for Stripe payment	El pedido está hecho y espera a que el cliente pague su comprobante fuera de la tienda (Multibanco, OXXO, Boleto o Pix).
Stripe partial refund	Se ha devuelto parte del importe y todavía queda cantidad sin reembolsar.
Stripe disputed payment	El cliente ha impugnado el cargo en su banco y Stripe lo ha comunicado.

Los nombres de estos tres estados se muestran en inglés en todos los idiomas. Puedes cambiarlos, como cualquier otro estado, en Parámetros de la tienda → Estados.

Webhooks

Los webhooks son los avisos que Stripe manda a tu tienda cuando algo cambia en un pago. Son imprescindibles: hay cobros que se confirman horas o días después (un comprobante, un adeudo SEPA) y otros en los que el cliente paga pero no llega a volver a la tienda. Sin webhooks, esos pedidos no se enterarían nunca.

1

Copia la URL de tu tienda

Está en la pestaña Stripe del módulo, con un botón para copiarla al portapapeles.

2

Da de alta el endpoint en Stripe

En tu panel de Stripe, dentro de Desarrolladores → Webhooks, añade esa dirección como destino y marca los seis eventos de la tabla de abajo. Si dejas alguno fuera, tu tienda se quedará sin enterarse de lo que ese evento cuenta.

3

Pega el secreto en el módulo

Stripe te da un secreto de firma para ese endpoint: cópialo en "Secreto de webhook".

El módulo atiende estos eventos:

Evento	Qué hace el módulo
`charge.succeeded`	Da el cobro por bueno y marca el pedido como pagado.
`charge.failed`	Marca el pago como fallido y pasa el pedido a error.
`charge.expired`	Cancela el pago cuando el cargo caduca sin completarse.
`charge.dispute.created`	Pasa el pedido al estado de pago disputado.
`payment_intent.succeeded`	Confirma los pagos con comprobante cuando el cliente los abona.
`payment_intent.payment_failed`	Marca el pago como fallido cuando el comprobante caduca o el cobro se rechaza.

Un pago cobrado nunca se queda sin pedido. Si el cliente paga y no vuelve a la tienda —porque cerró la ventana de PayPal después de autorizar el cobro, por ejemplo—, el módulo crea el pedido igualmente al recibir el aviso de Stripe, comprobando antes que no exista ya para no duplicarlo.

Todos los avisos se validan con la firma del secreto de webhook: si no coincide, se rechazan. Y el módulo solo atiende los que llevan su propia marca, así que los avisos de otras integraciones de Stripe que tengas en la misma cuenta se ignoran sin tocar nada.

Flujos de pago

Los métodos no se comportan todos igual, y saber a qué grupo pertenece cada uno explica por qué unos pedidos nacen pagados y otros no.

Pago en la propia página

Tarjeta, Apple Pay, Google Pay, Link, BLIK y el formulario integrado. El cliente paga sin salir del checkout: el módulo prepara el cobro mientras rellena sus datos y, al confirmar, el pedido se crea ya cobrado con la respuesta de Stripe.

Pago autorizado en la página, cobrado después

El adeudo SEPA. El cliente da su IBAN y autoriza el cargo sin salir del checkout, igual que en el grupo anterior, pero el banco tarda días en ejecutarlo: el pedido se crea enseguida y no queda cobrado hasta que Stripe avisa de que el dinero ha entrado. Trátalo como un pago pendiente, no como uno hecho.

Pago con redirección

iDEAL, Bancontact, Klarna, PayPal, EPS, Przelewy24, TWINT, Afterpay/Clearpay y Affirm. El cliente sale a la página del proveedor, paga allí y vuelve a la tienda con el resultado. Si por lo que sea no vuelve, el pedido se crea igualmente cuando Stripe avisa del cobro.

Pago con comprobante

Multibanco, OXXO, Boleto y Pix. El pedido se crea en el estado de espera y el cliente recibe los datos para pagar fuera de la tienda. Cuando Stripe confirma el ingreso, el pedido pasa a pagado por sí solo.

En los dos últimos grupos el pedido puede tardar en confirmarse, así que conviene no preparar el envío hasta que salga del estado de espera.

Monedas sin decimales

Hay monedas que no usan céntimos, y Stripe las trata de forma distinta al resto. El módulo lo aplica solo, sin que tengas que configurar nada, en estas: BIF, CLP, DJF, GNF, JPY, KMF, KRW, MGA, PYG, RWF, UGX, VND, VUV, XAF, XOF y XPF.

Si tu tienda vende en alguna de ellas, comprueba en un pedido de prueba que el importe que llega a Stripe coincide con el del pedido: es donde se nota si la moneda está bien configurada en PrestaShop.

Traducciones

Esta sección te permite editar y personalizar todas las etiquetas, mensajes y textos del módulo en los diferentes idiomas disponibles en tu tienda. Es útil para adaptar el módulo a terminología específica de tu negocio o aplicar traducciones según tus necesidades.

Advertencia: Algunas expresiones utilizan la sintaxis %s que no debes reemplazar ni modificar, ya que son marcadores de posición para variables que se completan dinámicamente.

Editar Traducciones

El módulo incluye un editor de traducciones que te permite personalizar todos los textos en cualquier idioma instalado en tu tienda.

Accede a la sección "Traducciones" en la configuración del módulo
Selecciona el idioma que deseas editar
Modifica las cadenas de texto según necesites
Haz clic en "Guardar" para aplicar los cambios

Si vacías una casilla y guardas, esa traducción se borra y el texto vuelve a mostrarse en inglés. Para dejar un texto como estaba, vuelve a escribirlo en lugar de vaciarlo.

Acciones disponibles

El editor de traducciones incluye varias acciones para gestionar tus traducciones:

Guardar: Guarda los cambios realizados en las traducciones.
Guardar y descargar: Guarda los cambios y descarga el archivo de traducciones para respaldo.
Comparte con nosotros: Envía tus traducciones a nuestro equipo PresTeamShop para incluirlas en futuras versiones del módulo.
Expandir todo: Muestra todas las secciones de traducciones expandidas.
Contraer todo: Oculta el contenido de todas las secciones.

Editores de código

Permite agregar código CSS y JavaScript personalizado directamente desde el panel de configuración, sin necesidad de acceder a los archivos del servidor.

Editores disponibles:

CSS personalizado: Agrega estilos para personalizar la apariencia.
JavaScript personalizado: Agrega scripts para personalizar el comportamiento.

Precaución: Utiliza esta sección solo si tienes conocimientos técnicos. Un código incorrecto puede afectar el funcionamiento del módulo o de la tienda.

Copias de seguridad

El sistema de copias de seguridad te permite proteger la configuración del módulo y restaurarla en caso de necesidad.

Generar copia de seguridad

Para crear una nueva copia de seguridad, haz clic en el botón "Generar nueva copia de seguridad". El sistema creará un respaldo de la configuración actual del módulo: las claves de Stripe, los métodos activos con sus restricciones por país y grupo, y los ajustes de los botones de compra rápida.

Subir copia de seguridad

Si tienes una copia de seguridad descargada previamente, puedes cargarla haciendo clic en el botón "Subir copia de seguridad". Se abrirá un diálogo donde podrás seleccionar el archivo ZIP de la copia de seguridad.

Copias de seguridad disponibles

La lista muestra todas las copias de seguridad creadas. Puedes filtrar por fecha utilizando el selector de fecha y actualizar la lista con el botón "Actualizar lista".

Acciones de la lista

Cada copia de seguridad en la lista tiene las siguientes acciones disponibles:

Restaurar copia de seguridad

Restaura la configuración del módulo

Descargar copia de seguridad

Descarga el archivo ZIP

Eliminar copia de seguridad

Elimina la copia de seguridad

Precaución: Restaurar una copia de seguridad sobrescribirá la configuración actual del módulo. Esta acción no se puede deshacer.

Para restaurar, haz clic en el botón "Restaurar copia de seguridad" de la copia que deseas recuperar y confirma la acción en el diálogo.

Compatibilidad

Dónde funciona el módulo y qué hace falta en cada caso.

PrestaShop y PHP

Entorno	Compatibilidad
PrestaShop	1.7.6 o superior, incluidas las series 8.x y 9.x
PHP	7.2.5 o superior
Multitienda	Sí, el módulo funciona en una instalación multitienda. La configuración es común: no admite claves ni métodos distintos por tienda
Multi-idioma	Sí, con los textos editables desde el editor de traducciones

Dispositivos y carteras

Las carteras digitales no las decide el módulo: aparecen si el cliente puede usarlas en ese momento, y si no, la opción sencillamente no se muestra.

Cartera	Dónde aparece
Apple Pay	Safari en macOS e iOS, con una tarjeta guardada en el dispositivo
Google Pay	Chrome y navegadores compatibles, con una tarjeta guardada en la cuenta
Link, PayPal, Amazon Pay y Klarna	Cualquier navegador moderno, según lo que Stripe ofrezca para ese cliente y ese pedido

Sin HTTPS no aparece ninguna cartera, ni siquiera en pruebas. Es la causa más habitual de que los botones no se vean en un entorno de desarrollo.

Otros módulos

Módulo	Versión probada	Notas
One Page Checkout PS v5	5.3.2	Formulario de pago dentro del checkout, carteras en la lista de pago y botones de compra rápida en el carrito lateral (desde la 5.3.1).

Estos son los checkouts con los que probamos cada versión. Con otro módulo que sustituya el proceso de compra, los métodos de pago deberían aparecer siempre que use los puntos de integración estándar de PrestaShop, pero no podemos darlo por probado: los botones de compra rápida y las carteras dentro de la lista de pago dependen de cómo esté construido ese checkout. Si usas uno que no esté aquí, pruébalo antes de abrirlo a tus clientes y escríbenos indicando el módulo y su versión si algo no encaja.

Solución de Problemas

Problemas Comunes

Verifica que el módulo esté correctamente instalado y activado. Si el módulo tiene la opción de modo depuración y esta está activa, asegúrate de que tu IP esté en la lista de IPs permitidas. También limpia la caché de PrestaShop desde Parámetros avanzados → Rendimiento.

Verifica que tu versión de PHP sea compatible: el módulo necesita 7.2.5 como mínimo, y por arriba el límite lo pone tu versión de PrestaShop, no el módulo. Revisa los logs de error de PHP y PrestaShop. Si el problema persiste, contacta con soporte técnico proporcionando los mensajes de error.

Si recibes un error de override durante la instalación, significa que otro módulo ya está utilizando los mismos archivos. No intentes resolverlo manualmente. Contacta con nuestro equipo de soporte para recibir ayuda personalizada.

Lo primero es comprobar que cada clave está donde le toca: las de prueba solo funcionan con "Modo sandbox (prueba)" activado, y las reales solo con él desactivado; cruzarlas es el error más frecuente. Después, que tu tienda se sirva por HTTPS y que el servidor pueda salir a internet para hablar con Stripe: algunos alojamientos bloquean las conexiones salientes y hay que pedir que las abran.

Casi siempre es el webhook. Comprueba que la dirección que muestra la pestaña Stripe del módulo está dada de alta en tu panel de Stripe y que el "Secreto de webhook" es el de ese mismo endpoint: con un secreto que no corresponde, los avisos se rechazan y el pedido nunca llega a crearse. Para ver qué está pasando, activa "Habilitar registros de depuración" y revisa Parámetros avanzados → Logs.

Cada cartera aparece solo donde el cliente puede usarla: Apple Pay en Safari sobre un dispositivo Apple, Google Pay en Chrome. Comprueba también que la cartera esté activada, que tenga marcada la página en la que la buscas y que la tienda se sirva por HTTPS. Si el botón falta solo en la ficha de producto, es que la posición elegida no existe en tu tema: cambia a otra o usa "Selector CSS personalizado (avanzado)".

Además del interruptor del módulo, el método tiene que estar habilitado en tu cuenta de Stripe. Revisa también sus restricciones: si tiene países o grupos de clientes seleccionados, solo se muestra a quien encaje. Y ten en cuenta que muchos métodos son locales y solo se ofrecen en su país y su moneda, así que un pedido en otra divisa no los mostrará.

El formulario de reembolso solo aparece mientras quede importe por devolver: si ya se reembolsó todo, la pestaña lo indica y no ofrece el formulario. Comprueba también en tu panel de Stripe que esa operación admite devolución, porque algunos métodos tienen plazos o condiciones propias. Si usas notas de abono, recuerda que "Reembolso automático en nota de abono" viene desactivado de fábrica.

Preguntas Frecuentes

Licencias y Compra

La licencia incluye actualizaciones y soporte técnico durante un período. Al comprar el módulo tienes 6 meses incluidos sin coste, y puedes contratar 12 o 24 meses, con opciones de pago con descuento. Cuando termina el período, el módulo sigue funcionando: lo que dejas de recibir son las actualizaciones y el soporte, y puedes renovar cuando quieras para volver a tenerlos.

La licencia te permite activar el módulo en dos sitios: una licencia para tu tienda en producción y otra para un entorno de desarrollo o pruebas. Incluye además todas las actualizaciones y el soporte técnico mientras el período esté activo.

Puedes ver la demo en vivo disponible en nuestra web para conocer todas las funcionalidades del módulo. No ofrecemos versiones de prueba para instalar en tu sitio.

El módulo seguirá funcionando con normalidad, pero no recibirás nuevas actualizaciones ni tendrás acceso al soporte técnico.

Instalación y Compatibilidad

El módulo está diseñado para funcionar con cualquier tema que siga los estándares de PrestaShop. Donde más varían los temas es en la ficha de producto, y por eso los botones de compra rápida admiten cuatro posiciones distintas, incluida una por selector CSS para colocarlos donde haga falta. Si te encuentras un conflicto con tu tema, escríbenos.

Sí. La cuenta se crea gratis en stripe.com y no tiene cuota mensual: Stripe cobra una comisión por transacción. Desde tu panel de Stripe obtienes las claves que pide el módulo y activas los métodos de pago que quieras ofrecer.

Sí. Tienes una licencia para producción y otra para desarrollo o pruebas, así puedes probar las actualizaciones y los cambios antes de aplicarlos en tu tienda en vivo. Al activar la de pruebas, marca "¿Es una licencia de desarrollo?" en la pantalla de licencia del módulo.

Sí, y es la combinación que más probamos. El formulario de pago se integra dentro del checkout de una página, Apple Pay y Google Pay pueden ofrecerse en la lista de pago, y los botones de compra rápida aparecen también en el carrito lateral a partir de la versión 5.3.1 de One Page Checkout PS.

No, la instalación es muy sencilla y se realiza desde el Back Office de PrestaShop. Si tienes algún problema durante la instalación, nuestro equipo de soporte está disponible para ayudarte.

Uso del módulo

Sí, y conviene no dejarlo para después. Sin el webhook, tu tienda no se entera de los cobros que se confirman más tarde (comprobantes, adeudos SEPA), ni de los reembolsos o impugnaciones que se hagan desde Stripe, ni puede rescatar el pedido de un cliente que pagó y no volvió a la tienda.

No. Los datos de la tarjeta viajan directamente del navegador del cliente a Stripe, que es quien cumple los requisitos de seguridad del sector para tratarlos. Tu tienda recibe solo el resultado del cobro y un identificador con el que consultarlo.

No. El módulo funciona en una instalación multitienda, pero su configuración es común a todas: las claves de Stripe, los métodos activos y sus restricciones se comparten, así que todas cobran contra la misma cuenta. Al abrir el módulo con el multitienda activado tendrás que situarte en una tienda concreta para poder configurarlo, pero lo que guardes ahí se aplica al conjunto.

Activa "Modo sandbox (prueba)" con tus claves de prueba y usa las tarjetas de prueba que Stripe publica en su documentación. Recuerda registrar también un webhook para el entorno de pruebas, o los pagos que se confirman más tarde no llegarán a tu tienda. Al terminar, desactiva el modo y pega las claves reales.

Actualizaciones

No, las actualizaciones conservan toda tu configuración y datos. Solo perderías la configuración si desinstalas y vuelves a instalar el módulo, lo cual no es necesario para actualizar.

Puedes verificar las nuevas versiones visitando nuestra página web o accediendo a tu cuenta en nuestra tienda.

No es obligatorio, pero se recomienda actualizar para disfrutar de las últimas mejoras, nuevas funcionalidades y correcciones de seguridad.

Soporte Técnico

Normalmente respondemos en menos de 24-48 horas laborables.

Sí, siempre y cuando tengas el soporte activo dentro del período de tu licencia, tienes acceso completo al soporte técnico.

Puedes solicitar ayuda con la instalación, configuración, resolución de errores y consultas generales sobre el funcionamiento del módulo.

Sí, nuestro equipo de soporte atiende tanto en español como en inglés.

Reembolsos y Garantía

Solo aplicamos reembolso en el caso de que el módulo no logre funcionar en tu tienda después de recibir soporte técnico. Ten en cuenta que antes de la compra dispones de una demo para probar el módulo.

Garantizamos que el módulo funciona según lo descrito en la documentación. Si encuentras algún bug, lo corregimos sin coste adicional.

Personalización

Sí, ofrecemos servicios de desarrollo a medida. Contacta con nuestro equipo de soporte para solicitar un presupuesto personalizado.

No se recomienda modificar el código del módulo por tu cuenta, ya que perderías el soporte técnico y al actualizar el módulo perderías los cambios realizados. Si necesitas funcionalidades adicionales, te recomendamos solicitar un presupuesto de desarrollo a medida para que los cambios se incluyan en el módulo y se mantengan en futuras versiones.

Soporte

Si necesitas ayuda adicional o tienes alguna pregunta sobre el módulo, estamos aquí para ayudarte.

Soporte por Email

Envíanos un correo y te responderemos lo antes posible.

support@presteamshop.com

Centro de Ayuda

Visita nuestro centro de ayuda para más recursos.

Visitar Centro de Ayuda