Descripción General de Facturación

Cómo Funciona la Facturación

El sistema de facturación de Whatalo te permite monetizar tu plugin con una configuración mínima. La plataforma gestiona el procesamiento de pagos, la facturación, el ciclo de vida de las suscripciones y el seguimiento de ingresos — tú te concentras en construir.

Flujo general:

1. Establece pricing: "paid" en tu manifest (whatalo.app.ts)
2. Crea planes de precios en el Portal de Desarrolladores
3. Usa la API de facturación del App Bridge para gestionar suscripciones desde tu plugin
4. La plataforma gestiona el procesamiento de pagos, facturación y seguimiento de ingresos
5. Solicita pagos cuando tu saldo alcance el umbral mínimo

Conceptos Clave

Planes

Niveles de precios que defines para tu plugin. Puedes tener hasta 5 planes activos por plugin. Los planes tienen nombre, precio, intervalo de facturación, período de prueba opcional y una lista de características para mostrar en el marketplace.

Suscripciones

Cuando un comerciante se suscribe a uno de tus planes, se crea un registro AppSubscription para su instalación. Existe una suscripción por instalación. La suscripción avanza por un ciclo de vida: pending → trialing (si hay prueba) → active → past_due / canceled.

Pruebas Gratuitas

Puedes ofrecer un período de prueba gratuito (0–90 días). Las pruebas se otorgan una sola vez por instalación — reinstalar el plugin no vuelve a otorgar una prueba. Durante el período de prueba, el comerciante no es cobrado. Cuando termina la prueba, la facturación se activa automáticamente.

Comisión

La plataforma toma un porcentaje de cada cargo. La tasa predeterminada es del 5%. Tus ingresos netos por cargo son:

montoNeto = montoTotal - (montoTotal × tasaComisión)

La tasa de comisión queda registrada en cada registro de cargo — los cargos históricos nunca se recalculan si cambia la tasa de la plataforma.

Pagos

Puedes retirar tu saldo ganado a través del Portal de Desarrolladores una vez que alcance el umbral mínimo de pago de $50.00 USD. Debes tener al menos un método de pago verificado registrado, y solo se permite una solicitud de pago pendiente a la vez.

Modelo de Facturación

Las suscripciones de plugins se facturan como líneas adicionales en la suscripción existente del comerciante. No se crea una relación de facturación separada entre tú y el comerciante. La plataforma gestiona toda la relación de pago.

Próximos Pasos

• Planes y Precios — Crea y configura tus niveles de precios
• Flujo de Suscripción — Cómo los comerciantes se suscriben y gestionan su suscripción
• Ingresos y Pagos — Rastrea ganancias y solicita pagos
• Referencia del SDK de Facturación — Referencia completa de la API de facturación del App Bridge