Saltar al contenido
Iniciar sesiónRegistrarse

Acepta pagos cripto con la pasarela de pagos FOSSBilling

Te alcanza una cuenta de Cryptonly y una API key. Instala el adaptador, guarda las credenciales y las facturas de FOSSBilling se pueden pagar en cripto. Los pasos de abajo son toda la configuración.

Cómo empezar a aceptar pagos cripto en FOSSBilling

  1. Crea una cuenta de Cryptonly

    Abre una cuenta de comercio en el panel de Cryptonly. Esa cuenta emite la API key, el id de cuenta y la clave de firma del webhook que usan los pasos de abajo.

  2. Genera una API key

    Crea una clave en Settings → Security → API keys con accounts.list, invoices.create e invoices.list. Copia el id de cuenta en Accounts y la clave de firma del webhook en Settings → Security. Guardar el módulo sin esa clave de firma queda bloqueado.

  3. Instala el adaptador de FOSSBilling

    Descarga el adaptador desde el directorio de extensiones de FOSSBilling y extrae el archivo en la raíz de FOSSBilling para que se fusione con la carpeta library que ya existe. Instala Cryptonly en System → Payment gateways → New payment gateway. La ruta de carga y los campos de la pasarela están en la guía de integración de FOSSBilling.

    library/Payment/Adapter/Cryptonly/Cryptonly.php

  4. Guarda los ajustes de la pasarela

    Introduce la API key, el id de cuenta y la clave de firma del webhook. Deja un secreto en blanco en un guardado posterior para conservar el valor almacenado. Activa Test mode solo cuando las credenciales son del sandbox de Cryptonly. El adaptador comprueba la clave y el id de cuenta con GET /accounts cuando lo guardas.

  5. Cobra las facturas

    Usa una dirección HTTPS pública para el sitio de FOSSBilling, así Cryptonly puede entregar el webhook. En la factura, el cliente paga en la página alojada. Un webhook firmado invoice.statusChanged añade el importe que todavía se debe como crédito de la cuenta y paga la factura con ese crédito. Un pago corto se añade como crédito y la factura sigue impaga. Volver desde la página alojada no marca la factura como pagada. El adaptador envía esta URL de webhook con cada factura.

    {siteurl}ipn.php?gateway_id={gateway_id}&invoice_id={invoice_id}

¿Qué es FOSSBilling?

FOSSBilling es un software de facturación de código abierto para empresas de hosting y otros negocios de servicios. Emite facturas, mantiene las cuentas de los clientes y registra cada pago a través de un adaptador de pago.

Un adaptador de pago vive en library/Payment/Adapter. Se extrae en esa carpeta, se activa en Payment gateways y el cliente lo ve al pagar una factura.

Cryptonly usa ese adaptador. Los totales se quedan en la moneda de la factura. El cliente paga en una página de Cryptonly. Un pago corto se convierte en crédito de la cuenta, y un webhook firmado paga la factura cuando ese crédito cubre el total.

¿Qué cripto puedes aceptar con FOSSBilling y Cryptonly?

Ver todas las criptomonedas
BitcoinBTCUSD 81,284.70-2.86%EthereumETHUSD 2,375.06-5.45%TetherUSDTUSD 0.998781-0.03%USD CoinUSDCUSD 1.0012+0.03%BNBBNBUSD 722.29-2.75%TRONTRXUSD 0.3326-0.12%ChainlinkLINKUSD 12.152-6.30%

Preguntas sobre FOSSBilling

  • ¿Qué versiones de FOSSBilling soporta el adaptador?

    FOSSBilling 0.7 o posterior, sobre PHP 8.2 o posterior.

  • ¿Tengo que armar una página de checkout cripto?

    No. El cliente paga en una página alojada de Cryptonly y vuelve a la factura. No construyes una pantalla de wallet ni vigilas la cadena.

  • ¿Cuánto cuesta?

    0.5% por pago, sin tarifa de alta y sin cuota mensual.

  • ¿Puedo probar el adaptador antes de cobrar de verdad?

    Sí. El modo de prueba recorre la página alojada y el webhook en el sandbox de Cryptonly. Lo apagas y pasas a credenciales de producción cuando quieras aceptar pagos reales.

  • ¿Los importes de las facturas tienen que estar en cripto?

    No. Las facturas se quedan en la moneda de la factura. Cryptonly convierte el monto cuando el cliente paga.

  • ¿Cómo se entera FOSSBilling de que una factura está pagada?

    Cryptonly envía un webhook firmado invoice.statusChanged a ipn.php. Paid y overpaid añaden el importe que todavía se debe como crédito de la cuenta y luego pagan la factura con ese crédito. Un pago de más no se guarda como crédito extra. Un pago parcial se añade como crédito y la factura sigue impaga. Volver desde la página alojada no marca la factura como pagada.

  • ¿Cryptonly cobra las renovaciones de suscripción?

    No. Las suscripciones están apagadas. Una factura de renovación se paga con un checkout nuevo.

Acepta pagos cripto con FOSSBilling y Cryptonly

Checkout alojado, webhooks firmados y una comisión del 0.5%. Un pago corto se convierte en crédito de la cuenta, y FOSSBilling paga la factura cuando ese crédito cubre el total.