> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ouraicalling.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Stripe y Stripe Connect

> Pagos de los planes de la plataforma, y cómo los inquilinos les cobran a sus propios clientes

La plataforma usa Stripe como método de pago en dos niveles: la **cuenta de la plataforma** para los clientes directos, y **Stripe Connect** para que cada inquilino pueda cobrarles a sus clientes finales bajo su propio nombre.

## Pagos de la plataforma (usuarios directos)

* **Suscripciones a planes**: facturación recurrente mediante Stripe Checkout; cada factura pagada restablece los créditos del plan incluidos en el [saldo](/admin/balances-and-transfers) del espacio de trabajo activo.
* **Recargas de créditos**: pagos únicos por Checkout que se acreditan solo en el espacio de trabajo activo.
* **Tarifas por número**: cargos mensuales por los números de teléfono comprados.
* **Portal del cliente**: los usuarios gestionan sus métodos de pago, facturas y cancelaciones en el portal alojado por Stripe.

Los eventos de pago se procesan de forma idempotente: un webhook reintentado nunca puede acreditar dos veces a un espacio de trabajo ni duplicar su suscripción. Los retornos de Checkout y del portal usan el dominio verificado en el que el cliente empezó a facturar.

## Stripe Connect (inquilinos)

Los inquilinos monetizan a sus propios usuarios mediante cuentas conectadas: los fondos se liquidan en la cuenta conectada, mientras que la plataforma cobra su tarifa de aplicación:

<Steps>
  <Step title="Incorporación">
    En el área de administración del inquilino, **Plataforma de facturación** crea una cuenta conectada basada en controlador con acceso al Panel de Stripe completo e inicia la incorporación alojada. Stripe recopila los datos del negocio del inquilino y su cuenta de cobro; la página muestra el estado de la incorporación en tiempo real.
  </Step>

  <Step title="Crea tus planes y sincronízalos">
    El inquilino define [sus propios planes](/admin/plans-and-limits) con sus propios precios. Cada plan se sincroniza como producto/precio en la cuenta Connect del inquilino.
  </Step>

  <Step title="Los clientes finales le pagan al inquilino">
    El Checkout de un plan del inquilino cobra **en la cuenta Connect del inquilino**. La plataforma deduce automáticamente una **tarifa de aplicación** que representa los costos y el margen de la plataforma; el resto es del inquilino.
  </Step>
</Steps>

## Transparencia de márgenes

Como la plataforma conoce ambos lados —el precio del plan del inquilino y el costo por minuto que la plataforma le cobra al inquilino—, el administrador del inquilino ve el **margen por plan** y un **resumen de ganancias** mensual (ingresos − costos de la plataforma). Las decisiones de precios dejan de ser una adivinanza.

## Para operadores de la plataforma

Hay que configurar dos endpoints de webhook en el panel de Stripe: uno para **eventos de tu cuenta** (`checkout.session.completed`, suscripción actualizada/eliminada, factura pagada/fallida, y `payment_intent.succeeded` para la recarga automática) y otro para **eventos de cuentas conectadas** (el mismo conjunto de eventos de suscripción más `account.updated` para el estado de la incorporación). Ambos endpoints verifican las firmas y registran cada id de evento, lo que hace que el procesamiento sea idempotente por diseño.