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.
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.
Conseguir las claves de Stripe
El módulo se conecta con tu cuenta de Stripe mediante dos claves: una clave publicable, que empieza por pk_ y se usa en la página de pago, y una clave secreta, que empieza por sk_ y solo la usa tu servidor. Stripe da un par para pruebas (pk_test_ y sk_test_) y otro para cobrar de verdad (pk_live_ y sk_live_). Normalmente no hace falta nada más: el webhook lo crea el propio módulo al conectarse, y el recuadro de estado te avisa si no ha podido.
1
Entra en tu cuenta de Stripe
Inicia sesión en dashboard.stripe.com. Si aún no tienes cuenta, puedes crearla gratis en stripe.com y empezar con las claves de prueba antes de terminar el alta.
2
Abre la página de claves
En la pestaña Stripe del módulo, pulsa Consigue tus claves en Stripe: te lleva directamente a la página de claves del modo que tengas elegido, la de prueba con «Modo sandbox (prueba)» activado y la real con él desactivado. También puedes llegar desde el panel de Stripe, en Desarrolladores → Claves de API.
3
Copia la clave publicable
Es la que empieza por pk_. Pégala en la Clave pública de prueba o en la Clave pública en vivo, según el modo, y guarda.
4
Muestra y copia la clave secreta
Viene oculta: pulsa sobre ella para que Stripe la muestre, cópiala entera (empieza por sk_) y pégala en la Clave secreta de prueba o en la Clave secreta en vivo. Guarda.
5
Deja que el módulo se conecte
En cuanto están guardadas las dos claves del modo, el módulo las comprueba con Stripe, muestra el nombre de tu cuenta y registra el webhook de tu tienda. No tienes que pulsar nada más; si quieres repetir la comprobación, usa Volver a comprobar la conexión.
Para cobrar de verdad tu cuenta de Stripe tiene que estar activada (datos de la empresa y cuenta bancaria); hasta entonces Stripe solo te da claves de prueba. Cuando la tengas, desactiva «Modo sandbox (prueba)» y repite los pasos 2 a 4 con las claves en vivo: cada modo tiene sus propias claves y su propio webhook. Y guarda la clave secreta en vivo en un sitio seguro: en modo real Stripe no siempre deja volver a verla, y si la pierdes tendrás que generar una nueva.
Si prefieres no usar la clave secreta completa, el módulo acepta también una clave restringida (empieza por rk_), que se crea en la misma página de Stripe y se pega en el campo de la clave secreta. Para que pueda registrar el webhook por sí solo, dale permiso de escritura en Webhook Endpoints; si no, tendrás que crear el webhook a mano.
Stripe
Aquí se conecta la tienda con tu cuenta de Stripe. Normalmente basta con pegar las dos claves del modo que vayas a usar: al guardarlas, el módulo las comprueba e intenta crear en Stripe el webhook de tu tienda, y el recuadro de estado te dice si lo ha conseguido. Si aún no las tienes, mira Conseguir las claves 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, la Clave secreta de prueba y el Secreto de webhook de prueba; con el modo desactivado, la Clave pública en vivo, la Clave secreta en vivo y el Secreto de webhook en vivo. Cada modo guarda los suyos, así que puedes tener los dos configurados y cambiar de uno a otro sin volver a pegar nada.
Las claves de prueba y las reales no son intercambiables. Si pegas una clave de prueba con el modo desactivado (o al revés), el módulo te lo dice al conectarse en vez de dejar el pago sin funcionar; lo mismo si la pública y la secreta están cambiadas de campo.
Secreto de webhook de prueba
Es la firma con la que el módulo comprueba que un aviso de pruebas viene realmente de Stripe y no de un tercero. No hace falta escribirlo: se rellena solo cuando el módulo se conecta y crea el webhook en Stripe. Pégalo a mano únicamente si la conexión automática no ha podido crear el webhook.
Secreto de webhook en vivo
Lo mismo para los pagos reales. Como Stripe usa un webhook distinto para cada modo, cada uno tiene su propio secreto, y el módulo usa el que corresponde según venga el aviso de pruebas o del modo real.
Estado de la conexión
Debajo de los campos, un recuadro te dice cómo está el modo elegido: el nombre de la cuenta de Stripe a la que está conectada la tienda, si el webhook está registrado, o qué falla si algo no va bien. Los errores habituales vienen con su arreglo (una clave en el campo que no es, una clave de otro modo, una clave que Stripe no acepta o un servidor que no llega a Stripe); cualquier otro se muestra con el mensaje que devuelve Stripe. El botón Conectar con Stripe, o Volver a comprobar la conexión si ya se conectó antes, repite la comprobación cuando quieras.
Al conectarse, el módulo da de alta en tu cuenta de Stripe la URL del webhook de la tienda, la que ves al final de la pantalla, con los eventos que necesita. Si ya había un webhook para esa misma dirección, lo pone al día y lo reactiva si Stripe lo había desactivado por fallos de entrega; si era uno creado a mano cuyo secreto el módulo no conoce, lo sustituye por uno nuevo. Los webhooks de otras tiendas o de otras aplicaciones de tu cuenta no se tocan.
Si el webhook no se puede crear, la conexión sigue siendo válida y el recuadro dice el motivo. Stripe solo envía avisos a direcciones públicas y con HTTPS: si tu tienda no es accesible desde internet, ni el webhook automático ni uno creado a mano recibirán nada hasta que lo sea. Si tu cuenta ya tiene el máximo de 16 webhooks, borra en Stripe uno que no uses y vuelve a conectar. Y si usas una clave restringida sin permiso sobre los webhooks, puedes crearlo a mano y pegar su secreto en el campo del modo que corresponda (ver
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 del comprador, que es el que necesita el transportista para avisar de la entrega; Link, PayPal y Klarna no pueden, y Stripe los esconde del botón mientras se pida. Lo resuelve el módulo con lo que tengas activado: basta con activar Link, PayPal o Klarna para que deje de pedirlo, de modo que esas tres siguen visibles y, a cambio, los pedidos de compra rápida llegan con el teléfono relleno a «00». Si solo tienes activas las carteras que sí pueden darlo, se pide.
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.
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.
De dónde salen los gastos de envío de la cartera
La ventana de la cartera, sea cual sea, enseña tus transportistas con sus tarifas, calculadas con la dirección que devuelve. Si esa dirección trae la provincia, se usa, y eso vale para cualquier país: el módulo la reconoce por su código ISO o por su nombre, venga como venga escrita. Cuando llega sin provincia y tu país reparte las tarifas en varias zonas, el módulo la deduce del código postal en España, Portugal, Francia, Finlandia, Estados Unidos, Canadá, Australia y México. Así, tanto los territorios con tarifa propia (Baleares, Canarias, Ceuta y Melilla, Azores, Madeira, Córcega, los departamentos franceses de ultramar y Åland) como los estados y provincias de los cuatro países de fuera de Europa se cobran con la zona que tengas configurada para ellos y no con la del país.
Si la cartera no manda la provincia y tampoco se puede deducir del código postal, se cobra la tarifa de la zona del país, que puede quedarse corta. El caso queda anotado con la opción
Habilitar registros de depuración activada, en
Parámetros avanzados → Logs, así que ahí puedes ver a qué pedidos les ha pasado. Hay países, como Italia o Grecia, en los que el código postal no permite deducir la región con fiabilidad: ahí no se intenta, porque deducirla mal cobra igual de mal que no deducirla.
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.
Normalmente no tienes que hacer nada: el módulo registra el webhook en Stripe al conectarse con tus claves (ver Stripe). Los pasos de abajo son solo para cuando el recuadro de conexión indica que no ha podido crearlo y el motivo no se arregla volviendo a conectar, por ejemplo con una clave restringida sin permiso sobre los webhooks.
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 (empieza por whsec_): cópialo en "Secreto de webhook de prueba" o en "Secreto de webhook en vivo", según el modo en el que lo hayas creado.
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í. Con el multitienda activado hay que situarse en una tienda concreta para configurar el módulo, y lo que guardes ahí queda en esa tienda: cada una puede tener sus claves y sus métodos |
| 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.