Configuración de DonateX

Se instala aparte: este módulo no viene en el instalador de la aplicación. Abre Catálogo de Módulos → Complementos y presiona Instalar en su tarjeta; hasta entonces la aplicación no lo tiene.

Qué es esta página

Conexiones → Monetización → DonateX es donde se le da a DonateX un token de API para que las donaciones lleguen a la aplicación. Aquí hay dos cosas: el interruptor Aceptar donaciones y el token en sí.

Cómo configurarlo

1. Abre Conexiones → Monetización y presiona Conectar DonateX en la tarjeta. En una tarjeta ya conectada, la misma página se abre con Configurar. La flecha en la esquina superior izquierda, Atrás, regresa a la lista.
2. La página tiene el encabezado Configuración de DonateX, con "Configura DonateX para recibir notificaciones de donaciones." debajo.
3. La fila superior es Aceptar donaciones, subtitulada DonateX, con una insignia y un interruptor. El interruptor actúa en el momento en que lo cambias — no espera al botón de guardar. Con él apagado, la insignia dice Desactivado y no se recibe nada.
4. Presiona Abrir el panel de DonateX. Abre donatex.gg en tu navegador habitual. La sugerencia dice dónde buscar: "DonateX emite el token en tu panel, en Configuración → Api."
5. Copia el token de esa página y pégalo en Token de API. El campo oculta lo que escribes; mientras está vacío, solicita "Pega tu token de API de DonateX".
6. Presiona Guardar Configuración en la esquina superior derecha. Informa sobre sí mismo — Guardando…, luego Guardado, o Error si el token no se almacenó. Después de un guardado exitoso, la página se cierra sola y regresa a la lista de servicios.
7. Guardar con el campo vacío y sin token almacenado aún es rechazado con "Por favor, introduce tu token de API de DonateX."
8. Vuelve a abrir la página para verificar. El campo del token está vacío a propósito — un token almacenado nunca se te muestra. Que existe se indica por el mensaje dentro del campo: "Token guardado — déjalo vacío para mantenerlo". Dejar el campo vacío y presionar Guardar Configuración mantiene el token almacenado intacto; para reemplazarlo, escribe el nuevo encima.
9. La insignia junto al interruptor te dice en qué estado está la conexión: No conectado (sin token aún), Desactivado (el interruptor está apagado), Conectando…, Se requiere un nuevo token, Error de conexión, o Conectado como {username}. Se actualiza sola cada pocos segundos mientras la página está abierta.
10. Se requiere un nuevo token significa que el token almacenado ya no funciona. Obtén uno nuevo en el panel de DonateX y guárdalo sobre el anterior.

Un rechazo no se toma como definitivo de inmediato. Si DonateX ya aceptó este token antes, la aplicación responde a un rechazo con una pausa y otro intento: 5 segundos, luego 10, 20 y así sucesivamente, hasta cinco minutos. Se requiere un nuevo token aparece solo después de diez minutos de rechazos, y aun entonces el token se vuelve a probar cada cinco minutos, así que la insignia se restablece sola en cuanto DonateX lo acepta. Si DonateX nunca aceptó el token, la aplicación pide uno nuevo de inmediato.

Qué llega, y qué cuenta como

• Una donación de DonateX llega como un evento de donación ordinario, por lo que las alertas, los objetivos, la subasta y la voz en off la recogen sin necesidad de que se les informe sobre DonateX.
• El monto se convierte a tu moneda base, igual que cualquier otro servicio.
• Una donación enviada desde el panel de DonateX como una Prueba llega como cualquier otra y cuenta para los objetivos y la subasta. Eso es deliberado: una prueba que omitiera los totales no podría usarse para verificarlos. Elimínala de Estadísticas después y su contribución se resta.
• El nombre del donante llega con la donación. Una donación enviada de forma anónima se muestra como anónima.

Qué no puede hacer

• El token no se puede leer desde la aplicación — el campo no muestra nada, y no hay un control para revelarlo.
• No hay inicio de sesión en el navegador aquí: el token se copia manualmente. El botón solo abre el panel de DonateX, no recupera nada.
• El nombre de la cuenta no se escribe. Llega con la conexión, y la insignia lo muestra como Conectado como {username} una vez que el token funciona.
• El interruptor solo gobierna si se aceptan donaciones de DonateX. No es el encendido/apagado del módulo en el catálogo, y no desconecta nada más.
• Desconectar y Eliminar conexión (el icono de la papelera) están en la tarjeta de DonateX bajo Conexiones → Monetización, no en esta página.
• No se muestran donaciones, montos o historial aquí — esta página es solo sobre el acceso.
• Las donaciones que llegaron mientras la aplicación estaba cerrada no se recuperan. La aplicación se pone al día solo por el tiempo que realmente estuvo conectada: si la conexión en vivo estuvo inactiva por un tiempo, lo que se perdió se recupera, pero las horas que la aplicación no estuvo funcionando no se llenan después.