Integración de Stripe Connect

Importante — Stripe Connect es para pagos entre inquilino↔cliente, NO para facturación de suscripción SaaS

En Booknetic SaaS, tres configuraciones diferentes de Stripe pueden estar activas al mismo tiempo. No las confunda:

Configuración

Qué hace

Dónde en Booknetic

Quién cobra el dinero

Stripe (facturación SaaS)

Cobra a sus inquilinos por su suscripción SaaS (la tarifa mensual/anual que le pagan)

Booknetic SaaS → Settings → Payment settings → Payment methods → Stripe

Tú (el propietario de la plataforma)

Stripe Connect (esta página)

Permite que cada inquilino cobre a sus propios clientes mediante Stripe (las tarifas de reserva que los clientes pagan a los inquilinos)

Booknetic SaaS → Settings → Payment settings → Payment methods → Stripe Connect + incorporación por inquilino

Cada inquilino (Stripe envía los fondos a la cuenta Stripe Connect del inquilino)

Stripe del lado del inquilino (no Connect)

Alternativa a Stripe Connect — cada inquilino pegue sus propias claves API Stripe para cobrar a sus clientes

Panel de cada inquilino → Settings → Payment methods → Stripe

Cada inquilino directamente

No necesita configurar las tres. La mayoría de los propietarios de SaaS configuran:

• Stripe de facturación SaaS (para que reciban pagos de los inquilinos) +
• Stripe Connect (para que sus inquilinos reciban pagos de sus clientes).

Prerrequisitos

Antes de empezar:

