- Credenciales de API
- Clave API
- Clave publicable
- Secreto del webhook
Stripe Elements coloca los campos de tarjeta de Stripe en tu página de reserva, así que los viajeros pagan con tarjeta sin salir de ella. Necesitas una cuenta de Stripe que acepte pagos reales: la guía de Stripe explica cómo abrirla.
Copia tus claves de Stripe
- 1
Abre tus claves API en modo live
Abre dashboard.stripe.com/apikeys y comprueba que estás en modo live, no en un sandbox. Una clave de prueba no falla: marca las reservas como pagadas con dinero que no existe.
- 2
Copia la clave publicable
En Standard keys, copia la Publishable key. Empieza por pk_live_.
- 3
Copia la clave secreta
Copia la Secret key (haz clic en Reveal live key si está oculta). Empieza por sk_live_. No la compartas: con ella se pueden cobrar tarjetas en tu nombre.
Añade el webhook en Stripe
Sin él, a los viajeros se les cobra y sus reservas quedan sin confirmar.
Tu dirección de webhook de TourTask para Stripe Elements
https://api.tourtask.com/v1/payments/stripe-elements/notifications/booking- 1
Crea un destino de eventos
Abre dashboard.stripe.com/webhooks, todavía en modo live, y haz clic en Create an event destination.
- 2
Elige tu cuenta y Snapshot
Selecciona Your account y el formato de carga Snapshot: TourTask no puede leer los eventos Thin que recomienda Stripe.
- 3
Selecciona el evento
Selecciona payment_intent.succeeded y ningún otro evento.
- 4
Elige un endpoint de webhook
Haz clic en Continue y selecciona Webhook endpoint como tipo de destino.
- 5
Introduce la dirección de TourTask
Haz clic en Continue, pega la dirección de TourTask de arriba en Endpoint URL y haz clic en Create destination.
- 6
Copia el secreto de firma
En la página del destino, haz clic en Reveal secret y copia el secreto de firma. Empieza por whsec_.
¿Ya tienes un endpoint para la pasarela Stripe? Añade uno nuevo de todos modos: cada pasarela necesita el suyo.
Añade Stripe Elements en TourTask
- 1
Abre la tarjeta de Stripe Elements
Ve a Configuración → Opciones de pago y haz clic en la tarjeta Stripe Elements en Pagos en línea → Pasarelas de pago. ¿No está? Elige Mostrar todas las pasarelas de pago debajo de las tarjetas.
- 2
Elige el país y la moneda
En País, elige el país de tu cuenta de Stripe Elements y de su cuenta bancaria, y en Moneda, la moneda en la que pagan los viajeros. Haz clic en Agregar. Para cambiar cualquiera de los dos más adelante, quita Stripe Elements con Eliminar y vuelve a añadirlo.
- 3
Rellena tus credenciales de API
En Autenticación, la tarjeta tiene un campo para cada una:
Clave API
Clave publicable
Secreto del webhookCada campo se guarda cuando haces clic fuera de él.
- 4
Activa Stripe Elements
Haz clic en Activar cuando todos los campos estén rellenados. La tarjeta pasa a Activo y los viajeros pueden pagar con Stripe Elements en tu página de reserva. Cada pago llega directamente a tu propia cuenta de Stripe Elements: TourTask nunca retiene tu dinero.
Clave API: tu clave secreta sk_live_…
Clave publicable: tu clave pk_live_…
Secreto del webhook: tu secreto de firma whsec_…
Haz clic en Abierto por defecto en la tarjeta para mostrar el formulario de tarjeta abierto en la parte superior de tu página de reserva.
Comprueba que Stripe Elements funciona
TourTask no tiene modo de prueba para Stripe Elements, y las condiciones de Stripe prohíben los pagos de prueba con tarjetas reales.
- 1
Abre el formulario de tarjeta
En tu propia página de reserva, reserva un tour y elige pagar con tarjeta: aparece el formulario de tarjeta de Stripe. Cierra la página sin pagar.
- 2
Cancela la reserva de prueba
Abre la reserva en TourTask y haz clic en Cancelar reserva.
- 3
Revisa tu primer pago
Cuando un viajero paga con tarjeta, la reserva figura como pagada y el pago aparece en tu Dashboard de Stripe.
- 4
Revisa el webhook
En Stripe, abre la pestaña Event deliveries del destino: payment_intent.succeeded aparece como Delivered.
Revisa el webhook en Stripe: modo live, formato Snapshot, el evento payment_intent.succeeded y la dirección exacta. En TourTask, Secreto del webhook debe contener el secreto de firma de este endpoint. La pestaña Event deliveries del destino en Stripe muestra cada intento fallido.
Añade Apple Pay y Google Pay
Apple Pay y Google Pay son pasarelas propias, que se configuran como Stripe Elements con las mismas dos claves. Cada una necesita su propio endpoint de webhook en su propia dirección, y el secreto de firma de ese endpoint va en su Secreto del webhook.
Apple Pay
https://api.tourtask.com/v1/payments/apple-pay/notifications/bookingGoogle Pay
https://api.tourtask.com/v1/payments/google-pay/notifications/bookingA diferencia del formulario de tarjeta, los botones de monedero solo aparecen en las direcciones registradas en Stripe en Settings → Payment method domains. Registra cada dirección en la que reservan los viajeros: tu propio sitio web, tuempresa.tourtask.com y tu sitio web de TourTask (tuempresa.tourtask.site o su propio dominio). example.com y www.example.com son dos entradas distintas.
Preguntas frecuentes
No. La tarjeta va directamente del navegador del viajero a Stripe.
Stripe Elements mantiene a los viajeros en tu página de reserva; Stripe los envía a la propia página de Stripe y los trae de vuelta. Puedes usar las dos.
Los que están activados en los ajustes de métodos de pago de tu Dashboard de Stripe. Las tarjetas están activadas por defecto.
No. TourTask convierte el total de la reserva a la moneda que elegiste para la pasarela.