PTS Stripe - Guía de Usuario

Introducción

PTS Stripe es un módulo de pago avanzado para PrestaShop que permite aceptar pagos a través de Stripe, una de las plataformas de procesamiento de pagos más seguras y confiables del mundo. El módulo ofrece soporte para más de 17 métodos de pago diferentes, incluyendo tarjetas de crédito/débito, Apple Pay, Google Pay, PayPal, Klarna, iDEAL y otros métodos de pago locales de distintas regiones.

¿Qué es PTS Stripe?

PTS Stripe es un módulo de pago avanzado para PrestaShop que permite aceptar pagos a través de Stripe, una de las plataformas de procesamiento de pagos más seguras y confiables del mundo. El módulo ofrece soporte para más de 17 métodos de pago diferentes, incluyendo tarjetas de crédito/débito, Apple Pay, Google Pay, PayPal, Klarna, iDEAL y otros métodos de pago locales de distintas regiones.

Características principales

17+ métodos de pago soportados: Ofrece a tus clientes múltiples opciones para pagar, incluyendo tarjetas internacionales, métodos locales europeos, billeteras digitales, métodos de "compra ahora, paga después" (BNPL) y opciones de pago en efectivo.
Express Checkout (carrito Express): Permite a tus clientes completar compras rápidamente usando Apple Pay, Google Pay, Link, PayPal, Amazon Pay y Klarna directamente desde las páginas de producto, carrito y checkout.
Formulario de pago integrado: Opción para mostrar todos los métodos de pago disponibles en un único formulario moderno (Payment Element) gestionado completamente por Stripe.
Panel de administración moderno: Interfaz intuitiva y responsive con todas las opciones de configuración organizadas en secciones temáticas.
Reembolsos desde el backoffice: Procesa reembolsos totales o parciales directamente desde la página de detalle del pedido sin salir de PrestaShop.
Sincronización con webhooks: Los pagos se mantienen sincronizados automáticamente mediante webhooks de Stripe (confirmación de pago, disputas, reembolsos, etc.).
Modo sandbox/test: Prueba todos los métodos de pago sin procesar transacciones reales utilizando las claves de API de test de Stripe.
Autenticación SCA (3D Secure 2): Cumplimiento automático de PSD2 y SCA mediante Stripe, sin complejidad adicional.
Soporte multimoneda: Acepta pagos en cualquier moneda soportada por Stripe, con manejo automático de monedas sin decimales.
Logging detallado: Información completa de todas las transacciones y errores disponible en los logs de PrestaShop para debugging y auditoría.

Compatibilidad y requisitos

Versión del módulo: 5.1.0
Compatibilidad con PrestaShop: 1.7.6 hasta 8.x y 9.x
Compatibilidad con PHP: 7.2+

Compatible con One Page Checkout (onepagecheckoutps) v4 y v5, incluyendo v5.2.0.

Requisito	Mínimo	Recomendado
PrestaShop	1.7.6 (compatible con 8.x y 9.x)	Última versión
PHP	7.2	8.0+
MySQL	5.7	8.0+
HTTPS	Requerido	Sí

Instalación

Para instalar el módulo PTS Stripe en tu tienda PrestaShop, sigue estos pasos:

Descarga el archivo ZIP del módulo desde tu cuenta de PresTeamShop
En el backoffice de PrestaShop, ve a Módulos → Module Manager
Haz clic en el botón "Subir un módulo" en la esquina superior derecha
Arrastra el archivo ZIP o selecciónalo desde tu ordenador
Espera a que se complete la carga y la instalación automática
Una vez instalado, haz clic en "Configurar" para acceder al panel de administración del módulo

Nota: Asegúrate de que tu tienda esté usando HTTPS antes de configurar el módulo. Stripe requiere conexiones seguras para procesar pagos.

Configuración

El módulo PTS Stripe se configura desde su panel de administración, accesible a través de Módulos → Módulos instalados (en PrestaShop 1.7+). El panel está dividido en varias secciones temáticas que agrupan las opciones de configuración.

General

Esta sección agrupa las opciones generales del módulo relacionadas con debugging, comportamiento automático y registro de eventos.

Modo de depuración

Habilita el modo debug para depuración en entornos de desarrollo. Cuando se activa, el módulo registra información detallada de los flujos de pago en los logs de PrestaShop (Parámetros avanzados → Logs).

Tipo: Switch (activable/desactivable)
Valor por defecto: Desactivado

IP

Campo de texto para especificar la dirección IP desde la que está permitido acceder al módulo en modo debug. Esta opción solo es visible cuando el "Debug mode" está activado.

Tipo: Texto
Valor por defecto: Vacío

Nota: Incluye un botón que permite añadir automáticamente tu dirección IP actual.

Habilitar registros de depuración

