Con Stripe, tu tienda cobra con tarjeta y con los demás métodos que actives en tu cuenta de Stripe (Bizum, Apple Pay, Google Pay, Klarna, adeudo SEPA…). Necesitas una cuenta de Stripe. Tienes que hacer tres cosas: pegar las claves, dar de alta el webhook y registrar el dominio.
1. Las claves
- En el panel, abre Métodos de pago y en Selecciona el método elige Stripe.
- En Stripe, abre Claves de API (en inglés, API keys). Stripe tiene dos modos con claves distintas: el de pruebas (entorno de prueba, sandbox), con claves que empiezan por
pk_test_ysk_test_, y el activo (live), conpk_live_ysk_live_. Cambias de uno a otro en esa misma página. - Copia la clave publicable (
pk_…, no es secreta) y pégala en Clave de cliente: la de pruebas en «Clave de cliente (pruebas)» y la real en «Clave de cliente». - Copia la clave secreta (
sk_…) y pégala en Clave secreta, igual: pruebas con pruebas y real con real. En modo activo, Stripe solo te enseña la clave secreta una vez, al crearla (Crea una clave secreta): cópiala en ese momento. Si te vale una clave restringida, también se admite (rk_…). - Deja Entorno en Desarrollo, guarda y haz una compra de prueba con la tarjeta
4242 4242 4242 4242, cualquier fecha futura y cualquier CVC. - Cuando funcione, pega también las claves reales, cambia Entorno a Producción y guarda.
El panel no vuelve a mostrar las claves secretas una vez guardadas: el campo sale vacío, con un aviso de que hay una guardada. Para no cambiarla, déjalo vacío.
Dónde paga el cliente
En el apartado de Stripe, Dónde paga el cliente tiene dos opciones:
- En la página de la pasarela (recomendado), la que viene puesta: el cliente pulsa el botón Pagar con el importe (por ejemplo, «Pagar 25,00 €»), paga en la página segura de Stripe y vuelve a tu tienda. Allí ve los productos, las fotos y las cantidades de su pedido, y Stripe se encarga de la seguridad de la tarjeta (3-D Secure) y de los métodos de pago. Los descuentos, el cupón y lo que pague con su saldo salen juntos como un descuento: en tu cuenta de Stripe verás un cupón de un solo uso por cada pedido con descuento.
- Formulario de tarjeta en la página de tu tienda: el cliente paga sin salir de tu tienda, con el formulario de Stripe dentro de la pantalla de pago.
En los dos casos se cobra lo mismo y el pedido se cierra igual. Puedes cambiarlo cuando quieras; guarda y haz otra compra de prueba.
2. El webhook
Sin webhook, un pedido solo se cierra si el comprador vuelve a tu tienda después de pagar. Con él, Stripe avisa a tu tienda de cada pago, reembolso o disputa. El apartado de Stripe en el panel te enseña la dirección de tu tienda (termina con el número de tu sitio): es la que tienes que pegar en Stripe, y es distinta para cada tienda.
- En Stripe, abre Webhooks (es una pestaña de Workbench) y pulsa Crear un destino de evento (Create an event destination).
- Elige Tu cuenta.
- En el formato de la carga útil, elige Resumen (en inglés, Snapshot), no «Ligero», que es el que Stripe marca como recomendado: tu tienda lee el evento completo. Con «Resumen», Stripe pide también la versión de la API: vale la que te muestre por defecto.
- Marca estos eventos:
payment_intent.succeeded,charge.refunded,charge.dispute.createdycharge.dispute.closed. - Pulsa Continuar, elige Punto de conexión de webhook como tipo de destino, pulsa Continuar y pega la dirección que te enseña el panel en URL de punto de conexión. Guarda.
- En la página del webhook, pulsa Revelar secreto y copia el secreto de firma (empieza por
whsec_). - Pégalo en el panel: en Secreto de firma del webhook (prueba) si lo creaste en modo de pruebas, o en Secreto de firma del webhook si lo creaste en modo activo. Cada modo tiene su propio webhook y su propio secreto: repite estos pasos en el otro modo cuando pases a cobrar de verdad.
Con el secreto puesto, tu tienda comprueba que cada aviso viene de Stripe; sin él, avisa en el panel de que más adelante dejará de aceptarlos.
3. El dominio, para Apple Pay y Google Pay
Este paso solo hace falta si eliges el formulario de tarjeta en la página de tu tienda: en la página de Stripe, Apple Pay y Google Pay salen sin registrar nada. Apple Pay y Google Pay solo salen en los dominios que registras en Stripe. Sin el registro no aparecen, y nada avisa de por qué. Stripe pide registrar cada dominio y subdominio donde se paga.
- Piensa qué dirección ve tu comprador al pagar: tutienda.edeck.me (la parte de «tutienda» es el nombre de tu sitio) o, si la tienes, tu dominio propio. Si tu tienda se ve en más de una dirección (con y sin www), registra cada una.
- En Stripe, abre Configuración › Dominios de métodos de pago (Payment method domains).
- Pulsa Añadir un nuevo dominio, escribe la dirección sin https:// (por ejemplo, tutienda.edeck.me) y pulsa Guardar y continuar.
- La dirección sale en la lista de dominios. Para quitarla, Deshabilitar en el menú de su fila.
Stripe gestiona por ti la validación de Apple: no necesitas crear nada en Apple. Si registras el dominio en modo activo, queda también registrado en el entorno de pruebas; el registro hay que hacerlo en modo activo antes de cobrar de verdad.
Bizum, Apple Pay, Google Pay, Klarna y SEPA
La pantalla de pago de tu tienda ofrece los métodos que tengas activados en Stripe, no solo la tarjeta. Actívalos en Configuración › Métodos de pago de Stripe: son listas distintas en modo de pruebas y en modo activo. Cada comprador ve solo los que puede usar: Bizum sale en pagos en euros (y, si quieres, como opción propia «Bizum»: elige Stripe en Cobrar Bizum con, en el bloque Bizum); Apple Pay, en Safari con una tarjeta guardada; Google Pay, en Chrome. Con Klarna el comprador paga más tarde o a plazos y tú cobras el importe entero desde Stripe; se ofrece solo así, dentro de Stripe. El adeudo SEPA tarda unos días en cobrarse: el pedido se cierra cuando Stripe lo cobra, y para eso necesitas el webhook del paso 2.
Cuando algo no sale como esperas, en la pestaña Entregas de eventos del webhook en Stripe ves qué avisos llegaron a tu tienda y con qué resultado.
¿No lo encuentras? Escríbenos a soporte@edeck.me y dinos qué pantalla y qué sitio. Respondemos en un día laborable.
¿Aún no tienes tu web? Te la proponemos en edeck.me: 30 días gratis con tarjeta, desde 4,99 €/mes.