Esta guía explica cómo conectar tu cuenta con el sistema Teya y cómo gestionar los pagos directamente desde la plataforma después de tus reservas.
1. Obtener los datos de la API de Teya y el ID de tienda
Para permitir la comunicación automática entre los dos sistemas, necesitarás los siguientes datos de tu cuenta de Teya:
- ID de tienda (Store ID)
- ID de cliente (Client ID)
- Client Secret
- Inicia sesión en tu cuenta de Teya / portal de desarrolladores.
- Ve a Configuración > Integraciones.
- Crea una nueva clave de API / aplicación para nuestra plataforma.
- Copia el Client ID y el Client Secret generados.
- Busca y copia el ID de tienda (Store ID).
2. Conectar Teya con la plataforma y configurar el webhook
Una vez que tengas los datos necesarios, vuelve a nuestra plataforma para completar la integración.
- Ve a la página Aplicaciones externas.
- Busca la tarjeta de Teya y haz clic en el botón Vincular datos de API que aparece debajo de Teya.
- Completa los campos solicitados (Store ID, Client ID, Client Secret) en la ventana emergente.
- En la ventana emergente aparecerá una URL de webhook única asociada a tu cuenta (
https://appointio.eu/teya/webhook). ¡Copia esta URL! - Vuelve a la interfaz de Teya y accede a la configuración de Webhook. Pega la URL copiada en el campo del webhook. A continuación, pega la clave de webhook recibida en el campo inferior de nuestra plataforma y haz clic en Guardar.
- El modo de prueba solo debe activarse si quieres conectar tu cuenta de prueba de teya.xyz.
3. Gestionar los pagos desde las reservas
Una vez completadas la conexión y la configuración del webhook, el sistema estará listo para gestionar las transacciones de Teya. Para comenzar, activa la opción Pago online en la página de configuración de los servicios deseados.
Regla importante:
Si una transacción de Teya falla durante la reserva, los clientes disponen de 15 minutos para completar el pago. De lo contrario, el horario reservado se liberará automáticamente.
¿Qué sucede después del pago?
En segundo plano, nuestro sistema envía inmediatamente los datos al sistema de Teya.
- La transacción se inicia y se procesa a través de la red de Teya.
- Teya envía automáticamente una notificación sobre el estado del pago a través de la URL de webhook especificada (
https://appointio.eu/teya/webhook). - El estado de la reserva se actualiza automáticamente como pagado en nuestra plataforma. ¡No tienes que hacer nada más!