Activa el registro detallado de todos los flujos de pago del módulo. Todos los eventos (creación de Payment Intent, confirmación de pagos, errores, etc.) se registran en la sección Parámetros avanzados → Logs del backoffice de PrestaShop.

Tipo: Switch (activable/desactivable)
Valor por defecto: Desactivado

Recomendación: Mantén desactivado en producción para evitar archivos de log muy grandes. Actívalo solo cuando necesites depurar problemas específicos.

Reembolso automático en nota de abono

Cuando activas esta opción, el módulo procesa automáticamente un reembolso en Stripe cada vez que se crea una nota de crédito (credit slip) en PrestaShop. El importe del reembolso será igual al importe de la nota de crédito.

Tipo: Switch (activable/desactivable)
Valor por defecto: Desactivado

Stripe

Configuración de las claves API de Stripe y webhook secret. Esta sección es fundamental para conectar tu tienda PrestaShop con tu cuenta de Stripe.

Modo sandbox (prueba)

Alterna entre las claves de API de test (sandbox) y de producción (live). Cuando está habilitado, todas las transacciones se procesan en modo test y Stripe no cobra cargos reales. Usa esta opción para probar completamente el módulo antes de pasar a producción.

Tipo: Switch (activable/desactivable)
Valor por defecto: Activado

Clave pública de prueba

Clave pública (publishable key) de Stripe para el entorno de test. Se utiliza en el frontend para inicializar Stripe.js y crear elementos de pago interactivos. Solo es visible cuando "Modo sandbox" está habilitado.

Tipo: Campo de contraseña
Valor por defecto: Vacío
Formato: Debe comenzar con pk_test_
Dónde obtenerla: Dashboard de Stripe → Developers → API keys

Clave secreta de prueba

Clave secreta (secret key) de Stripe para el entorno de test. Se utiliza en el backend para crear, confirmar y procesar pagos. Solo es visible cuando "Modo sandbox" está habilitado.

Tipo: Campo de contraseña
Valor por defecto: Vacío
Formato: Debe comenzar con sk_test_
Dónde obtenerla: Dashboard de Stripe → Developers → API keys

Importante: Nunca compartas esta clave. Almacénala de manera segura.

Clave pública en vivo

Clave pública (publishable key) de Stripe para producción. Solo es visible cuando "Modo sandbox" está desactivado.

Tipo: Campo de contraseña
Valor por defecto: Vacío
Formato: Debe comenzar con pk_live_
Dónde obtenerla: Dashboard de Stripe → Developers → API keys

Clave secreta en vivo

Clave secreta (secret key) de Stripe para producción. Solo es visible cuando "Modo sandbox" está desactivado.

Tipo: Campo de contraseña
Valor por defecto: Vacío
Formato: Debe comenzar con sk_live_
Dónde obtenerla: Dashboard de Stripe → Developers → API keys

Importante: Nunca compartas esta clave. Almacénala de manera segura.

Secreto de webhook

Valor secreto utilizado para validar la autenticidad de los eventos enviados por Stripe. Todos los webhooks recibidos se validan usando este secret. Si la firma HMAC no es válida, el webhook se rechaza.

Tipo: Campo de contraseña
Valor por defecto: Vacío
Formato: Comienza con whsec_
Dónde obtenerla: Dashboard de Stripe → Developers → Webhooks → Selecciona tu endpoint → Mostrar claves de firma

Nota especial: La sección muestra una caja de información con la URL completa del webhook que debes configurar en el dashboard de Stripe, junto con un botón para copiarla al portapapeles. Esta URL debe estar registrada en Stripe para que el módulo reciba notificaciones de pagos.

Pagos

Esta sección configura los métodos de pago disponibles en el checkout de tu tienda. Aquí decides qué opciones de pago ofrecerás a tus clientes.

Habilitar formulario de pago integrado

Cuando activas esta opción, todos los métodos de pago habilitados se muestran en un único formulario moderno (Payment Element) diseñado y gestionado por Stripe. Cuando está desactivado, cada método de pago se muestra como una opción individual de pago en el checkout de PrestaShop.

Tipo: Switch (activable/desactivable)
Valor por defecto: Desactivado

Diseño de formulario integrado

Define cómo se organizan visualmente los métodos de pago dentro del formulario integrado. Solo es visible cuando "Habilitar formulario de pago integrado" está activado.

Tipo: Selector desplegable
Valor por defecto: tabs
Opciones disponibles:

tabs: Los métodos de pago se muestran en pestañas horizontales
accordion_radio: Los métodos se muestran en un acordeón expandible con radio buttons para seleccionar
accordion: Los métodos se muestran en un acordeón expandible sin radio buttons

Tema de formulario integrado

Define la apariencia visual y el esquema de colores del formulario de pago integrado. Solo es visible cuando "Habilitar formulario de pago integrado" está activado.

Tipo: Selector desplegable
Valor por defecto: stripe
Opciones disponibles:

