Al final, un pedido pagado en tu plataforma crea una línea y cada pago la renueva, sin pasar por el panel. Necesitas una cuenta de socio (revendedor) con créditos y paquetes que pueda vender, y una plataforma con conector: WHMCS, Blesta, WISECP, HostBill, ClientExec, FOSSBilling, Paymenter, WordPress con WooCommerce o Easy Digital Downloads, Odoo, PrestaShop, OpenCart, Magento, Dolibarr, ERPNext, o Shopify, Upmind e Invoice Ninja mediante el puente de webhooks.
Crear una clave de API
Inicia sesión con la cuenta de socio y abre Clave de API. Una clave se muestra una sola vez, al crearla: cópiala enseguida. Crea una clave adicional por sistema, con un nombre y las direcciones autorizadas a usarla, para poder revocar una sin tocar las demás; el conector necesita una clave con permiso de escritura, así que deja desactivado el indicador de solo lectura.
Elegir el conector
Abre Recursos → Todos los conectores y elige tu plataforma. Su página enumera los datos de conexión, los pasos de instalación, un botón Descargar, el SHA-256 del archivo para verificarlo y hasta dónde se ha probado ese conector: algunos se ejecutaron dentro de la plataforma real, otros solo se ejercitó su núcleo. El código fuente es abierto; los mismos archivos se publican en el sitio de conectores.
Instalarlo en tu plataforma
Verifica la suma de comprobación e instala el archivo donde indica la página del conector: la carpeta de módulos de WHMCS, Blesta o FOSSBilling, la subida de plugins de WordPress, la carpeta addons de Odoo, el instalador de extensiones de OpenCart, etcétera. El puente de webhooks para Shopify, Upmind e Invoice Ninja es una pequeña aplicación PHP que alojas tú mismo. Un conector solo llama a la Reseller API con tu clave: puede hacer lo que puede hacer tu cuenta, nada más.
Configurarlo
En los ajustes del conector introduce la dirección del servidor de la API (su ruta /reseller/v1) y la clave, y después asocia cada producto de tu plataforma a un paquete que tu grupo pueda vender. Los precios y el pago se quedan en tu plataforma: el panel no cobra dinero y no tiene pasarela.
Hacer un pedido de prueba
Pide el producto en un entorno de prueba de tu plataforma. El conector llama a create_line con el paquete y un identificador de petición; la línea aparece en Líneas con la duración del paquete como caducidad, y tu plataforma recibe sus credenciales. Una renovación llama a renew_line con su propio identificador de petición, de modo que un reintento tras un error de red nunca se cobra dos veces. La página Clave de API enumera las llamadas recientes con acción, resultado, código de error, dirección y nombre del conector.
Añadir webhooks (opcional)
En la página Clave de API añade un endpoint de webhook (una dirección https de tu plataforma) para los eventos que quieras: line.created, line.renewed, line.enabled, line.disabled, line.deleted, line.expiring, line.expired, credits.low. Cada notificación se firma con el secreto que se muestra una sola vez al crearlo (X-Xtream-Signature) y nunca incluye una contraseña; el botón Probar envía una de inmediato.