Centro de ayuda
Preguntas y respuestas
Cómo funcionan los créditos, los paquetes, las líneas, los enlaces de reproducción y los dispositivos, y qué revisar cuando algo no se reproduce.
139 de 139 preguntas
Cómo usar esta página
Cada pregunta tiene un código fijo (por ejemploLINE-07). Indícalo al contactar con soporte o copia el enlace a la pregunta.
Los nombres de menús, botones y campos se escriben tal como los muestra el panel. Unusuarioes una cuenta que inicia sesión en el panel (admin, distribuidor); unalíneaes la suscripción IPTV de un espectador. Nunca se mezclan.
- Espectador Un distribuidor puede reenviar esta respuesta tal cual a un espectador
- Admin Para el operador del panel
Visión general del servicio y quién es responsable de qué
GENGEN-01 ¿Qué ofrece este servicio?
Un sistema OTT / IPTV completo: el panel de administración (dashboard), el servidor API para las aplicaciones de los espectadores, la entrega de canales en directo, películas, series y radio, y un reproductor web. Nosotros proporcionamos y mantenemos el sistema; los distribuidores lo usan para dar a sus clientes el derecho a ver contenido (líneas).
GEN-02 ¿Qué no hace el servicio?
- No cobra por ti y no tiene pasarela de pago. El precio para tus clientes, cómo cobras y la facturación son asunto del distribuidor (consultaCON-01).
- No contacta con los espectadores de un distribuidor. El panel solo envía correo a las cuentas del panel, nunca a una línea.
- No conserva datos personales de un cliente eliminado y no tiene función de restauración (consultaDATA-01).
GEN-03 ¿Quién es quién en el sistema?
| Rol | Quién es | Dónde inicia sesión |
|---|---|---|
| Admin | el operador del panel | dashboard |
| Distribuidor | vende líneas; recibe créditos del admin | dashboard, Reseller API |
| Subdistribuidor | un distribuidor creado bajo otro distribuidor | dashboard, Reseller API |
| Línea | un suscriptor: el espectador final | aplicación IPTV, decodificador, reproductor web.Nuncael dashboard |
GEN-04 ¿Qué pasos llevan un canal hasta el espectador?
- El admin crea el catálogo (canales, películas, series, radio) y lo agrupa enbouquets.
- El admin crea unpaquete: bouquets + duración + número de conexiones + precio en créditos.
- Un distribuidor gasta créditos para vender el paquete → el sistema crea unalínea.
- El cliente introduce los datos de la línea en una aplicación; el sistema comprueba la línea (no caducada, activada, dentro de sus límites) y reproduce desde un servidor adecuado.
GEN-05 ¿Qué puede hacer un distribuidor con el contenido y qué no?
Un distribuidor puedeverlas listas de canales, películas, series, radio, bouquets y paquetes (cuando su grupo tiene el permiso), pero no puede añadir, editar ni eliminar contenido. El contenido y los paquetes los gestiona el admin. Un distribuidor decide qué puede ver cada cliente eligiendo el paquete (y los bouquets, cuando el grupo lo permite —PKG-05).
GEN-06 ¿Dónde obtengo soporte?
La entradaSupportde la barra lateral abre el sitio de soporte independiente. El panel no tiene un sistema de tickets propio. Al enviar una solicitud, incluye: el nombre de usuario de la línea (nunca la contraseña), cuándo ocurrió, la aplicación / dispositivo y el código de pregunta de esta página si ya lo probaste.
GEN-07 ¿Qué idiomas tiene la interfaz?
El panel, el reproductor web y esta página de ayuda tienen un selector de idioma con 27 idiomas. El inglés y el vietnamita son las traducciones de referencia; en los demás idiomas una pantalla recién añadida puede quedarse en inglés durante un tiempo. El correo que envía el panel está actualmente solo en inglés.
Cuentas del panel e inicio de sesión
ACCACC-01 ¿Por qué mi cliente no puede iniciar sesión en el dashboard?
Es así por diseño: una línea no es una cuenta del panel. Un cliente solo usa los datos de la línea en una aplicación IPTV, un decodificador o el reproductor web. A la inversa, una cuenta de distribuidor no sirve para ver canales.
ACC-02 Veo menos menús de los que describe esta página. ¿Por qué?
Los menús y las acciones dependen delgrupoque el admin asignó a tu cuenta. Una página para la que tu grupo no tiene permiso no aparece en la barra lateral y no se puede abrir. Pide más permisos al admin.
ACC-03 ¿Dónde cambio mi contraseña del panel?
En el área de la cuenta (perfil → cambiar contraseña). Las contraseñas del panel se guardan con hash; nadie puede leerlas, ni siquiera el admin. Si la olvidas, pide a la cuenta superior (tu distribuidor padre o el admin) que establezca una nueva.
ACC-04 ¿Por qué se cierra mi sesión al cambiar de red?
El panel puede configurarse para terminar una sesión cuando cambia su dirección IP, de modo que una sesión robada no pueda reutilizarse. Vuelve a iniciar sesión. Es un ajuste del admin.
ACC-05 ¿Qué pasa tras varios intentos de inicio de sesión fallidos?
El panel limita los inicios de sesión fallidos (lo configura el admin). Pasado el límite, tienes que esperar antes de volver a intentarlo.
ACC-06 ¿En qué se diferencia una cuenta demo de una real?
Una cuenta demo solo muestra la interfaz: no puede cambiar su contraseña, editar su perfil, crear códigos de activación ni hacer nada que no se pueda deshacer.
ACC-07 Mi cuenta está «desactivada». ¿Qué significa?
La cuenta superior la ha desactivado: no puedes iniciar sesión en el panel y tus claves API se rechazan. Las líneas ya vendidas no se eliminan. Contacta con la cuenta superior.
ACC-08 ¿Dónde reviso lo que hicimos mis subdistribuidores y yo?
Logs → Reseller Logs(cuando el grupo puede ver los logs): cada línea o dispositivo creado, editado, renovado, activado / desactivado o eliminado, cada subdistribuidor creado y cada transferencia de créditos, con los créditos cobrados. Solo ves tus propias entradas y las de las cuentas por debajo de ti; el log no se puede eliminar (solo admin). El libro de créditos (CRD) sigue siendo el lugar para conciliar un saldo.
Créditos
CRDCRD-01 ¿Qué es un crédito?
La unidad de prepago del panel. Cada venta (crear una línea, renovar, crear códigos de activación, crear un subdistribuidor) consume créditos según el precio del paquete o la tarifa del grupo. Un crédito no es dinero y el panel no lo convierte: lo que vale un crédito se acuerda entre tú y la cuenta superior.
CRD-02 ¿Cómo recargo créditos?
Los créditos fluyen de arriba abajo: el admin da créditos a un distribuidor y un distribuidor los transfiere a un subdistribuidor. El pago a la cuenta superior se hace fuera del panel.
CRD-03 ¿Los créditos de quién se cobran?
Siempre los dela cuenta que realiza la acción, incluso cuando la línea se asigna a un subdistribuidor inferior.
CRD-04 ¿Dónde veo mi historial de créditos?
La páginaCredits: una fila por movimiento, con la fecha, el importe, el saldo resultante, el motivo y quién lo hizo. Es el libro de cuentas, la fuente de referencia de tu saldo.
CRD-05 ¿Qué pasa si no tengo suficientes créditos?
Se rechaza toda la acción: no se crea ninguna línea y no se cobra nada. Un saldo nunca queda en negativo.
CRD-06 Si pulso guardar dos veces o se cae la red, ¿se me cobra dos veces?
No. Cada solicitud de venta lleva un identificador de solicitud (request_id); enviar de nuevo el mismo identificador devuelve el resultado anterior. Crear la línea y cobrar los créditos siempre se completan juntos o se cancelan juntos.
CRD-07 ¿Recupero créditos al eliminar una línea?
CRD-08 ¿Puedo recuperar créditos que transferí a un subdistribuidor?
Sí: en el formulario de edición del subdistribuidor, introduce un número negativo en el campo de transferencia de créditos. Ningún saldo puede bajar de 0.
CRD-09 ¿Cómo sé de antemano cuántas líneas puedo comprar?
El selector de paquete del formulario de línea muestra tu propio precio. Por la API, la acciónpricingdevuelve tu saldo, el precio de cada paquete y cuántos puedes permitirte.
Paquetes, bouquets y precios
PKGPKG-01 ¿Cuál es la diferencia entre un bouquet y un paquete?
Unbouquetes una lista de contenido (canales, películas, series). Unpaquetees el producto que vendes: uno o más bouquets, una duración, un número de conexiones, formatos de salida, bloqueos y un precio en créditos (precio oficial y precio de prueba).
PKG-02 ¿Por qué no veo cierto paquete?
Un paquete solo pueden venderlo los grupos que el admin seleccionó para él. Un paquete que no es para tu grupo no aparece en el selector y se rechaza si se envía por la API.
PKG-03 Mi precio difiere del precio del paquete. ¿Por qué?
El admin puede fijar unprecio propiopor distribuidor para cada paquete (0 = gratis). El precio propio se aplica al crear una línea oficial, al renovar y a los códigos de activación oficiales;nose aplica a las pruebas.
PKG-04 Cuando el admin cambia los bouquets de un paquete, ¿cambian también las líneas ya vendidas?
No. Los bouquets secopian en la líneaen el momento de la venta; editar el paquete después no afecta a las líneas ya vendidas. Una línea recibe los nuevos bouquets del paquete en su próxima renovación / cambio de paquete. (Cuando cambia el contenidodentrode un bouquet, todas las líneas que tienen ese bouquet lo ven al instante. Eliminar un bouquet quita su id de todas las líneas y paquetes. Cambiar el orden global de los bouquets solo cambia el orden guardado en las líneas vendidas si marcas la casilla «aplicar a líneas y paquetes vendidos»; el conjunto de bouquets de una línea no cambia.)
PKG-05 ¿Puedo vender solo una parte de un paquete?
Solo cuando tu grupo tiene activadoAllow Bouquet Selection: marcas una parte de los bouquets del paquete; nada marcado = el paquete completo; los bouquets fuera del paquete se descartan. El precio no cambia.
PKG-06 ¿Qué propiedades de una línea decide el paquete?
La fecha de caducidad (hoy + la duración del paquete), el número de conexiones, los formatos de salida, restreamer, bloqueo de dispositivo, país forzado, servidor forzado, bloqueo de ISP y bouquets. Los valores que un distribuidor introduce en estos campos se ignoran, salvo los bouquets (PKG-05) y el bloqueo de ISP cuando el grupo tiene activadoAllow Line Restrictions.
PKG-07 ¿Qué es un paquete «solo MAG» / «solo Enigma»?
Un paquete que solo puede venderse para ese tipo de decodificador; no puede venderse para una línea normal ni para el otro tipo de dispositivo. A la inversa, un paquete debe permitir el tipo de dispositivo antes de poder usarse en el formulario Add MAG / Add Enigma.
Líneas: crear, editar, renovar, eliminar
LINELINE-01 ¿Qué necesito para crear una línea?
Debes elegir un paquete que tu grupo pueda vender y tener suficientes créditos. Usuario / contraseña: escribe los tuyos (cuando el grupo lo permite) o déjalos vacíos para que se generen. Un admin también puede dejar uno de ellos (o ambos) vacío al crear una línea: el sistema genera 10 caracteres y los muestra justo después de guardar; el formulario deediciónsigue necesitando un usuario.
LINE-02 ¿Por qué no puedo elegir yo el usuario / la contraseña?
Tu grupo tiene desactivadoAllow Username Change/Allow Password Change: una línea nueva recibe valores generados. Cuando puedes escribir los tuyos, la longitud mínima la fija el grupo (8 caracteres por defecto).
LINE-03 ¿Dónde puedo volver a ver la contraseña de una línea?
En el formulario de edición de la línea y en el cuadro de diálogoGenerate play linkde la lista Lines. Las contraseñas de las líneas se guardan legibles porque las aplicaciones IPTV y los enlaces de lista las necesitan. Una contraseña generada se muestra justo después de guardar.
LINE-04 Una línea antigua no muestra contraseña y el cliente no puede iniciar sesión, ¿por qué?
Algunas líneas creadas por una versión anterior del panel solo guardan una contraseña con hash. Una línea asíno puede iniciar sesióny el panel no muestra contraseña para ella. Establece una contraseña nueva en el formulario de edición de la línea y envíasela al cliente.
LINE-05 ¿Qué puede editar un distribuidor en una línea tras la venta?
Activar / desactivar, notas del distribuidor, contacto, plantilla de categorías, propietario (dentro de tu propio árbol); usuario y contraseña cuando el grupo lo permite; restricciones (IP, user agents, bloqueo de ISP) cuando el grupo tiene activadoAllow Line Restrictions; una nueva selección de bouquets dentro del paquete cuando el grupo lo permite. El paquete, la fecha de caducidad, el número de conexiones, el indicador de prueba, los formatos de salida, el bloqueo de dispositivo y el paísnose pueden editar directamente: solo cambian mediante una renovación / cambio de paquete.
LINE-06 ¿Cómo renuevo una línea?
Dos formas, una regla:
- el botónRenew (charged)de la lista: usa el paquete actual de la línea;
- el campoExtend with packagedel formulario de edición: elige cualquier paquete que puedas vender (así también secambia de paquete).
Cuando editas una línea y eliges una renovación en el mismo guardado, ambas sonuna sola transacción: si se rechaza la renovación (créditos insuficientes, paquete no vendible), la edicióntampocose guarda y no se cobra ningún crédito. Corrígelo y guarda de nuevo.
LINE-07 ¿Se conserva el tiempo restante al renovar?
- La líneano ha caducadoy el nuevo paquete escompatiblecon el anterior → el tiempo se suma a la fecha de caducidad actual.
- La líneaha caducado, o los dos paquetes no son compatibles → se cuenta desde hoy; el tiempo restante no se conserva.
«Compatible» solo se comprueba cuando el nuevo paquete tiene activada la opción de comprobación de compatibilidad: ambos paquetes deben tener los mismos bouquets, formatos de salida, número de conexiones, indicador de restreamer y bloqueo de dispositivo. Con la opción desactivada siempre se consideran compatibles. Los paquetes nuevos tienen la opción activada por defecto (el admin puede desactivarla); los paquetes existentes mantienen su ajuste. Una línea MAG / Enigma solo puede renovarse con, o cambiarse a, un paquete que permita ese tipo de decodificador.
LINE-08 ¿Cómo se cobra un cambio de paquete (subida / bajada de nivel)?
Un cambio de paquete = comprar un periodo oficial del nuevo paquete: se cobra el precio completo del nuevo paquete (tu precio propio si tienes uno), sin abono por la parte no usada. La línea adopta todas las propiedades del nuevo paquete.
LINE-09 ¿Cuál es la diferencia entre desactivar y eliminar una línea?
Desactivar: el cliente no puede iniciar sesión ni ver contenido, las sesiones en curso se cierran en aproximadamente un minuto; el periodo de suscripción sigue corriendo; puedes volver a activarla en cualquier momento.Eliminar: permanente, sin restauración ni reembolso (DATA-01). Para un cliente que hace una pausa, desactiva; no elimines.
LINE-10 ¿Qué significan los estados de una línea?
| Estado | Significado | Quién puede levantarlo |
|---|---|---|
| Active | utilizable | — |
| Disabled | desactivada por el distribuidor / propietario | distribuidor |
| Banned | bloqueada por el admin | solo admin |
| Expired | pasada su fecha de caducidad | una renovación |
| Trial | una línea de prueba, utilizable hasta que termina el periodo de prueba | pasa a oficial al renovar |
LINE-11 ¿Qué pasa cuando caduca una línea?
Se rechaza al cliente hasta que la línea se renueve (una línea caducada y bloqueada a la vez muestra el clip de «caducada», porque la caducidad se comprueba primero); las sesiones en curso se cierran en aproximadamente un minuto. La líneanose elimina automáticamente: renuévala y vuelve a funcionar con el mismo usuario / contraseña.
LINE-12 ¿Puedo pasar una línea a un subdistribuidor?
Sí: elige como propietario una cuenta por debajo de ti. El propietario ve la línea en su propia lista. Los créditos se siguen cobrando a quien pulsa guardar.
LINE-13 ¿Las líneas de quién veo?
Las tuyas y las de todas las cuentas por debajo de ti. Una línea fuera de tu árbol no existe para ti (la respuesta es «no encontrado»).
LINE-14 ¿Para qué sirven los campos «Contact» y «Reseller notes»?
Para que recuerdes quién es el cliente (correo, número de teléfono, número de pedido). El suscriptor nunca los ve. Se borran definitivamente cuando se elimina la línea.
LINE-15 ¿Puedo ver qué está viendo una línea y desde dónde?
Cuando el grupo tiene el permiso:Logs → Line Activitymuestra el historial de visionado de cada línea yLogs → Live Connectionsmuestra cada conexión abierta de las líneas de tu árbol (qué línea, qué canal, desde qué dirección) con un botón para cerrarla. Live Connections solo se abre cuando el admin activó, para tu grupo, la opción de ver el historial de conexiones de los clientes (la casillaclient connection logsdel formulario del grupo); nunca ves conexiones de una línea fuera de tu árbol.
LINE-16 ¿Por qué la lista Lines no muestra las líneas de los códigos de activación?
LINE-17 ¿La fecha de caducidad del formulario de línea incluye una hora? Admin
Sí. El campoExpires ondel formulario de línea es una fechay horaen la zona horaria del panel, así que una línea puede caducar a una hora concreta. Abrir el formulario y guardar sin tocar este campo conserva la caducidad al segundo: editar una nota o los bouquets no da tiempo extra a una línea de prueba por horas. Un valor que no se puede leer se indica en el propio campo y nunca se convierte en «no caduca». La página de edición masiva sigue admitiendo una fecha, interpretada como el final de ese día.
Pruebas
TRITRI-01 ¿Cuándo puedo crear una línea de prueba?
Cuando se cumplentodasestas condiciones: el admin no ha desactivado las pruebas para los distribuidores; el paquete tiene un periodo de prueba; tu grupo tieneAllowed Trials> 0; tus créditos son ≥ elMinimum Trial Creditsdel grupo; y el número de líneas de prueba que creaste dentro de la ventana de cómputo no ha alcanzado la cuota.
TRI-02 ¿En qué ventana se cuenta la cuota de pruebas?
Según lo configurado en el grupo:día= las últimas 24 horas,mes= los últimos 30 días. Ejemplo, una cuota de 5 / día: como máximo 5 líneas de prueba en cualquier periodo de 24 horas. Una prueba anterior libera su hueco cuando sale de la ventana.
TRI-03 ¿Una prueba cuesta créditos?
Exactamente el precio de prueba del paquete (normalmente 0). El precio propio de un distribuidor no se aplica a las pruebas.
TRI-04 ¿Por qué está bloqueada la casilla de prueba?
TRI-05 ¿Cómo convierto una prueba en una línea oficial?
Renueva la línea con un paquete: la línea recibe un periodo oficial y deja de ser de prueba. El usuario y la contraseña siguen siendo los mismos; el cliente no tiene que configurar nada de nuevo.
TRI-06 ¿Puedo dar otro periodo de prueba a una línea existente?
Enlaces de reproducción, aplicaciones y formatos
PLAYPLAY-01 ¿Dónde obtengo el enlace para mi cliente?
Lines → Generate play link: elige el formato; el enlace se construye con el usuario y la contraseña de la línea. Por la API,get_linedevuelve los enlaces ya hechos:m3u,m3u_hls,xmltv,player_api,web_player.
PLAY-02 ¿Qué aplicaciones puede usar un cliente? Espectador
Cualquier aplicación compatible con laXtream Codes API(IPTV Smarters, TiviMate, XCIPTV, GSE…): introduce la dirección del servidor + usuario + contraseña. Para una aplicación que solo acepta una lista, usa el enlaceM3U. Los decodificadoresMAGusan el portal; losEnigma2usan una lista / plugin. Sin ningún dispositivo, usa elreproductor weben un navegador.
PLAY-03 ¿MPEG-TS o HLS?
MPEG-TS: cambio de canal rápido, apto para aplicaciones IPTV y decodificadores.HLS: funciona bien en navegadores, en dispositivos Apple y en redes inestables. Una línea solo puede usar los formatos que permite su paquete; un enlace en un formato no permitido se rechaza.
PLAY-04 ¿Qué tipos de lista hay?
m3u_plus(con logotipos, grupos, ids de EPG; el valor recomendado por defecto),m3usimple, los tipos para Enigma2 / DreamBox / GigaBlue / Octagon / MediaStar / StarLive y tipos de lista sencillos. Elige uno en el cuadro de diálogo Generate play link.
PLAY-05 ¿De dónde sale la guía de programación (EPG)? Espectador
Las aplicaciones Xtream la obtienen por sí solas. Para una aplicación M3U, usa el enlaceXMLTVde la línea (una listam3u_plusya incluye la dirección del EPG).
PLAY-06 ¿Hay catch-up? Espectador
Sí, en los canales para los que el admin activó el archivo; las aplicaciones muestran un icono de catch-up en esos canales.
PLAY-07 ¿Dónde está el reproductor web y cómo inicio sesión? Espectador
En/player/del servidor API (el enlaceweb_player). Inicia sesión con el usuario / contraseña de la línea o con un código de activación.
PLAY-08 ¿Sigue funcionando un enlace antiguo después de cambiar la contraseña de la línea?
No. La contraseña forma parte del enlace y se guarda en la aplicación; tras un cambio de contraseña el cliente tiene que introducirla de nuevo / obtener un enlace nuevo. Así también se corta a quien usa una línea sin permiso.
PLAY-09 ¿Puedo usar mi propio dominio para los enlaces de reproducción?
Sí: estableceYour own play addressen la página de la clave API (o con la acción de APIset_play_base). Apuntas el DNS del dominio al servidor API del panelyel operador tiene que configurar su parte; avisa al admin antes de usarlo. La dirección se aplica a los enlaces que la API devuelve a tu sistema.
Decodificadores MAG / Enigma2
DEVDEV-01 ¿Cómo añado un decodificador MAG / Enigma?
Devices → Add MAG / Add Enigma: introduce la MAC y elige un paquete. El sistema vende una línea nueva y asocia el dispositivo en un solo paso; el dispositivo inicia sesión con su MAC, nadie tiene que escribir usuario / contraseña. Los créditos se cobran exactamente igual que para una línea normal.
DEV-02 ¿El cliente ya tiene una línea y quiere añadir un decodificador?
En el formulario del dispositivo, elige lalínea existentedel cliente en lugar de un paquete: el dispositivo seemparejacon esa línea, sin coste. El cliente sigue usando la línea en la aplicación; el decodificador sigue el paquete, la caducidad, los bouquets y el estado de la línea.
DEV-03 ¿Cómo se cuentan las conexiones de una aplicación y un decodificador emparejados?
Compartenel límite de conexiones: la aplicación y el decodificador son un solo suscriptor.
DEV-04 ¿Cómo renuevo un decodificador?
Renueva su línea (el enlace está en el formulario del dispositivo). Para un dispositivo emparejado, renueva la línea del cliente: el decodificador la sigue por sí solo.
DEV-05 ¿El cliente sustituye el decodificador por uno nuevo?
Edita la MAC del dispositivo. Si la línea tiene activado el bloqueo de dispositivo, borra el número de serie / id de dispositivo registrado para que el nuevo decodificador pueda registrarse.
DEV-06 ¿Eliminar un dispositivo elimina la línea?
Sí. Eliminar un dispositivo elimina también su línea (con su historial de conexiones y eventos pendientes), como en el panel antiguo. Para conservar una línea que se pagó, usa el botónConvert to line: el dispositivo se elimina y la línea pasa a ser una línea normal. Cuando eliminas la línea de un cliente, un dispositivo emparejado sigue existiendo de forma independiente con una línea propia.
DEV-07 ¿Puede un distribuidor controlar un decodificador de forma remota?
Sus propios decodificadoresMAG, sí: enviar un mensaje a la TV, reproducir un canal, recargar el portal, reiniciar, cerrar las conexiones de la línea (el grupo necesita el permiso para ver los logs de conexión de los clientes), restablecer el ISP registrado y restablecer el bloqueo de STB. Los comandos X-Plugin y las capturas de pantalla de los decodificadoresEnigma, el baneo de un dispositivo y el traslado de un dispositivo a otra línea son solo para el admin. Activar / desactivar el dispositivo de un distribuidor activa / desactiva su línea; un distribuidor no puede levantar el estadoBannedde un dispositivo.
Códigos de activación
CODECODE-01 ¿Para qué sirve un código de activación?
Vender acceso como un código (una tarjeta rascable, un código enviado por mensaje): el cliente introduce el código en una aplicación o en el reproductor web y puede ver contenido, sin usuario / contraseña. El periodosolo empieza cuando el cliente activa el código por primera vez.
CODE-02 ¿Cómo creo códigos y cuánto cuestan?
Active Codes → New: elige el paquete, la cantidad (1–500 por lote), la longitud del código (6–24), la opción de solo dígitos (fácil de escribir con un mando de TV) y la opción de prueba. Los créditos se cobranal crearlos= precio del paquete × número de códigos. Cada código viene con una línea propia, bloqueada hasta la activación.
CODE-03 ¿Qué caracteres contiene un código?
Letras mayúsculas y dígitos sin los que se confunden fácilmente (0, O, 1, I); o solo dígitos. Si un cliente escribe en minúsculas, se acepta igualmente.
CODE-04 ¿En cuántos dispositivos se puede usar un código? Espectador
En uno. El código queda ligado al primer dispositivo que lo activa; si otro dispositivo introduce el mismo código, se rechaza. Ese dispositivo puede introducir el código tantas veces como quiera; los datos de inicio de sesión de la línea no cambian.
CODE-05 ¿Y si el cliente cambia de dispositivo?
Reset deviceen ese código; el nuevo dispositivo podrá activarlo. No se añade tiempo al periodo.
CODE-06 Al introducir el código, el cliente recibe un error. ¿Qué significa? Espectador
| Mensaje | Significado | Qué hacer |
|---|---|---|
INVALID_CODE | código incorrecto / el código no existe | revisa cada carácter; no escribas los guiones |
DEVICE_MISMATCH | el código está ligado a otro dispositivo | el distribuidor restablece el dispositivo (CODE-05) |
DISABLED | el código está desactivado | el distribuidor lo activa de nuevo |
EXPIRED | el periodo ha terminado | comprar un código / ampliar |
Introducir varios códigos incorrectos distintos seguidos provoca que la dirección IP se bloquee durante un tiempo (SEC-08).
CODE-07 ¿Cómo amplío un código que ya se activó?
En la páginaActive Codes, marca el código, elige la acciónExtend (days)e introduce el número de días. Solo un códigoactivadorecibe días (un código sin usar aún no ha empezado su periodo); un código aún válido se amplía desde su fecha de caducidad actual y uno caducado desde ahora. Esta acción no cobra créditos. Por la API:extend_active_code.
CODE-08 ¿Recupero créditos al eliminar un código?
Un códigosin usarcreado por el distribuidor: se reembolsa por completo, con una fila en el libro de créditos. Un códigoactivado: sin reembolso.
CODE-09 ¿Cómo gestiono muchos códigos a la vez?
La páginaBatchesmuestra total / listos / activados / desactivados de cada lote y exporta un archivo TXT (un código por línea). Acciones masivas: activar, desactivar, restablecer dispositivo, eliminar.
CODE-10 ¿La línea de un código de activación sigue los límites del paquete?
Sí, como toda línea vendida con ese paquete: número de conexiones, formatos de salida, bouquets, bloqueo de dispositivo, restreamer y también elpaís forzadodel paquete (SEC-07). Un cliente que activa un código desde un país fuera de la lista permitida puede activarlo, pero se le rechaza al reproducir.
Límites de conexión y bloqueos que protegen una línea
SECSEC-01 ¿Cómo se cuenta «Max connections»?
Es el número de dispositivos que ven contenidoal mismo tiempocon una línea. 0 = ilimitado. Volver a abrir el canal que ya estás viendo desde el mismo dispositivo no cuenta como otra conexión.
SEC-02 ¿A quién se desconecta cuando se supera el límite? Espectador
Por defecto: la conexiónnuevaentra y se cierra lamás antigua(con preferencia por una conexión del mismo dispositivo y luego de la misma IP). El reproductor cerrado se detiene en unos 30 segundos. El admin puede cambiar arechazar la conexión nuevaen lugar de cerrar una antigua.
SEC-03 ¿Qué es la regla de la «segunda IP»?
Cuando el admin la tiene activada: mientras una línea se está viendo desde una IP, se rechaza una conexión en directo desde otra IP. La regla puede limitarse a líneas con pocas conexiones (por ejemplo líneas con 1 conexión; una línea con conexiones ilimitadas solo queda ligada cuando el umbral es 0). ConMatch The Address By Networkactivado, las direcciones de la misma red /24 (IPv6: /64) cuentan como un solo espectador. Es una herramienta contra el uso compartido de cuentas.
SEC-04 ¿Puedo restringir una línea a ciertas IP o aplicaciones?
Cuando el grupo tiene activadoAllow Line Restrictions: el campoAllowed IPs(una IP, un rango CIDR o un nombre de dominio, uno por línea; un dominio se resuelve en el momento de la conexión, así que una IP dinámica sigue funcionando) yAllowed User-Agents. Vacío = todo permitido. Nota: estas restricciones bloquean en lareproducción; la aplicación sigue iniciando sesión y mostrando la lista de canales.
SEC-05 ¿Qué es el bloqueo de ISP?
La línea recuerda el proveedor de internet de su primera conexión y rechaza el uso desde otro proveedor. Cuando el cliente cambia de proveedor, desactiva y vuelve a activar el bloqueo de ISP para registrar el nuevo. No se aplica a los decodificadores MAG.
SEC-06 ¿Qué es el bloqueo de dispositivo?
Liga la línea al primer decodificador que inicia sesión (número de serie, id de dispositivo); otro decodificador se rechaza. Lo decide el paquete.
SEC-07 ¿Cómo funciona la restricción de país?
Una línea solo puede conectarse desde su país forzado (ALL= desde cualquier sitio). Cuando está vacío, se aplica la lista general de países permitidos del panel. Un cliente que viaja al extranjero o usa una VPN puede ser rechazado por este motivo.
SEC-08 ¿Por qué está bloqueada una dirección IP? Espectador
- Automáticamente: inicios de sesión fallidos desde una IP con muchos usuarios / códigos de activación distintos en poco tiempo, o una avalancha de solicitudes. Un bloqueo automático se levanta solo tras el tiempo que configuró el admin (60 minutos por defecto).
- Manualmente: el admin bloqueó la IP / el rango de IP; este no caduca.
Mientras una IP está bloqueada,ningunalínea puede conectarse desde ella. Equivocarse repetidamente al escribir el mismo usuario no provoca un bloqueo.
SEC-09 ¿Por qué otros motivos se puede bloquear una conexión?
El admin puede bloquear porUser-Agent(aplicación), porproveedor de internet (ISP)y porASN(por ejemplo rangos de hosting / VPN). Una línea para la que el admin activó «bypass UA» se salta la lista de bloqueo de aplicaciones.
SEC-10 ¿Qué es un restreamer?
Una línea para un socio que toma los streams para redistribuirlos. Está exenta del límite de conexiones, de la regla de la segunda IP, del fin automático de sesiones largas y del bloqueo por ASN. Lo decide el paquete / el admin; no está pensada para espectadores normales.
SEC-11 ¿Se corta una sesión continua muy larga? Espectador
El admin puede fijar una duración máxima para una sesión continua; pasado ese tiempo la sesión se cierra y el cliente pulsa reproducir para continuar. Una sesión que pierde la señal durante unos 90 segundos también cuenta como cerrada.
SEC-12 ¿Cómo detecto una línea compartida o robada?
- La páginaTheft Detection(cuando el grupo tiene el permiso): ordena las líneas por el número de películas / episodiosdistintosvistos en 1 hora / 24 horas / 7 días, con el número de IP distintas; una línea con cifras inusualmente altas es sospechosa.
- La página de actividad de la línea: muestra las IP y los dispositivos en uso.
- Qué hacer: cambia la contraseña de la línea (PLAY-08), activa la restricción de IP / el bloqueo de ISP o desactiva la línea.
Subdistribuidores
SUBSUB-01 ¿Puedo crear subdistribuidores?
Cuando tu grupo tiene activadoCan Create Sub-Resellersy al menos un grupo enGroups for sub-resellers. Cada creación cobra la tarifa de creación (créditos) fijada en el grupo. Un árbol de distribuidores tiene como máximo 5 niveles de profundidad.
SUB-02 ¿A qué grupo pertenece un subdistribuidor y qué puede hacer?
Eliges un grupo de la lista que permite el admin; ese grupo decide los permisos, los paquetes vendibles y la cuota de pruebas del subdistribuidor.
SUB-03 ¿Qué puedo gestionar de un subdistribuidor?
Correo, nombre, contraseña, estado, grupo (de la lista), notas, transferir / recuperar créditos y todas las líneas por debajo de él. No puedes cambiar su rol ni su propietario.
SUB-04 ¿Qué ve un subdistribuidor de lo mío?
Nada: cada cuenta solo ve lo que tiene por debajo, nunca los niveles superiores ni otras ramas.
SUB-05 ¿A dónde van las líneas y los créditos de un subdistribuidor cuando lo elimino?
El grupo necesitaCan Delete Usersactivado. Los créditos restantes, las líneas y las cuentas hijas pasan ala cuenta que elimina. Las líneas de los clientes siguen funcionando. Los datos personales de la cuenta eliminada (usuario, correo, nombre, contraseña, claves API, notas) se borran; ese usuario y ese correo pueden volver a usarse.
SUB-06 ¿Un subdistribuidor nuevo recibe un correo?
Cuando el admin activó el correo de bienvenida: la cuenta nueva recibe su nombre de inicio de sesión y un enlace de acceso. El correonuncacontiene la contraseña: se la envías tú mismo.
Plantillas de categorías
CATCAT-01 ¿Para qué sirve una plantilla de categorías?
Para reordenar, renombrar u ocultar las categorías (directo, películas, series, radio) que un cliente ve en la aplicación, por línea y sin tocar las categorías propias del panel.
CAT-02 ¿Qué pasa cuando oculto una categoría?
Todo el contenido de esa categoría también se oculta de la aplicación y de la lista de las líneas que usan la plantilla.
CAT-03 Cuando edito una plantilla, ¿cambian las líneas que la usan?
Sí, al instante para todas las líneas a las que está asignada la plantilla. Cuando se elimina una plantilla, sus líneas vuelven a la disposición por defecto.
CAT-04 ¿Qué plantillas puedo ver y editar?
Ver: las tuyas y las de las cuentas por debajo de ti, las plantillas del sistema y las compartidas por los niveles superiores. Editar: solo las tuyas y las de los niveles inferiores. Para ajustar una plantilla del sistema,duplícalay edita la copia.
CAT-05 ¿Límites que conviene conocer?
El orden personalizado de categorías no se aplica a la parte de películas / series de una lista M3U (los nombres y el ocultado sí se aplican). Las aplicaciones que usan la Xtream API lo reciben todo.
Reseller API, claves API, webhooks
APIAPI-01 ¿Para qué sirve la Reseller API?
Para que tu propio sistema (tienda web, facturación, bot) venda y gestione líneas / subdistribuidores sin abrir el dashboard. Dirección:{API}/reseller/v1, autenticada con la cabeceraX-API-Key. La documentación completa está en/docs/del servidor API.
API-02 ¿Dónde obtengo una clave API?
La páginaAPI Key. Una clave se muestrauna sola vez, al crearla: cópiala enseguida. Si la pierdes, crea una clave nueva (la anterior deja de funcionar).
API-03 ¿Debo usar una clave para todos los sistemas?
Mejor no. Crea unaclave adicionalpor sistema: ponle un nombre, limita las IP / CIDR que pueden usarla, hazla opcionalmente desolo lectura(solo listar y ver) y revócala por separado sin afectar a las demás.
API-04 ¿Qué puede hacer la API?
| Necesidad | Acción |
|---|---|
| Saldo, precios, cuántos puedes permitirte, reglas de usuario / prueba | user_info,pricing,packages |
| Líneas | get_lines,get_line,create_line,renew_line,change_package,edit_line,enable_line,disable_line,delete_line |
| Subdistribuidores | get_users,get_user,create_user,edit_user,adjust_credits,enable_user,disable_user,delete_user |
| Códigos de activación | crear, listar, activar / desactivar, restablecer dispositivo, eliminar |
| Webhooks, dirección de reproducción propia, log de llamadas API | create_webhook…,set_play_base,api_logs |
Cada regla del dashboard (grupo, precio propio, cuota de pruebas, alcance del árbol) se aplica por la API exactamente igual.
API-05 Si reintento tras un error de red, ¿se me cobra dos veces?
No, siempre que envíes el mismorequest_idpara la misma transacción: el sistema devuelve el resultado anterior. Elrequest_idde una renovación quedaligado a esa línea: reutilizarlo para otra línea devuelve un error de conflicto (HTTP 409) y la otra línea no cambia; genera unrequest_idnuevo para cada transacción.
API-06 Mi integración no funciona. ¿Cómo lo compruebo yo mismo?
La página API Key tiene una tabla dellamadas API recientes(30 días): acción, resultado, código de error, dirección de origen, nombre del conector. Los parámetros nunca se registran.
API-07 ¿Qué es un webhook y qué eventos existen?
El panel avisa a tu sistema cuando ocurre algo, para que no tengas que preguntar continuamente. Eventos:line.created,line.renewed,line.enabled,line.disabled,line.deleted,line.expiring(3 días antes),line.expired,credits.low(por debajo del umbral que fijes). La dirección receptora debe ser https y accesible desde internet.
API-08 ¿Cómo sé que un webhook es genuino?
Cada notificación lleva la firmaX-Xtream-Signature: sha256=HMAC(secret, timestamp.body); el secreto se muestra una sola vez, al crear el endpoint. Un webhook nunca contiene una contraseña.
API-09 ¿El webhook dejó de enviar?
Cada notificación se intenta 3 veces; un endpoint que falla 20 entregas seguidas se desactiva. Corrige tu lado, usaSend testy vuelve a crear el endpoint si se desactivó.
API-10 ¿La API devuelve las contraseñas de las líneas?
Sí, pero solo al propietario de la línea (tú y los niveles por encima de ti en el árbol). No guardes contraseñas de líneas en logs ni las envíes por un canal inseguro.
API-11 ¿Puede `edit_line` renovar una línea?
Sí, cuando envíaspackage_idcon ella (el nombre antiguopackagetambién se acepta): además de la edición, la acción vende un periodo oficial de ese paquete exactamente comochange_package: mismo precio, mismorequest_id, y la respuesta incluyecredits_charged. La edición y la renovación son una sola transacción: cuando se rechaza (créditos insuficientes, paquete no válido,trialenviado a la vez) no cambia nada.edit_linesinpaquete solo edita usuario, contraseña, contacto y notas y no toca el paquete ni la caducidad.
API-12 ¿Un script escrito para el panel antiguo (PHP) funciona con esta API?
No tal cual. La API mantiene los nombres de acción familiares pero es una interfaz nueva: la dirección/reseller/v1, una clave API creada en este panel, acciones de escritura enviadas con POST, errores devueltos como estado HTTP con un campoerror, y el resultado de crear una línea endata.line. Usa la documentación en/docs/o un conector ya hecho (CON-02).
Conectores para sistemas de tienda / facturación
CONCON-01 ¿Cómo cobro a mis clientes?
Contu propiosistema y pasarela de pago. El panel no procesa pagos. Un conector enlaza el sistema de tu tienda con el panel: el cliente paga en tu lado → el conector llama a la Reseller API para crear / renovar la línea.
CON-02 ¿Para qué plataformas hay conector?
WHMCS, Blesta, WISECP, HostBill, ClientExec, FOSSBilling, Paymenter, WordPress (WooCommerce / Easy Digital Downloads), Odoo, PrestaShop, OpenCart, Magento, Dolibarr, ERPNext y un «webhook bridge» para Shopify, Upmind e Invoice Ninja.
CON-03 ¿Dónde descargo e instalo uno?
Barra lateralResources → All Connectors: cada conector tiene una descripción, los datos de conexión, los pasos de instalación, un botónDownloady el SHA-256 del archivo para verificarlo.
CON-04 ¿Hasta qué punto se han probado los conectores?
Depende de cada conector, y la página de cada uno lo indica: algunos se ejecutaron dentro de la plataforma real (por ejemplo WordPress + WooCommerce, Odoo, FOSSBilling, Paymenter), otros solo ejercitaron su núcleo. Lee la línea «cómo se probó» y pruébalo en un entorno de pruebas antes de vender de verdad.
CON-05 ¿Es seguro un conector y qué le hace al panel?
CON-06 ¿Qué puede vender un conector?
Líneas (crear, renovar, cambiar de paquete, suspender, eliminar) y cuentas de subdistribuidor con créditos.
Datos, eliminación y privacidad
DATADATA-01 ¿Se puede restaurar una línea eliminada?
No. Eliminado es eliminado: los datos de la línea (usuario, contraseña, contacto, notas), su historial de conexiones (IP, dispositivos, lo que se vio), los decodificadores asociados a la línea y su código de activación. No hay papelera ni función o API de restauración. Cuando el cliente vuelva, crea una línea nueva.
DATA-02 ¿Qué conserva el sistema tras una eliminación?
Solo un registro estadísticoanónimopara el operador (cliente nuevo o recurrente, qué paquetes son populares). No contiene nada legible sobre el cliente y ningún distribuidor, conector ni API puede acceder a él.
DATA-03 ¿Puede una copia de seguridad recuperar una línea eliminada?
No. Las copias de seguridad de la base de datos solo existen para reconstruir el sistema tras un incidente y las conserva el operador; no se usan para deshacer una eliminación. Las copias antiguas se van rotando, así que los datos eliminados también desaparecen de ellas.
DATA-04 ¿Por qué la contraseña de una línea es legible y la de una cuenta del panel no?
La contraseña de una línea hay que escribirla en las aplicaciones y forma parte del enlace de la lista, así que el panel la mantiene legible para el propietario de la línea. Las contraseñas de las cuentas del panel solo se guardan con hash.
DATA-05 ¿Quién puede ver mis líneas y clientes?
Tú, las cuentas por encima de ti en tu árbol y el admin. Otros distribuidores y los niveles por debajo de ti no.
DATA-06 ¿El panel envía correos / mensajes a mis clientes?
Nunca. Los clientes de una línea pertenecen al distribuidor; los contactas a través de tu propio sistema.
DATA-07 ¿Me avisan antes de que caduque una línea?
De dos maneras: un correo diario de resumen con las líneas a punto de caducar (cuando el admin lo activó; 3 días antes por defecto) y los webhooksline.expiring/line.expiredpara tu sistema.
Resolución de problemas
FIXRevisa de arriba abajo. La mayoría de los problemas de «no puedo ver» están en las 5 primeras filas.
FIX-01 El cliente no puede iniciar sesión / no puede ver contenido Espectador
| # | Comprobar | Señal | Qué hacer |
|---|---|---|---|
| 1 | Usuario / contraseña | la aplicación indica datos incorrectos | compáralos con el formulario de la línea (distingue mayúsculas, sin espacios); vuelve a enviar el enlace deGenerate play link |
| 2 | Caducidad | la aplicación indicaExpired | renueva (LINE-06) |
| 3 | Estado | Disabled/Banned | actívala de nuevo; paraBannedcontacta con el admin |
| 4 | Dirección del servidor | no se puede conectar | usa la dirección y el puerto exactos del enlace de reproducción, y elhttp/httpscorrecto |
| 5 | Número de conexiones | lo expulsan cuando otra persona empieza a ver | SEC-01,SEC-02 |
| 6 | IP bloqueada | ninguna línea puede entrar desde esa red | SEC-08: espera a que se levante el bloqueo o pide al admin que lo levante |
| 7 | Bloqueo de ISP / país / Allowed IPs | falla solo tras cambiar de red, con datos móviles, con una VPN o al viajar | SEC-04,SEC-05,SEC-07 |
| 8 | Formato | se rechaza el enlace HLS / TS | usa un formato que permita el paquete (PLAY-03) |
| 9 | Aplicación bloqueada | falla solo en una aplicación | prueba otra aplicación;SEC-09 |
FIX-02 El inicio de sesión funciona y se ve la lista, pero un canal no se reproduce Espectador
Normalmente es uno de los bloqueos de reproducción (filas 5–9 deFIX-01): el inicio de sesión y la lista de canales no comprueban la IP / aplicación, solo la reproducción. Si falla solouncanal en todas las líneas → el canal de origen tiene un problema; indica al admin el nombre del canal y la hora.
FIX-03 Faltan canales o grupos de canales Espectador
Revisa los bouquets de la línea (PKG-04,PKG-05) y la plantilla de categorías asignada (CAT-02). Tras un cambio, pide al cliente que recargue la lista en la aplicación. Un canal que el admin acaba de añadir aparece tras unos treinta segundos; si un canal está en el bouquet y ninguna línea lo ve, puede que el admin lo haya retirado del aire.
FIX-04 Cortes, imagen congelada Espectador
Prueba por orden: otro canal (¿un canal o todos?) → otra red → otro formato (HLS en lugar de MPEG-TS) → otra aplicación. Si todos los canales fallan en todas las redes → indica a soporte el usuario, la hora y el canal.
FIX-05 Sin guía de programación (EPG) Espectador
FIX-06 No puedo crear una línea
FIX-07 Al descargar una lista aparece el error 429 o una página 404
FIX-08 No puedo abrir una página del dashboard
FIX-09 No recibo correos del panel
El correo solo se envía cuando el admin configuró un servidor de correo y activó ese tipo de mensaje; la cuenta debe tener una dirección de correo real. Revisa la carpeta de spam.
Glosario
- Línea
- la suscripción IPTV de un espectador: usuario, contraseña, caducidad, bouquets, límites
- Usuario
- una cuenta que inicia sesión en el panel: admin, distribuidor, subdistribuidor
- Grupo
- el grupo de permisos de una cuenta del panel; decide los menús, los paquetes vendibles, las reglas de línea y las pruebas
- Bouquet
- una lista de contenido (canales, películas, series)
- Paquete
- el producto que se vende: bouquets + duración + límites + precio en créditos
- Crédito
- la unidad de prepago que se usa para comprar paquetes
- Prueba
- el periodo de prueba de un paquete
- Código de activación
- un código con el que un cliente activa por sí mismo una línea de pago
- MAG / Enigma2
- dos familias de decodificadores; inician sesión por dirección MAC
- Xtream Codes API
- el protocolo que usan la mayoría de las aplicaciones IPTV (servidor + usuario + contraseña)
- M3U / XMLTV
- formatos de archivo de una lista de reproducción / una guía de programación
- MPEG-TS / HLS
- dos formatos de stream
- EPG
- la guía de programación
- Catch-up
- ver un programa después de su emisión
- Restreamer
- una línea para un socio que toma streams para redistribuirlos
- Conector
- software que enlaza el sistema de tienda de un distribuidor con el panel
- Webhook
- una notificación que el panel envía al sistema de un distribuidor cuando ocurre algo
Ninguna pregunta coincide
Prueba con otra palabra clave o un código de pregunta, o borra el filtro.
¿Sigues atascado?
Envía el nombre de usuario de la línea (nunca su contraseña), cuándo ocurrió, la aplicación o el dispositivo y el código de la pregunta que ya probaste.