stripe: Tema predeterminado de Stripe (recomendado)
flat: Tema minimalista y limpio
night: Tema oscuro
none: Sin tema (el formulario hereda los estilos CSS de tu tienda)

Métodos de pago individuales

Los siguientes switches están disponibles solo cuando "Habilitar formulario de pago integrado" está desactivado. Cada switch habilita o deshabilita un método de pago específico en el checkout.

Restricciones por método (país de entrega y grupo de cliente): Al activar cualquier método se despliegan campos adicionales para restringir su visibilidad:

Países permitidos: países de entrega para los que el método estará disponible. Vacío = todos los países (sujeto a la disponibilidad del método en Stripe).
Grupos de cliente permitidos: grupos de cliente de PrestaShop que podrán ver el método. Vacío = todos los grupos.

Estas restricciones se aplican por método, de forma independiente de las restricciones geográficas inherentes a cada método (p.ej. iDEAL solo en Países Bajos). Una advertencia ⚠ indica que el método requiere una cuenta de Stripe registrada en un país concreto (p.ej. PIX/Boleto en Brasil, OXXO en México, Affirm en EE.UU./Canadá).

Tarjeta de crédito/débito

Habilita los pagos con tarjetas de crédito y débito internacionales (Visa, Mastercard, American Express, Discover, etc.). Incluye soporte automático para 3D Secure 2 (SCA) cuando es requerido.

Tipo: Switch (activable/desactivable)
Valor por defecto: Activado
Flujo: Formulario inline integrado en el checkout

Mostrar código postal

Muestra un campo adicional para solicitar el código postal del cliente al pagar con tarjeta. Esto puede aumentar la tasa de aprobación en algunos casos. Solo es visible cuando "Tarjeta de crédito/débito" está activado.

Tipo: Switch (activable/desactivable)
Valor por defecto: Desactivado

iDEAL

Método de pago de redirección muy popular en los Países Bajos. Permite a los clientes pagar mediante transferencia bancaria desde su banco.

Tipo: Switch (activable/desactivable)
Valor por defecto: Desactivado
Flujo: El cliente es redirigido a su banco para completar el pago
Disponibilidad: Principalmente en Países Bajos y Bélgica

Bancontact

Método de pago de redirección utilizado en Bélgica y Países Bajos. Los clientes completan el pago a través de sus bancos.

Tipo: Switch (activable/desactivable)
Valor por defecto: Desactivado
Flujo: Redirección al banco
Disponibilidad: Principalmente en Bélgica

Klarna

Servicio de "compra ahora, paga después" (BNPL) popular en Europa y Estados Unidos. Permite a tus clientes pagar su compra en cuotas a través de Klarna.

Tipo: Switch (activable/desactivable)
Valor por defecto: Desactivado
Flujo: Redirección a Klarna para completar la solicitud de crédito
Disponibilidad: Varios países europeos y seleccionados en EE.UU.

EPS

Método de pago de redirección utilizado en Austria para transferencias bancarias.

Tipo: Switch (activable/desactivable)
Valor por defecto: Desactivado
Flujo: Redirección
Disponibilidad: Austria

Przelewy24 (P24)

Método de pago de redirección muy popular en Polonia. Integra múltiples opciones de pago polacas (e-wallets, transferencias, etc.).

Tipo: Switch (activable/desactivable)
Valor por defecto: Desactivado
Flujo: Redirección
Disponibilidad: Principalmente en Polonia

BLIK

Método de pago móvil utilizado en Polonia. El cliente introduce un código de 6 dígitos generado en su aplicación bancaria para confirmar el pago.

Tipo: Switch (activable/desactivable)
Valor por defecto: Desactivado
Flujo: Código inline integrado en el checkout (no requiere redirección)
Disponibilidad: Polonia

TWINT

Método de pago móvil utilizado en Suiza. Los clientes pagan escaneando un código QR con su aplicación TWINT.

Tipo: Switch (activable/desactivable)
Valor por defecto: Desactivado
Flujo: Redirección
Disponibilidad: Suiza

Afterpay / Clearpay

Servicio de "compra ahora, paga después" (BNPL). Disponible como "Afterpay" en países europeos seleccionados y como "Clearpay" en Reino Unido.

Tipo: Switch (activable/desactivable)
Valor por defecto: Desactivado
Flujo: Redirección
Disponibilidad: Francia, España, Italia, Países Bajos, Bélgica, Alemania, Reino Unido

PayPal

Habilita los pagos mediante PayPal a través de la integración de Stripe. Los clientes pueden usar sus cuentas de PayPal existentes o completar el pago como invitado.

Tipo: Switch (activable/desactivable)
Valor por defecto: Desactivado
Flujo: Redirección a PayPal
Disponibilidad: Disponible en la mayoría de países

SEPA Direct Debit

Débito directo SEPA para la zona euro. Permite a los clientes pagar proporcionando su número de IBAN, que se cargará directamente desde su cuenta bancaria.