• Una cuenta Stripe (https://dashboard.stripe.com que será la propietaria de la plataforma Connect.
• Un negocio en un país donde Stripe Connect esté disponible (https://stripe.com/global.
• La capacidad del plan stripe-connect habilitada en cada plan cuyos inquilinos deberían poder integrarse a Stripe Connect (Booknetic SaaS → Plans → editar un plan → activar stripe-connect).

Configura su plataforma Stripe Connect

Paso 1: Abra la configuración de Stripe Connect.

Inicia sesión en [https://dashboard.stripe.com/connect/set-up](https://dashboard.stripe.com/connect/set-up]. El asistente de configuración Connect le guía a través de varias etapas; la redacción exacta puede cambiar a medida que Stripe actualice la interfaz, pero la estructura es consistente.

Paso 2: Informa a Stripe sobre su plataforma.

• Perfil de la plataforma — describe lo que hace su plataforma (software de reservas multiinquilino). Stripe utiliza esto para revisión de riesgos.
• Modelo de negocio — elija la opción que coincida con su plataforma. Para la mayoría de plataformas SaaS de reservas, la opción correcta es "Plataforma multiparte con cuentas conectadas que cobran pagos a sus propios clientes".
• Reconocer responsabilidades — Stripe enumera sus obligaciones como plataforma; marca la casilla una vez que las haya leído.

Paso 3: Elija cómo se pagan sus cuentas conectadas (inquilinos).

• Cargos directos, cargos de destino o cargos/transferencias separadas. La mayoría de los propietarios Booknetic SaaS usan cargos por destino, así que los inquilinos son los encargados de la relación con el cliente mientras tú permaneces en el flujo de pago.

Paso 4: Seleccione su sector.

La taxonomía del sector de Stripe afecta a la puntuación de riesgo y a las franjas de tarifas disponibles para su plataforma. Elija la opción que más se ajuste al negocio real de sus inquilinos:

• "Servicios personales" / "Salones y spas" / "Salud y bienestar" — para plataformas SaaS de cuidado personal y bienestar.
• "Educación" — para plataformas de reservas de tutorías/coaching.
• "Servicios profesionales" — para consultoría/legal/contratación de agencias.
• "Software de Gestión Empresarial" u "Otro" — recurso cuando ninguno de los anteriores encaja.

Paso 5: Elija su modelo de incorporación.

Modelo de incorporación

Cuándo elegir

Experiencia del inquilino

Stripe-alojado (Express) — recomendado para la mayoría de los SaaS

La incorporación más sencilla; Stripe recopila documentos de KYC y de identificación; El inquilino inicia sesión en Stripe panel Express para recibir pagos/disputas

Los clics de inquilino Register en Booknetic → Stripe redireccionar → llena 5-7 campos → vuelvaya a Booknetic

Stripe-alojado (Estándar)

Cada inquilino tiene su propia cuenta Stripe Dashboard completa a su nombre; Mejor cuando los inquilinos necesitan Stripe características más allá de las reservas

Clics de inquilinos Register → registro completo Stripe

Personalizado

Avanzado — tú mismo creas el formulario de incorporación y recoges los datos de KYC/negocio

Requiere trabajo de desarrollo; no manejado por Booknetic nada más empezar

Para el resto de esta guía, asumimos que Stripe alojado Express.

Paso 6: Marca la experiencia Connect.

Sube el logo de su negocio y un icono. Opcionalmente, personaliza colores de acento. Estos se muestran a los inquilinos durante la incorporación.

Pegue Stripe credenciales en Booknetic

1. En Stripe Dashboard → Developers → claves API (https://dashboard.stripe.com/apikeys), copiar:
   • Publishable key (pk_live_... o pk_test_...)
   • Secret key (sk_live_... o sk_test_...)
2. En Booknetic SaaS → Settings → Payment settings → Payment methods → Stripe Connect, pegue ambas claves.
3. Guardar.

Configurar el webhook Stripe Connect

1. En Booknetic SaaS → Settings → Payment settings → Payment methods → Stripe Connect, copie el Webhook URI (la URL contiene booknetic_saas_action=stripe_webhook).
2. En Stripe Dashboard → Developers → Webhooks → Add endpoint, pegar la URL.
3. Suscríbete al menos a estos eventos (la interfaz de Stripe le permite añadir más):
   • payment_intent.succeeded
   • payment_intent.payment_failed
   • charge.refunded
   • account.updated (para que Booknetic sepa cuándo cambia el estado de Verified de un inquilino)
4. Después de crear el endpoint, copie el Signing secret (whsec_...) de nuevo en Booknetic Stripe Connect configuración.
5. Guardar.

Incorporación de inquilinos

1. Asegurarse de que el plan del inquilino tenga activada la capacidad de stripe-connect.
2. El inquilino accede a Panel de inquilinos → Settings → Métodos de Pago Settings → Pago → Stripe Connect y hace clic en Register.
3. Booknetic los redirige al flujo de incorporación alojado de Stripe.
4. El inquilino rellena los datos del negocio, la cuenta bancaria y la verificación de identidad.
5. Al completarse, Stripe los redirige de vuelta a Booknetic. Su estado de Stripe Connect aparece en el panel de inquilinos.

Estasus de los inquilinos y lo que significan

Estado en Booknetic

Significado

Qué debe hacer el inquilino

Pendiente

El inquilino hizo clic en Register pero no ha completado Stripe proceso de incorporación

El inquilino debe terminar de incorporarse

Restringido

Stripe aceptado algunos datos pero necesita información adicional (DNI, dirección, verificación bancaria)

El inquilino debe iniciar sesión en su Panel de Control de Stripe Express y proporcionar la información que falta

Verificado

KYC completo; El inquilino puede aceptar pagos

Sin acción

Deshabilitado

Stripe desactivado la cuenta (sospecha de fraude, infracción de los Términos de Servicio, cambio de país, etc.)

El inquilino debe contacter con Stripe Soporte

Reembolsos y disputas

Los reembolsos se gestionan en Stripe Dashboard o Stripe Express Dashboard, no en Booknetic. Para emitir un reembolso:

1. El inquilino o propietario de la plataforma abra el pago correspondiente en Stripe Dashboard.
2. Haga clic en Reembolso y elija total o parcial.
3. El estado de la reserva en Booknetic no cambia automáticamente a "reembolsado" — el inquilino debe actualizar manualmente el estado de la cita.

Las disputas (devoluciones de cargo) fluyen al panel de control de la cuenta conectada. El inquilino —no la plataforma— es responsable de responder.

Bloqueadores de configuración comunes

Síntoma

Causa probable

Corrijar

"Stripe Connect" no aparece en los Métodos de Pago del inquilino

stripe-connect capacidad DESACTIVADA en el plan del inquilino

Booknetic SaaS → Plans → activar stripe-connect interruptor

El inquilino hace clic Register, recibe un error de Stripe "Onboarding no configurado"

Configuración de la plataforma incompleta (no se guarda Publishable/Secret key en Booknetic, ni plataforma Connect aún no activada en Stripe Dashboard)

Revise de nuevo el paso de las credenciales de Stripe anterior

El estado del inquilino permanece pendiente para siempre

Webhook no suscrito a account.updated

Agregue account.updated al endpoint del webhook según el paso del webhook anterior

El inquilino en un país Stripe Connect no cubre

Restricción Stripe

El inquilino usa Stripe del lado del inquilino (no Connect) u otra pasarela