Guía de facturación
Comprar extensiones, suscripciones, ingresos, saldo, CSV y cuenta de PayPal.
En esta página
La página /admin/billing es para el dueño del dominio (nivel de permiso 4, con step-up para acciones sensibles). Aquí compras extensiones de pago, gestionas tus suscripciones y, si publicas extensiones, ves tus ingresos y cobras. El proxy del frontend es /api/admin/billing; los pagos los procesa PayPal, BloomX nunca ve los datos de tu tarjeta.
Si ves el aviso de pagos no configurados, el operador de la plataforma aún no activó PayPal (Configuración de PayPal). Tu dominio también debe estar firmado (con clave registrada).
Comprar una extensión#
- En el catálogo elige la extensión de pago y pulsa comprar. El importe lo calcula el servidor desde la base de datos; no se toma del navegador.
- Pago único: se abre la aprobación de PayPal y, al volver, BloomX captura el pago.
- Suscripción: eliges mensual o anual (con prueba gratuita si la hay) y apruebas la suscripción en PayPal.
- Vuelves a
/admin/billing. Solo vuelves al origen de tu propia instancia.
| Estado | Significado |
|---|---|
| pendiente | PayPal aún no confirmó la captura. Puede tardar unos segundos o minutos; se reconcilia sola. |
| ok | Cobro confirmado por PayPal y licencia concedida. |
| fallido | Pago rechazado, cancelado o caducado. No se concede nada; puedes intentarlo otra vez. |
Nunca se concede una licencia sin una captura COMPLETED confirmada por PayPal; si cierras la ventana a medias, el webhook y la conciliación periódica terminan el trabajo.
Instalación y permisos#
Tras el pago la extensión se instala en tu dominio, pero queda pendiente de aprobación hasta que revises y apruebes sus permisos (igual que cualquier extensión, ver Extensiones). Si la extensión pide permisos nuevos en una versión posterior, debes aprobarlos de nuevo.
Licencia revocada#
Un reembolso o un contracargo revoca la licencia. La extensión se pausa (deja de ejecutarse y de instalarse) pero tus datos no se borran: si vuelves a comprarla, todo sigue ahí.
Suscripciones#
| Situación | Qué ocurre |
|---|---|
| Prueba | Acceso completo durante la prueba (0 a 30 días); el primer cobro llega al terminar. |
| Renovación | PayPal cobra cada ciclo y BloomX lo registra. El acceso se extiende al siguiente periodo. |
| Fallo de pago | Periodo de gracia de 3 días (PAYMENTS_GRACE_DAYS) con la extensión activa; si no se cobra, la extensión se pausa. |
| Cancelar | Mantiene el acceso hasta el fin del periodo ya pagado. No hay reembolso del periodo en curso. |
| Reanudar | Crea una suscripción nueva, sin una segunda prueba gratuita. |
| Cambiar mensual a anual (o al revés) | Rige desde el siguiente ciclo, sin cobro doble: PayPal no prorratea. |
Aprobar un cambio de precio#
Los planes de PayPal son inmutables. Si el desarrollador sube el precio, sigues pagando el precio anterior hasta que apruebes el nuevo; la página te muestra un aviso y un botón de aprobación que te lleva a PayPal. Si no lo apruebas, tu precio actual no cambia.
Resumen de ingresos y egresos#
El resumen se calcula sobre un rango de fechas que eliges (por defecto 30 días, máximo 366). Muestra lo que gastaste en extensiones y, si vendes, lo que ganaste.
- Ventas por extensión: unidades, bruto, tu parte y reembolsos.
- MRR y bajas de tus suscripciones (ingreso mensual recurrente y cancelaciones).
- Historial de compras, pagos y reembolsos, con paginación.
Saldo: disponible, retenido y pagado#
| Saldo | Qué es |
|---|---|
| Retenido | Tu parte de ventas recientes, aún dentro de los 14 días de retención. |
| Disponible | Ya cumplió la retención; se paga en el siguiente ciclo si supera el mínimo. |
| Pagado | Lo que PayPal Payouts ya envió a tu cuenta. |
Si un reembolso deja tu saldo en negativo, se compensa con las ventas siguientes. Reglas de reparto y retención en la Guía de desarrollador.
CSV y recibos#
- CSV de compras, ventas, pagos o libro mayor. Las celdas que podrían interpretarse como fórmulas se neutralizan para que abrirlo en una hoja de cálculo sea seguro.
- Recibo por cada compra o cobro, para tu contabilidad. No sustituye a un comprobante fiscal: las obligaciones tributarias son tuyas.
Vincular o cambiar tu cuenta de PayPal#
Para cobrar como desarrollador vinculas tu cuenta con Log in with PayPal. Es solo una prueba de propiedad: BloomX guarda el identificador de pagador y el correo verificado, y descarta los tokens al instante (no se almacenan).
- Cambiar la cuenta exige step-up. Se envía un correo al dueño y a los super admins de la plataforma.
- Los pagos pendientes siguen yendo a la cuenta anterior durante 24 h (
PAYMENTS_ACCOUNT_SWITCH_HOURS); así, si alguien secuestra tu sesión, tienes tiempo de detectarlo. - El inicio de sesión usa un
statede un solo uso que caduca en 10 minutos.
Véase también#
- Guía de desarrollador para publicar y fijar precios.
- Configuración de PayPal para el operador.
- Seguridad de pagos y marketplace.