Tipo: Switch (activable/desactivable)
Valor por defecto: Desactivado
Flujo: Formulario inline integrado en el checkout
Disponibilidad: Zona euro

Pix

Método de pago instantáneo utilizado en Brasil. Genera un código QR dinámico que el cliente escanea con su aplicación bancaria para confirmar el pago.

Tipo: Switch (activable/desactivable)
Valor por defecto: Desactivado
Flujo: Voucher con código QR
Disponibilidad: Solo en Brasil

Restricción importante: Requiere una cuenta de Stripe registrada en Brasil

OXXO

Método de pago en efectivo utilizado en México. Genera un voucher que el cliente imprime o anota y paga en cualquier tienda OXXO.

Tipo: Switch (activable/desactivable)
Valor por defecto: Desactivado
Flujo: Voucher
Disponibilidad: Solo en México

Restricción importante: Requiere una cuenta de Stripe registrada en México

Boleto

Método de pago en efectivo utilizado en Brasil. Genera un boleto bancario que el cliente puede pagar en bancos, lotéricas o a través de banca online.

Tipo: Switch (activable/desactivable)
Valor por defecto: Desactivado
Flujo: Voucher PDF descargable
Disponibilidad: Solo en Brasil

Restricción importante: Requiere una cuenta de Stripe registrada en Brasil

Multibanco

Método de pago de referencia bancaria utilizado en Portugal. Genera una entidad y referencia que el cliente paga en cajeros automáticos, banca online o sucursales bancarias.

Tipo: Switch (activable/desactivable)
Valor por defecto: Desactivado
Flujo: Voucher con datos de referencia
Disponibilidad: Portugal

Affirm

Servicio de "compra ahora, paga después" (BNPL) utilizado en Estados Unidos y Canadá. Permite a los clientes pagar en cuotas sin interés.

Tipo: Switch (activable/desactivable)
Valor por defecto: Desactivado
Flujo: Redirección
Disponibilidad: Estados Unidos y Canadá

Restricción importante: Requiere una cuenta de Stripe registrada en Estados Unidos o Canadá

Express Checkout

El Express Checkout permite a tus clientes completar compras de forma rápida y segura utilizando billeteras digitales y servicios de pago populares. Los botones de Express Checkout aparecen directamente en las páginas de producto, carrito y checkout.

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

Define dónde se renderizarán los botones de Express Checkout en la página de producto.

Tipo: Selector desplegable
Valor por defecto: displayProductAdditionalInfo
Opciones disponibles:

displayProductAdditionalInfo: Después de la información adicional del producto
displayAfterProductAddCartBtn: Después del botón "Añadir al carrito"
displayProductActions: En el área de acciones del producto (junto al botón de añadir al carrito)
Selector CSS personalizado (avanzado): Coloca los botones junto a cualquier elemento de la página mediante un selector CSS, ignorando los hooks del tema

Nota: Las tres primeras opciones dependen de los hooks que tu tema soporte. Usa el "Selector CSS personalizado" cuando ninguna de ellas renderice en la posición que necesitas.

Selector CSS (avanzado)

Selector CSS que apunta al elemento junto al cual se inyectarán los botones de Express Checkout. Solo es visible cuando "Página de Producto — Posición del Botón" está en modo Selector CSS personalizado.

Tipo: Texto
Valor por defecto: Vacío
Ejemplo: #add-to-cart-or-refresh .add-to-cart

Pruébalo en las DevTools de la página de producto de tu tema (document.querySelector(...)) para confirmar que coincide con un único elemento.

Posición relativa al elemento

Define dónde colocar los botones respecto al elemento que coincide con el selector CSS. Solo es visible en modo Selector CSS personalizado.

Tipo: Selector desplegable
Valor por defecto: afterend
Opciones disponibles:

beforebegin: Antes del elemento
afterbegin: Dentro del elemento, al principio
beforeend: Dentro del elemento, al final
afterend: Después del elemento (por defecto)

Altura del botón (px)

Define la altura de los botones de Express Checkout en píxeles. Stripe limita este valor entre 40 y 55 píxeles.

Tipo: Selector desplegable
Valor por defecto: 48
Rango: 40 a 55 píxeles

Máximo de columnas

Define el número máximo de columnas para mostrar los botones de Express Checkout en la grilla.

Tipo: Selector desplegable
Valor por defecto: 0 (sin límite)
Opciones disponibles: 0 (ilimitado), 1, 2, 3, 4

Máximo de filas

Define el número máximo de filas para mostrar los botones de Express Checkout en la grilla.

Tipo: Selector desplegable
Valor por defecto: 0 (sin límite)
Opciones disponibles: 0 (ilimitado), 1, 2, 3, 4

Nota: Cuando hay más botones de los que cabe en la grilla definida, se muestra un menú desplegable adicional (ver opción "Menú desplegable").

