Documentación / Vender hosting con NimboBilling — instalación y primeros pasos

Vender hosting con NimboBilling — instalación y primeros pasos

NimboBilling es la aplicación de tienda y facturación que viene con cada licencia de pago de Nimbopanel. Es una aplicación independiente, no una parte del panel: el panel no acepta pagos ni sirve páginas de venta. NimboBilling te da una tienda en tu propio dominio, facturas, cuentas de cliente y un centro de soporte, y cuando se paga una factura crea por ti la cuenta de hosting en el panel. Esta guía cubre la instalación y la primera hora. Lo que ofrece la aplicación está en la página de NimboBilling, y la versión corta de la configuración está en Sitio web de marketing.

Solo un administrador o un revendedor la instala, desde su propia sesión, en una cuenta de hosting que es suya.

Antes de empezar

  • Una licencia de pago. En el nivel Free el catálogo muestra NimboBilling en gris, con el texto "Requiere una licencia de pago".
  • Una cuenta de hosting para la tienda. Su dominio principal es la dirección en la que vivirá la tienda (yourbrand.com, o un nombre como shop.yourbrand.com), y ese nombre apunta al servidor. NimboBilling ocupa la raíz del sitio, así que usa una cuenta que no tenga otro sitio web. Siempre usa HTTPS.
  • PHP 8.3 o superior en esa cuenta. Si la cuenta usa una versión anterior, la tarjeta de instalación te avisa; cámbiala antes en Versión de PHP.
  • Tu propia sesión. No la instales después de usar Iniciar sesión para abrir el panel de un cliente.

Instálala, paso a paso

  1. En Cuentas, abre Gestionar → Apps en la cuenta. Un atajo: Buscar herramientas tiene "Vender hosting (NimboBilling)", que te lleva a Cuentas y deja NimboBilling ya elegido cuando se abre la ventana de Apps.
  2. Elige NimboBilling en la lista. Su tarjeta dice qué es y qué necesita, y cada casilla tiene una línea de ayuda.
  3. Rellena el formulario. No hay casilla de carpeta, porque NimboBilling siempre ocupa la dirección principal del dominio:
    • Título del sitio: el nombre de tu tienda.
    • Tu nombre: se muestra solo dentro de la aplicación. Inicias sesión con tu dirección de correo, no con este nombre.
    • Correo de administrador: con el que inicias sesión y al que la aplicación te envía sus mensajes.
    • Contraseña de administrador: escribe una de al menos 12 caracteres, con letras y números, o déjala vacía para que se genere una segura.
    • Idioma: el idioma con el que empieza el administrador de la aplicación y el idioma predeterminado de la tienda: inglés o Bahasa Indonesia. La elección también define la moneda y la zona horaria con las que arranca la tienda. El inglés empieza con dólares estadounidenses y UTC; el otro idioma empieza con la moneda y la zona horaria que suelen acompañarlo. Puedes cambiar los tres más tarde (más abajo).
  4. Pulsa Instalar. Tarda alrededor de un minuto.

Si el dominio ya tiene un sitio

El panel pregunta antes de hacer nada. Un cuadro de diálogo titulado ¿Reemplazar el sitio de este dominio? enumera los archivos que encontró y explica qué ocurre: NimboBilling pasa a ser el sitio del dominio, el sitio que hay ahora deja de mostrarse en cuanto termina la instalación, y tus archivos no se borran, salvo los que tengan el mismo nombre que alguno de los propios de la aplicación, que se reemplazan. Quitar NimboBilling más adelante vacía la carpeta. El botón seguro, Cancelar, es el que tiene el foco. Para conservar el sitio anterior, cancela e instala NimboBilling en una cuenta de hosting o un dominio nuevos, o haz antes una copia de seguridad.

La tarjeta tras la instalación

La tarjeta muestra la dirección de la tienda y la de administración, tu correo, tu nombre y la contraseña, cada uno con un botón Copiar. Guarda la contraseña ahora: solo se muestra una vez.

Las dos direcciones son seguras (https). El certificado de un nombre nuevo tarda unos minutos, así que hasta que esté listo la tarjeta muestra las direcciones como texto sin formato, con una nota, y las convierte en enlaces por sí sola cuando el certificado está activo (dice "La dirección segura ya está lista"). Abrir la tienda antes muestra una advertencia de certificado.

Una segunda tarjeta dice NimboBilling está conectado a este panel. Durante la instalación el panel creó un token de API para la tienda, llamado NimboBilling, con acceso a Cuentas (lectura y cambios), y la tienda registró este panel con él, de modo que un pedido pagado puede crear una cuenta de hosting sin más configuración. El token aparece en Tokens de API, donde puedes revocarlo, y se revoca cuando se quita la aplicación. Para comprobar la conexión, abre Services → Panel servers en NimboBilling y pulsa Test connection. Si el panel no pudo crear el token, la tarjeta enumera los pasos para conectar ambos a mano. La línea del planificador de la aplicación se añade por ti a las Tareas cron de la cuenta; si eso falló, la tarjeta muestra la línea que hay que añadir.

