Pagos con Stripe

Conecta tu cuenta de Stripe a PropPilot para aceptar pagos de reservas y otros cargos de los clientes a través de tu agente de IA.

Requisitos previos

Antes de configurar Stripe:

• ✅ Una cuenta de Stripe (créala en stripe.com)
• ✅ Rol de Admin u Owner en PropPilot
• ✅ Verificación de empresa completada en Stripe (para pagos en vivo)

Qué puedes hacer

Con la integración de Stripe puedes:

• Aceptar depósitos y cargos por reserva
• Crear enlaces de pago para clientes
• Hacer seguimiento del estado del pago en tiempo real
• Ver historial y logs de pagos
• Emitir reembolsos cuando sea necesario

Métodos de conexión

PropPilot soporta dos formas de conectar Stripe:

Opción 1: OAuth Connect (recomendada)

Conéctate usando el flujo OAuth seguro de Stripe:

1. Ve a Integrations → pestaña Stripe
2. Haz clic en Connect with Stripe
3. Inicia sesión en tu cuenta de Stripe
4. Autoriza a PropPilot a acceder a tu cuenta
5. Te redirigirán de vuelta a PropPilot

Ventajas:

• Método más seguro
• Configuración fácil con un clic
• Gestión automática de credenciales
• Compatible con funciones de Stripe Connect

Opción 2: API Key

Para usuarios que prefieran configuración manual:

1. Ve a Integrations → pestaña Stripe
2. Haz clic en Use API Key
3. Introduce tu Stripe Secret Key
4. Haz clic en Save

Para encontrar tu API key:

1. Inicia sesión en el Dashboard de Stripe
2. Ve a Developers → API keys
3. Copia la Secret key (empieza por sk_)

Live vs Test Mode

• Test keys (empiezan por sk_test_): para pruebas, sin cargos reales
• Live keys (empiezan por sk_live_): para pagos reales

Usa test keys durante la configuración y cambia a live keys para producción.

Estado de la conexión

Tras conectarte verás:

Estado	Significado
Connected	Stripe activo y listo
Test Mode	Usando test keys (sin pagos reales)
Live Mode	Usando live keys (pagos reales)
Disconnected	No conectado
Error	Problema de configuración

Plantillas de pago

Crea plantillas de pago reutilizables para escenarios habituales:

Crear una plantilla

1. Ve a Integrations → pestaña Stripe
2. Haz clic en la sección Payment Templates
3. Haz clic en Create Template
4. Rellena los detalles:

Campo	Descripción	Ejemplo
Name	Identificador de la plantilla	"Depósito de reserva"
Amount	Monto del pago	1000 (en céntimos) o 10.00
Currency	Código de moneda	USD, EUR, AED
Description	Mostrado al cliente	"Depósito por unidad 501"

Usar plantillas

Al generar un enlace de pago:

1. Selecciona una plantilla
2. Personalízala si lo necesitas
3. Genera el enlace
4. Compártelo con el cliente

Generar enlaces de pago

Desde PropPilot

1. Ve a la página de detalles de un contacto
2. Haz clic en Create Payment o Request Payment
3. Selecciona una plantilla o introduce un monto personalizado
4. Haz clic en Generate Link
5. Copia y comparte el enlace con el cliente

A través del agente de IA

Tu agente de IA puede generar enlaces de pago durante las conversaciones cuando:

• El cliente confirma interés en una propiedad
• Se requiere un cargo por reserva
• El agente activa el flujo de pago

Seguimiento de pagos

Pagos recientes

Consulta la actividad reciente de pagos en la pestaña de la integración con Stripe:

Columna	Descripción
Date	Cuándo se realizó el pago
Customer	Nombre/correo del contacto
Amount	Monto del pago
Status	Succeeded, Pending, Failed
Reference	ID del pago en Stripe

Estados del pago

Estado	Significado
Succeeded	Pago completado
Pending	Pendiente de procesar
Failed	Pago rechazado
Refunded	Dinero devuelto
Partially Refunded	Reembolso parcial emitido

Webhooks

PropPilot recibe automáticamente webhooks de Stripe para:

• Notificaciones de pago exitoso
• Alertas de pago fallido
• Confirmaciones de reembolso
• Notificaciones de disputas

No necesitas configurar webhooks manualmente.

Notificaciones

Cuando se procesan pagos:

1. Correo: el cliente recibe un correo de confirmación en su idioma preferido (inglés, español, árabe o portugués).
2. In-App: aparece una notificación en PropPilot
3. Chatwoot: se envía un mensaje al chat del cliente (si está activado)

El idioma del correo se determina por el idioma preferido del contacto en su perfil. Si no tiene preferencia, se usa inglés por defecto.

Consulta Notificaciones de pago para la configuración.

Reembolsos

Para emitir un reembolso:

1. Encuentra el pago en Recent Payments
2. Haz clic en la fila del pago
3. Haz clic en Refund
4. Introduce el monto del reembolso (total o parcial)
5. Confirma el reembolso

Los reembolsos suelen tardar entre 5 y 10 días hábiles en aparecer en las cuentas de los clientes.

Resolución de problemas

Falla la conexión

1. Verifica que tu cuenta de Stripe esté activa
2. Comprueba que la API key sea correcta (sin espacios extra)
3. Asegúrate de usar el tipo de key correcto (test vs live)
4. Prueba con la conexión OAuth en su lugar

Los pagos no se procesan

1. Revisa el Dashboard de Stripe en busca de errores
2. Verifica que estás en el modo correcto (test vs live)
3. Comprueba que el método de pago del cliente es válido
4. Revisa los logs de webhooks de Stripe

Los webhooks no funcionan

1. PropPilot configura los webhooks automáticamente
2. Comprueba en el Dashboard de Stripe → Webhooks el estado de entrega
3. Desconecta y reconecta Stripe para resetear los webhooks

Probar pagos

Usa las tarjetas de prueba de Stripe para verificar tu configuración:

Número de tarjeta	Resultado
4242 4242 4242 4242	Pago exitoso
4000 0000 0000 0002	Rechazado
4000 0000 0000 9995	Fondos insuficientes

Usa cualquier fecha de caducidad futura y cualquier CVC de 3 dígitos.

Pasar a producción

Antes de aceptar pagos reales:

1. ✅ Prueba a fondo con test keys
2. ✅ Completa la verificación de empresa en Stripe
3. ✅ Cambia a live API keys
4. ✅ Verifica los endpoints de webhook
5. ✅ Procesa un pago real pequeño como prueba final

Seguridad

• Todas las API keys se cifran en PropPilot
• Stripe gestiona todos los datos sensibles de tarjetas
• PropPilot nunca ve los números completos de tarjeta
• El cumplimiento PCI lo gestiona Stripe

¿Qué sigue?

• Gestionar contactos - Ver pagos de clientes
• Facturación - Suscripción de PropPilot