Menú desplegable

Define el comportamiento cuando hay más botones de pago que espacio disponible según las opciones Máximo de columnas y Máximo de filas.

Tipo: Selector desplegable
Valor por defecto: auto
Opciones disponibles:

auto: Stripe decide automáticamente si mostrar un menú desplegable
never: Nunca muestra menú desplegable, solo oculta los botones que no caben

Ocultar transportistas

Permite excluir transportistas concretos del modal del wallet (Apple Pay / Google Pay). Los transportistas seleccionados aquí no aparecerán en el popup de Express Checkout.

Tipo: Selección múltiple de transportistas
Valor por defecto: Vacío (todos los transportistas visibles)

Caso de uso: Transportistas de punto de recogida (pickup point) que exigen al cliente elegir una ubicación física, paso que no es posible dentro de la interfaz nativa del wallet. Ocultándolos evitas que el cliente seleccione una opción que no podrá completar correctamente desde el wallet.

Apple Pay

Habilita el botón de Apple Pay para pagos rápidos. Solo está disponible en Safari y dispositivos Apple.

Tipo: Switch (activable/desactivable)
Valor por defecto: Activado

Mostrar como opción de pago

Además del botón de Express Checkout, muestra Apple Pay como una opción más dentro del listado de métodos de pago del checkout. Con el cliente ya identificado y su dirección elegida, puede pagar de un toque (1-tap) sin reintroducir datos. Solo aparece en dispositivos Apple / Safari. Solo es visible cuando "Apple Pay" está habilitado.

Tipo: Switch (activable/desactivable)
Valor por defecto: Desactivado

Mostrar en la Página de Producto

Muestra el botón de Apple Pay en la página de producto. Solo es visible cuando "Apple Pay" está habilitado.

Tipo: Switch (activable/desactivable)
Valor por defecto: Activado

Mostrar en la Página del Carrito

Muestra el botón de Apple Pay en la página del carrito. Solo es visible cuando "Apple Pay" está habilitado.

Tipo: Switch (activable/desactivable)
Valor por defecto: Activado

Mostrar en el Checkout

Muestra el botón de Apple Pay en la página de checkout. Solo es visible cuando "Apple Pay" está habilitado.

Tipo: Switch (activable/desactivable)
Valor por defecto: Activado

Texto del botón

Define el texto que se muestra en el botón de Apple Pay. Solo es visible cuando "Apple Pay" está habilitado.

Tipo: Selector desplegable
Valor por defecto: check-out
Opciones disponibles: plain, add-money, book, buy, check-out, contribute, donate, order, reload, rent, subscribe, support, tip, top-up

Tema del botón

Define el color del botón de Apple Pay. Solo es visible cuando "Apple Pay" está habilitado.

Tipo: Selector desplegable
Valor por defecto: black
Opciones disponibles: black, white, white-outline

Google Pay

Habilita el botón de Google Pay para pagos rápidos en navegadores Chrome y otros compatible.

Tipo: Switch (activable/desactivable)
Valor por defecto: Activado

Mostrar como opción de pago

Además del botón de Express Checkout, muestra Google Pay como una opción más dentro del listado de métodos de pago del checkout. Con el cliente ya identificado y su dirección elegida, puede pagar de un toque (1-tap) sin reintroducir datos. Solo aparece en Chrome y navegadores compatibles. Solo es visible cuando "Google Pay" está habilitado.

Tipo: Switch (activable/desactivable)
Valor por defecto: Desactivado

Mostrar en la Página de Producto

Muestra el botón de Google Pay en la página de producto. Solo es visible cuando "Google Pay" está habilitado.

Tipo: Switch (activable/desactivable)
Valor por defecto: Activado

Mostrar en la Página del Carrito

Muestra el botón de Google Pay en la página del carrito. Solo es visible cuando "Google Pay" está habilitado.

Tipo: Switch (activable/desactivable)
Valor por defecto: Activado

Mostrar en el Checkout

Muestra el botón de Google Pay en la página de checkout. Solo es visible cuando "Google Pay" está habilitado.

Tipo: Switch (activable/desactivable)
Valor por defecto: Activado

Texto del botón

Define el texto que se muestra en el botón de Google Pay. Solo es visible cuando "Google Pay" está habilitado.

Tipo: Selector desplegable
Valor por defecto: plain
Opciones disponibles: plain, book, buy, checkout, donate, order, pay, subscribe

Tema del botón

Define el color del botón de Google Pay. Solo es visible cuando "Google Pay" está habilitado.

Tipo: Selector desplegable
Valor por defecto: black
Opciones disponibles: black, white

Link by Stripe

Link permite a los clientes pagar rápidamente usando información de pago guardada en Stripe Link. Útil para clientes que ya tienen información guardada en Stripe.

Tipo: Switch (activable/desactivable)
Valor por defecto: Activado

