Cómo configurar Stripe Checkout para tiendas online en España

Qué medios de pago se pueden gestionar con Stripe

Stripe Checkout permite tarjetas y métodos adicionales con una única integración hospedada. Desde el Dashboard de Stripe el negocio configura qué formas de pago tiene activadas, como Bizum en España, wallets Apple Pay y Google Pay y opciones de pago aplazado mediante Klarna.

Tiendli no procesa directamente las credenciales de tarjetas. Envía al comprador a una sesión alojada en Stripe y valida el webhook antes de confirmar el pedido. La lista efectiva de métodos la decide Stripe para cada operación, no un interruptor independiente de Tiendli.

Antes de empezar: requisitos y moneda EUR

Crea o accede a una cuenta Stripe autorizada para operar como negocio español. Verifica los datos de la empresa, la cuenta bancaria y el estado de cobros en el panel Stripe. La disponibilidad de determinadas modalidades depende del proceso de alta y de las restricciones del proveedor.

La tienda debe figurar con país España y usar EUR como moneda efectiva del pedido. Para Estados Unidos, la integración anterior de Tiendli continúa utilizando USD; no mezcles credenciales de distintos negocios o entornos.

• Cuenta Stripe propia y verificada cuando corresponda.
• Tienda configurada con país ES y moneda de pedido EUR.
• Clave publicable pk_test_/pk_live_ y clave secreta sk_test_/sk_live_ del mismo entorno.
• Secreto de firma del webhook whsec_ creado en Stripe.
• Permisos para habilitar los métodos de pago disponibles para tu cuenta.

Crear las claves API y el webhook de la tienda

Desde el Dashboard de Stripe abre las claves API para copiar la clave publicable y la clave secreta del entorno de prueba o producción. El secreto nunca debe enviarse a soporte o incluirse en capturas.

En Desarrolladores → Webhooks registra la URL que muestra el panel Stripe de Tiendli. Selecciona los eventos checkout.session.completed, checkout.session.async_payment_succeeded y checkout.session.async_payment_failed. Copia el secreto de firma whsec_ de ese destino. Revisa especialmente los pagos que se confirman de forma diferida.

• Usa la URL exacta /api/webhooks/stripe mostrada por Tiendli.
• Habilita los eventos de sesión completada y resultado de pago asíncrono (éxito o fallo).
• Guarda el secreto de firma del destino, diferente de la clave secreta API.
• No cambies al modo Live sin configurar el webhook de producción.

Guardar Stripe y ejecutar Probar conexión en Tiendli

Inicia sesión como propietario de la tienda y ve a Negocio → Pagos → Stripe Checkout. Pega la clave publicable, clave secreta y secreto webhook, selecciona el entorno, activa Stripe y guarda.

Pulsa Probar conexión para que Tiendli consulte el estado de tu cuenta Stripe y compruebe país y autorización de cobros. Esta prueba no acredita que Bizum o Klarna estén activos ni que una transacción haya completado su retorno y webhook. Una compra real controlada sigue siendo necesaria.

Habilitar Bizum, Apple Pay, Google Pay o Klarna en Stripe

En el Dashboard de Stripe ve a Configuración → Pagos → Métodos de pago. Activa los métodos que tu cuenta tenga disponibles y completa los datos adicionales que Stripe solicite. Stripe Checkout utiliza selección dinámica: no hace falta introducir cada método en Tiendli de forma separada.

Un método puede no aparecer en una compra por motivos legítimos: moneda, país del comprador, importe mínimo/máximo, navegador, disponibilidad de wallet, aprobación de Klarna, o reglas de tu configuración de Stripe. En Tiendli el comprador selecciona Stripe como pasarela y después elige entre las opciones que Stripe ofrece.

• Bizum: requiere elegibilidad para compradores españoles y pagos en euros.
• Apple Pay: disponible en dispositivos y navegadores compatibles.
• Google Pay: depende de la compatibilidad del comprador y los medios guardados.
• Klarna: requiere activación y aprobación; sus opciones pueden depender del importe y país.
• No garantices al cliente que todas aparecerán en todas las operaciones.

Comprobar el cobro, el webhook y los errores habituales

Realiza una compra de prueba en el entorno de Stripe que corresponda. Comprueba que el importe se envía en EUR, que la operación figura en Stripe y que Tiendli recibió el webhook firmado antes de marcar el pedido como pagado.

Si la sesión se crea pero el comprador vuelve con pedido pendiente, revisa los eventos del webhook y el estado del pago en Stripe. Si el método que quieres no aparece en Stripe Checkout, revisa su activación y elegibilidad en Stripe, no solo el interruptor general de Stripe en Tiendli.

Si se produce una devolución, disputa o cancelación, utiliza las herramientas del proveedor y revisa la situación del pedido: el hecho de tener una pasarela conectada no implica que todas las operaciones de postventa estén automatizadas en Tiendli.