Otra línea de la tarjeta es importante: los clientes no verán ninguna forma de pagar hasta que añadas tus datos bancarios en Settings → Gateway: Manual transfer.

Qué contiene una tienda nueva

Una instalación nueva se rellena una sola vez con una tienda de ejemplo, de modo que los menús de la tienda funcionan desde la primera visita en lugar de llevar a páginas vacías:

  • planes de ejemplo en cuatro grupos: hosting compartido, servidores VPS, un servidor dedicado y nombres de dominio,
  • un centro de ayuda inicial con artículos sobre pedidos, pagos, servicios y tu cuenta,
  • unas cuantas entradas de blog, publicadas, y dos anuncios que siguen siendo borradores hasta que los publiques.

Todos los nombres, especificaciones y precios que contiene son ejemplos. Los planes de ejemplo se muestran en dólares estadounidenses, o en la moneda de la tienda cuando elegiste el otro idioma al instalar. Los planes de hosting y de servidor no tienen ningún servidor del panel asociado, así que un pedido de uno de ellos queda a la espera de tu equipo hasta que vincules un producto con tu servidor del panel y con el nombre exacto de uno de tus paquetes (el Panel server y el Package name on the panel del producto). Sustituye los planes de ejemplo por los tuyos, o elimínalos, antes de abrir la tienda. Nada los trae de vuelta: la tienda registra que el ejemplo se ofreció una sola vez.

Cómo dejar lista tu tienda

Desde NimboBilling 1.0.7, una tienda nueva exige el inicio de sesión en dos pasos a todos los miembros del equipo: el primer inicio de sesión del propietario va directamente a configurarlo. Una tienda instalada antes de la 1.0.7 no se cambia; su panel de administración se lo recomienda al propietario, y el ajuste está en Settings → Security → Require 2FA for all staff.

El panel de administración muestra una tarjeta, Getting your store ready, hasta que todos los pasos están hechos. Cada paso se marca a partir de los propios datos, no a mano:

  1. Connect your hosting panel (conectar tu panel de hosting): solo aparece si la instalación no lo conectó ya. Services → Panel servers.
  2. Add your company email (añadir el correo de tu empresa): se muestra en las facturas y los clientes lo usan para contactar contigo. Settings → General.
  3. Set up outgoing email (SMTP) (configurar el correo saliente): sin él, las facturas y los recordatorios no llegan a los clientes. Settings → Email (SMTP).
  4. Set up payment: start with bank transfer (configurar el pago: empieza con la transferencia bancaria). Mira más abajo.
  5. Replace the sample plans with your own (sustituir los planes de ejemplo por los tuyos). El paso cuenta como hecho cuando existe un plan tuyo, o cuando has editado uno de ejemplo.
  6. Choose your store's look (elegir el aspecto de tu tienda): en Theme, logo & slides, elige una plantilla prediseñada y luego ajusta colores, fuentes y logo.

Precios, margen y referidos

El precio de la tienda es el precio base del producto más un margen. En Settings → Billing & Pricing, Default markup (%) es del 10 % al principio, y un solo producto puede llevar una cifra propia en su página. El margen es lo que financia las comisiones por referidos: están desactivadas hasta que las actives en Settings → Referrals & Commissions, y pueden llegar hasta cinco niveles.

Add a markup to selling prices es el interruptor. Con él desactivado, cada producto se vende a su precio base y no hay dinero para las comisiones por referidos. Se aplica a los pedidos nuevos y a las renovaciones posteriores; las facturas ya emitidas no cambian. Desde NimboBilling 1.0.7, los planes de ejemplo de una tienda nueva también siguen el margen predeterminado, así que al desactivar el interruptor se nota de inmediato en sus precios (un plan de USD 3.99 se vende a 4.39 con el 10 % predeterminado). Una tienda instalada con una versión anterior conserva planes de ejemplo con un margen propio fijado en el 0 %. Cuando un miembro del equipo hace un pedido a un precio superior al del catálogo mientras el interruptor está desactivado, la diferencia cuenta como precio base, no como margen, así que no financia ninguna comisión por referidos.

Impuestos