Mostrar en la Página de Producto

Muestra el botón de Link en la página de producto. Solo es visible cuando "Link by Stripe" está habilitado.

Tipo: Switch (activable/desactivable)
Valor por defecto: Activado

Mostrar en la Página del Carrito

Muestra el botón de Link en la página del carrito. Solo es visible cuando "Link by Stripe" está habilitado.

Tipo: Switch (activable/desactivable)
Valor por defecto: Activado

Mostrar en el Checkout

Muestra el botón de Link en la página de checkout. Solo es visible cuando "Link by Stripe" está habilitado.

Tipo: Switch (activable/desactivable)
Valor por defecto: Activado

PayPal

Habilita el botón de PayPal para pagos rápidos mediante Express Checkout. Los clientes pueden usar sus cuentas de PayPal guardadas en el navegador.

Tipo: Switch (activable/desactivable)
Valor por defecto: Desactivado

Mostrar en la Página de Producto

Muestra el botón de PayPal en la página de producto. Solo es visible cuando "PayPal" está habilitado.

Tipo: Switch (activable/desactivable)
Valor por defecto: Activado

Mostrar en la Página del Carrito

Muestra el botón de PayPal en la página del carrito. Solo es visible cuando "PayPal" está habilitado.

Tipo: Switch (activable/desactivable)
Valor por defecto: Activado

Mostrar en el Checkout

Muestra el botón de PayPal en la página de checkout. Solo es visible cuando "PayPal" está habilitado.

Tipo: Switch (activable/desactivable)
Valor por defecto: Activado

Texto del botón

Define el texto que se muestra en el botón de PayPal. Solo es visible cuando "PayPal" está habilitado.

Tipo: Selector desplegable
Valor por defecto: checkout
Opciones disponibles: paypal, checkout, buynow, pay

Tema del botón

Define el color del botón de PayPal. Solo es visible cuando "PayPal" está habilitado.

Tipo: Selector desplegable
Valor por defecto: gold
Opciones disponibles: gold, blue, silver, white, black

Amazon Pay

Habilita el botón de Amazon Pay para pagos rápidos usando cuentas de Amazon existentes.

Tipo: Switch (activable/desactivable)
Valor por defecto: Desactivado

Mostrar en la Página de Producto

Muestra el botón de Amazon Pay en la página de producto. Solo es visible cuando "Amazon Pay" está habilitado.

Tipo: Switch (activable/desactivable)
Valor por defecto: Activado

Mostrar en la Página del Carrito

Muestra el botón de Amazon Pay en la página del carrito. Solo es visible cuando "Amazon Pay" está habilitado.

Tipo: Switch (activable/desactivable)
Valor por defecto: Activado

Mostrar en el Checkout

Muestra el botón de Amazon Pay en la página de checkout. Solo es visible cuando "Amazon Pay" está habilitado.

Tipo: Switch (activable/desactivable)
Valor por defecto: Activado

Klarna

Habilita el botón de Klarna para pagos rápidos usando "compra ahora, paga después".

Tipo: Switch (activable/desactivable)
Valor por defecto: Desactivado

Mostrar en la Página de Producto

Muestra el botón de Klarna en la página de producto. Solo es visible cuando "Klarna" está habilitado.

Tipo: Switch (activable/desactivable)
Valor por defecto: Activado

Mostrar en la Página del Carrito

Muestra el botón de Klarna en la página del carrito. Solo es visible cuando "Klarna" está habilitado.

Tipo: Switch (activable/desactivable)
Valor por defecto: Activado

Mostrar en el Checkout

Muestra el botón de Klarna en la página de checkout. Solo es visible cuando "Klarna" está habilitado.

Tipo: Switch (activable/desactivable)
Valor por defecto: Activado

Texto del botón

Define el texto que se muestra en el botón de Klarna. Solo es visible cuando "Klarna" está habilitado.

Tipo: Selector desplegable
Valor por defecto: pay
Opciones disponibles: pay, continue

Tema del botón

Define el color del botón de Klarna. Solo es visible cuando "Klarna" está habilitado.

Tipo: Selector desplegable
Valor por defecto: dark
Opciones disponibles: dark, light, outlined

Traducciones

La sección Translation permite gestionar las traducciones del módulo para los diferentes idiomas instalados en tu tienda PrestaShop.

Funcionalidad: Esta sección es proporcionada por el framework pts_modulobase y ofrece:

Listado de archivos de traducción disponibles para cada idioma
Editor inline con soporte para múltiples idiomas sin recargar la página
Exportar traducciones a archivo
Importar traducciones desde archivo
Compartir traducciones con el equipo de PresTeamShop para mejora continua

Nota: No requiere configuración adicional inicial.

Editores de código

La sección Code Editors permite editar archivos CSS y JavaScript personalizados del módulo sin modificar el código fuente.

