Conectar Stripe a tu tienda en línea

Configura Stripe en Storefront, conecta sus eventos y comprueba los pagos antes de activar producción.

Conecta tu cuenta de Stripe para que tus clientes paguen con tarjeta desde el checkout de tu Storefront.

Antes de comenzar

Necesitas acceso a la configuración de tu Storefront y al panel de Stripe del comercio que recibirá los pagos. Tu cuenta de Stripe debe estar habilitada para operar en su país y con la moneda de la tienda. Wahio admite esta conexión en COP, USD, EUR, MXN, GBP, CAD y AUD.

Prepara una tienda publicada, productos disponibles y una forma de entrega. Si ofreces recogida, completa la Dirección de recogida. También necesitas una cuenta de tipo banco en Cajas y bancos para registrar el recaudo.

Estas instrucciones corresponden a Storefront. Las conexiones del e-commerce clásico se administran por separado.

1. Abrir la conexión en Wahio

Entra en Configuración → Tienda online → Storefront y abre tu tienda.
Selecciona Pagos y entregas.
En Medios de pago, pulsa Conectar junto a Stripe.
Selecciona Pruebas en Ambiente para comenzar.
Copia la URL de eventos que muestra el formulario. Déjalo abierto mientras configuras Stripe.

La URL termina en /api/payments/stripe/events. Copia la dirección completa de tu formulario; no uses la URL de otra tienda ni la página a la que vuelve el comprador.

2. Obtener la llave y configurar los eventos en Stripe

En el panel de Stripe, selecciona la cuenta del comercio y su entorno de pruebas.

Abre Desarrolladores → Claves de API y copia la llave secreta de pruebas, que comienza por sk_test_.
En Desarrolladores → Webhooks, dentro de Workbench, selecciona Añade un destino.
Elige eventos de Tu cuenta y el estilo de carga Resumen o snapshot.
Selecciona estos cuatro eventos:
- checkout.session.completed
- checkout.session.expired
- checkout.session.async_payment_succeeded
- checkout.session.async_payment_failed
Elige Punto de conexión de webhook y pega la URL de eventos copiada de Wahio.
Crea el destino, abre sus detalles y copia el Secreto de firma, que comienza por whsec_.

Un webhook es el aviso que Stripe envía a Wahio para informar el resultado del pago. Su secreto de firma es distinto de la llave API. Consulta la documentación de Stripe sobre claves y webhooks si los nombres del panel cambian.

3. Guardar y ofrecer Stripe a tus clientes

Vuelve al formulario de Wahio y completa:

Campo en Wahio	Dato de Stripe
Ambiente	Pruebas
Llave secreta	Llave `sk_test_` del comercio
Secreto de eventos	Secreto `whsec_` del destino creado

Pulsa Guardar dentro de la conexión. Debe aparecer Configurado · Pruebas.
Marca Ofrecer Stripe.
Selecciona la Cuenta de recaudo de Stripe.
Pulsa Guardar en el encabezado de Pagos y entregas.

La cuenta de recaudo registra el pago dentro de Wahio; no cambia la cuenta bancaria de abono que tengas en Stripe. Cada pasarela tiene su propia cuenta de recaudo. Puedes elegir cuentas diferentes para Stripe y Wompi o usar la misma en ambas. Cada pedido conserva la cuenta que tenía Stripe al confirmarlo; cambiarla después solo afecta a pedidos nuevos.

Guardar las credenciales y habilitar el medio son dos pasos distintos. Los ajustes de pagos y entregas se aplican al guardar, sin volver a publicar el diseño. Configurado indica que guardaste la conexión; necesitas completar una compra para comprobarla.

4. Comprobar el pago en pruebas

Abre la tienda pública, agrega un producto al carrito y completa tus datos de prueba.
Elige Tarjeta de crédito o débito (procesado por Stripe) y confirma el pedido.
En la página del pedido, pulsa Pagar con Stripe.
En el checkout de pruebas de Stripe, utiliza los datos de su guía oficial de pruebas:

Resultado	Número de tarjeta de prueba
Aprobado	`4242 4242 4242 4242`
Rechazado	`4000 0000 0000 0002`

Usa una fecha futura y un CVC de tres dígitos. Estas tarjetas se utilizan únicamente en pruebas, sin dinero real.

Después de aprobar, abre Pedidos en Wahio: debe figurar Pagado y el perfil debe mostrar el pago recibido y saldo pendiente de cero. En Stripe, revisa que la entrega de checkout.session.completed tenga respuesta 200. Si la tarjeta es rechazada, el pedido debe conservar el pago pendiente.

El pedido se crea antes de abrir Stripe. El webhook confirma el pago aunque el comprador cierre la pestaña o no vuelva a la tienda. Pagado no significa que el pedido esté aceptado: eso depende de Aceptar automáticamente o de la aceptación manual del comercio.

Pasar a producción

Cuando termines las pruebas, abre la conexión de Stripe con el botón de edición. Selecciona Producción, usa la llave sk_live_ y registra el destino de eventos en el modo real de Stripe con la URL mostrada por Wahio. Copia el secreto whsec_ de ese destino, guarda la conexión y revisa Ofrecer Stripe y la cuenta de recaudo.

Las claves y los destinos de prueba y producción son independientes. Si Wahio impide reemplazar las credenciales porque hay pagos pendientes, resuelve primero esos intentos con soporte.

Resolver problemas

Situación	Qué revisar
La opción de tarjeta no aparece al comprar	Guarda Ofrecer Stripe, comprueba Recibir pedidos y vuelve a abrir el checkout.
No se puede guardar Pagos y entregas	Completa la dirección si ofreces recogida y selecciona una cuenta de recaudo.
Stripe aprobó, pero Wahio sigue pendiente	Revisa el ambiente, la URL del destino y su secreto de firma. Consulta la entrega del evento en Stripe y actualiza el pedido.
El pedido indica un pago por conciliar	Conserva la referencia de Stripe y el número del pedido y contacta con soporte.

No registres otro pago manual para compensar una confirmación pendiente. Los reembolsos de Stripe no se tramitan automáticamente desde esta conexión: si necesitas devolver un pago, revisa el caso con soporte para conciliarlo. Mantén tus claves y secretos privados; no los envíes en capturas ni mensajes.

Consulta también conectar Wompi y configurar medios de pago.