Los impuestos están desactivados hasta que los actives: Settings → Billing & Pricing → Charge tax (VAT/GST). Los tipos están en Tax rules. Su bloque Common tax rates añade con un clic el tipo nacional estándar de uno de 18 países. Eso solo crea una regla, nunca activa los impuestos, y los tipos cambian, así que confírmalos con tu asesor. Para las ventas dentro de la UE también puedes indicar tu propio país, activar la inversión del sujeto pasivo para los clientes empresa y hacer que el número de IVA de un cliente se compruebe en el servicio VIES de la Comisión Europea (activado por defecto; cuando no se puede llegar a VIES, el número cuenta como no verificado, se cobra el IVA y el personal puede marcarlo como verificado a mano).

Zona horaria e idioma

Settings → General contiene la Time zone de la tienda. Las fechas y horas del panel de administración, de las páginas de clientes, de los PDF y de los correos, y la hora de la ejecución diaria automática de la facturación la siguen. Defínela antes de las primeras facturas: las fechas guardadas no cambian cuando cambias la zona, así que el vencimiento de una factura puede mostrar un día antes o un día después, y el ajuste lo avisa.

La misma página tiene Admin panel language (inglés o Bahasa Indonesia), que se aplica a los menús, los formularios y el Manual de la administración para todo tu equipo. Los textos de la propia tienda se guardan en el idioma principal de la tienda, el elegido al instalar, y los campos que contienen ese texto dicen (main language) en la administración en inglés; desde NimboBilling 1.0.7 la tienda de ejemplo también está escrita en ese idioma. No cambia el idioma que ven los clientes; eso está en Settings → Language. La moneda predeterminada también está en esta página, junto con las monedas que los clientes pueden elegir.

Pagos

Las pasarelas se configuran en Settings, una página para cada una.

  • La transferencia bancaria va primero porque no necesita una cuenta en una pasarela. Viene activada desde el principio, pero a los clientes solo se les ofrece cuando sustituyes el ejemplo de Settings → Gateway: Manual transfer por tus datos bancarios reales. El cliente sube un comprobante de la transferencia y tu equipo lo aprueba en Payments.
  • Stripe (tarjetas): Settings → Gateway: Stripe (cards). Tiene un modo de prueba; úsalo primero.
  • PayPal: Settings → Gateway: PayPal, con un interruptor de sandbox.

Para Stripe y PayPal, la página de ajustes muestra una Webhook URL y los eventos que hay que seleccionar. Añádela en la pasarela, o un pago hecho después de que el cliente haya cerrado la pestaña se confirmará tarde.

Qué está demostrado. Stripe está demostrado solo en su modo de prueba. PayPal todavía no está demostrado de extremo a extremo con un pago real. Haz tú mismo una pequeña compra real antes de anunciar la tienda. El Manual / guide de la propia aplicación tiene el paso a paso de cada pasarela.

Actualizar

Cuando hay una versión más reciente de NimboBilling en el catálogo, Gestionar → Apps muestra Actualización disponible junto a ella y un botón Actualizar. El panel hace antes una copia de seguridad, reemplaza el código de la aplicación, conserva tu configuración de .env, ejecuta la actualización propia de la aplicación y comprueba que el sitio responde. Si no arranca correctamente, el panel restablece la versión anterior y te dice que tu sitio no ha cambiado. Tus productos, clientes, facturas y ajustes se quedan como están. Una tienda instalada con una versión anterior no recibe textos de ejemplo nuevos escritos en ella.

Quitarla

Gestionar → Apps → Quitar, y después escribe remove para confirmar. Esto elimina los archivos y la base de datos de la tienda, con sus facturas, clientes y tickets, así que haz antes una copia de seguridad. La carpeta queda vacía, y el token de API que usaba la tienda se revoca. Las cuentas de hosting que creó son cuentas del panel y no forman parte de la aplicación.

Cuando algo falla

  • La tarjeta dice que la carpeta ya contiene archivos. Lee el cuadro de diálogo de más arriba y elige una cuenta nueva si quieres conservar el sitio que hay.
  • La dirección de la tienda muestra una advertencia de certificado justo después de la instalación. Espera unos minutos: la tarjeta activa los enlaces cuando el certificado está listo.
  • Los clientes no ven ninguna forma de pagar. Añade tus datos bancarios en Settings → Gateway: Manual transfer, o activa una pasarela.
  • Un pedido pagado no creó una cuenta. Abre el producto y comprueba que está vinculado a tu servidor del panel y al nombre exacto de uno de tus paquetes. Un plan de ejemplo no lo está. Mira también la comprobación de la conexión de más arriba.
  • La instalación se rechaza por PHP. La cuenta usa una versión inferior a la 8.3. Cámbiala en Versión de PHP e instala de nuevo.
  • NimboBilling aparece en gris en la lista. El servidor está en el nivel Free; consulta Cómo funciona el licenciamiento.

Relacionado: Sitio web de marketing · Guía del revendedor · Cómo funciona el licenciamiento · Resolución de problemas