Funcionalidad: Esta sección es proporcionada por el framework pts_modulobase y ofrece:

Detección automática de archivos override en los directorios views/css/ y views/js/
Editor de código con resaltado de sintaxis para mejor legibilidad
Guardado automático de cambios
Los cambios se almacenan en la configuración de PrestaShop y se aplican inmediatamente en el frontend

Casos de uso: Personalizar estilos CSS del módulo, añadir funcionalidades JavaScript personalizadas, o modificar comportamientos sin alterar los archivos originales del módulo.

Copias de seguridad

La sección Backups permite crear, restaurar y gestionar copias de seguridad de todas las configuraciones del módulo de forma automática.

Funcionalidad: Esta sección es proporcionada por el framework pts_modulobase y ofrece:

Generar nuevo backup: Crea una instantánea de todas las configuraciones PTSS_* en ese momento
Restaurar backup: Sobrescribe las configuraciones actuales con las de un backup anterior
Descargar backup: Descarga un archivo ZIP con los datos del backup
Subir backup: Importa un backup desde un archivo ZIP previamente descargado
Eliminar backup: Borra backups que ya no necesites
Historial: Visualiza el historial de todos los backups realizados con fecha y hora

Nota: Los backups se almacenan en la base de datos de PrestaShop en la tabla ptss_backup. Cada backup incluye metadata sobre cuándo se creó y cómo fue generado (automático, manual, importado, etc.).

Funcionalidades adicionales del backoffice

Panel Stripe en página de pedido

El módulo añade una pestaña llamada "Stripe" en la página de detalle de cada pedido en el backoffice de PrestaShop (Pedidos → Pedidos → [Seleccionar pedido]). Esta pestaña muestra información completa del pago:

Detalles del pago

Charge ID: Identificador único de la transacción en Stripe, mostrado como enlace directo al dashboard de Stripe para verificación rápida
Método de pago utilizado: Nombre legible del método (p.ej., "Tarjeta", "PayPal", "iDEAL", etc.)
Importe total: Monto total del pago procesado
Importe reembolsado: Dinero ya devuelto al cliente mediante reembolsos
Importe pendiente de reembolso: Dinero que aún puede ser reembolsado
Modo: Indicador claro de si el pago fue procesado en modo Test o Live

Formulario de reembolso

Cuando hay importe pendiente de reembolso disponible, se muestra un formulario para procesar reembolsos:

Campo numérico para introducir el monto a reembolsar
Botón "Process Refund" para ejecutar el reembolso
Validación en tiempo real del monto introducido
Confirmación antes de procesar el reembolso

Detalles de voucher

Para métodos de pago con voucher (Multibanco, OXXO, Boleto, Pix), la pestaña muestra:

Entidad/Referencia (Multibanco): Datos necesarios para efectuar el pago
Número de voucher (OXXO): Código a presentar en tiendas OXXO
PDF descargable (Boleto): Documento oficial para pagar en bancos
URL del voucher: Enlace al documento original en Stripe
Fecha de expiración: Cuándo caduca el voucher

Estados de pedido personalizados

El módulo crea tres estados de pedido adicionales durante la instalación para mejor gestión del flujo de pagos:

Esperando el pago de Stripe

Nombre en el backoffice: «Waiting for Stripe payment» (los estados se muestran en inglés en todos los idiomas)
Color: Azul
Cuándo se asigna: Automáticamente a pedidos con métodos de pago que requieren acción posterior del cliente (vouchers como Multibanco, OXXO, Boleto, Pix)
Significado: El pedido está creado pero esperando que el cliente complete el pago fuera de PrestaShop

Reembolso parcial de Stripe

Nombre en el backoffice: «Stripe partial refund»
Color: Rojo
Cuándo se asigna: Automáticamente cuando se procesa un reembolso parcial en la pestaña Stripe
Significado: Se ha devuelto parte del dinero al cliente, pero aún hay importe sin reembolsar

Pago disputado de Stripe

Nombre en el backoffice: «Stripe disputed payment»
Color: Rojo oscuro
Cuándo se asigna: Automáticamente cuando Stripe notifica una disputa o chargeback mediante webhook
Significado: El cliente ha impugnado el cargo en su banco y está en proceso de investigación

Webhooks

El módulo escucha automáticamente los siguientes eventos de webhook de Stripe para mantener sincronizado el estado de los pagos entre Stripe y PrestaShop:

charge.succeeded: Confirma que el cargo se ha completado exitosamente y marca el pago/pedido como pagado
charge.failed: Marca el pago como fallido y actualiza el estado del pedido a error
charge.expired: Marca el pago como cancelado cuando el cargo caduca
charge.dispute.created: Marca el pedido como disputado cuando el cliente inicia una impugnación en su banco
payment_intent.succeeded: Confirma el pago en métodos de pago diferido (Multibanco, OXXO, Boleto, Pix) cuando el cliente completa el voucher
payment_intent.payment_failed: Marca el pago como fallido en métodos de pago diferido cuando el voucher caduca o el pago falla definitivamente

El módulo solo procesa eventos que lleven la marca pts_stripe en sus metadatos; los eventos de otras integraciones se ignoran de forma segura.

URL del webhook: Se muestra en la sección "Stripe" con un botón para copiarla al portapapeles. Debes registrar esta URL en tu dashboard de Stripe en Developers → Webhooks.

Validación de seguridad: Todos los webhooks recibidos se validan mediante firma HMAC utilizando el "Secreto de webhook" que configuraste. Si la firma no coincide, el webhook se rechaza automáticamente.

Flujos de pago

Flujo de pago estándar (tarjeta, Apple Pay, Google Pay, Link)

El cliente selecciona el método de pago en el checkout
Se genera un Payment Intent en Stripe (puede ser pre-generado en background)
El cliente completa el pago directamente en el formulario (no hay redirección)
Stripe procesa el pago y notifica al módulo
El módulo valida la notificación y crea automáticamente el pedido en PrestaShop

Flujo de redirección (iDEAL, PayPal, Klarna, etc.)

El cliente selecciona un método que requiere redirección
El módulo crea un Payment Intent con return_url configurada
El cliente es redirigido al proveedor (banco, PayPal, etc.)
El cliente completa el pago en el sitio del proveedor
El proveedor redirige de vuelta a PrestaShop con el resultado del pago
El módulo valida el resultado y crea el pedido

Flujo de voucher (OXXO, Boleto, Multibanco, Pix)

El cliente selecciona un método de voucher
El módulo genera el Payment Intent y obtiene los datos del voucher
Se muestra la información al cliente (código, URL para descargar, etc.)
El cliente completa el pago fuera de PrestaShop usando el voucher
Stripe notifica al módulo cuando se recibe el pago (mediante webhook)
El módulo actualiza el estado del pedido a completado

Seguridad

PTS Stripe implementa varias capas de seguridad:

HTTPS requerido: Todas las conexiones con Stripe se hacen sobre HTTPS
PCI DSS compliance: Stripe maneja todo el procesamiento de datos de tarjetas
Validación HMAC: Todos los webhooks se validan usando la firma secreta
SCA/3D Secure 2: Autenticación fuerte del cliente gestionada automáticamente por Stripe
Logs detallados: Todos los eventos se registran para auditoría y debugging
Modo sandbox: Prueba completa sin procesar dinero real

Importante: Asegúrate de que tu servidor tiene instalado un certificado SSL válido y que tu tienda está accesible únicamente a través de HTTPS antes de activar el módulo en producción.

Monedas sin decimales

Stripe requiere un manejo especial para ciertas monedas que no tienen decimales. El módulo maneja automáticamente estas monedas:

BIF, CLP, DJF, GNF, JPY, KMF, KRW, MGA, PYG, RWF, UGX, VND, VUV, XAF, XOF, XPF

Nota: No es necesario hacer nada especial en la configuración; el módulo detecta automáticamente la moneda de PrestaShop y ajusta los cálculos de moneda según corresponda.

Problemas comunes

"Connection error" o "No se puede conectar a Stripe"

Verifica que tus claves de API sean correctas y estén en la sección apropiada (test o live)
Asegúrate de estar usando HTTPS (requerido por Stripe)
Verifica que el servidor pueda hacer conexiones salientes a api.stripe.com

Los pagos se crean pero los pedidos no se generan

Verifica que los logs detallados estén activados: General → Enable detailed logs
Revisa los logs de PrestaShop: Parámetros avanzados → Logs
Asegúrate de que el Secreto de webhook está configurado correctamente
Verifica que la URL del webhook está registrada en Stripe

Los botones de Express Checkout no aparecen

Verifica que al menos un método de Express Checkout esté habilitado (Apple Pay, Google Pay, etc.)
Comprueba que estás usando el navegador correcto (Apple Pay requiere Safari, Google Pay requiere Chrome)
En modo test, solo aparecen en navegadores/dispositivos compatibles

Reembolsos no se procesan

Verifica que la opción "Auto-refund on credit slip" esté configurada correctamente
Asegúrate de que la transacción en Stripe puede ser reembolsada (no todos los métodos soportan reembolsos completos)
Revisa que haya importe pendiente de reembolso disponible

Contacto y soporte

Para obtener ayuda adicional:

Centro de ayuda: https://helpcenter.presteamshop.com/portal/en/kb/pts-stripe
Reportar problemas: Usa el formulario de soporte en tu página de módulo PresTeamShop
Documentación técnica: Consulta el archivo CLAUDE.md incluido en el módulo para detalles arquitectónicos

Nota: Para soporte técnico especializado, incluye siempre información sobre tu versión de PrestaShop, PHP, y los logs relevantes del módulo.