Checkout para Moodle

Manual de usuario · versión 1.3.1 · complementos local_tiendacursos y block_tiendacursos (Moodle 4.5 LTS y 5.x).

La tienda permite vender los cursos del aula directamente en Moodle: el visitante elige un curso, paga con Webpay/Khipu/Mach (Flow), Mercado Pago o transferencia, y recibe por correo su usuario y una contraseña temporal. No necesita tener cuenta antes de comprar. Una empresa puede inscribir a varios trabajadores en un solo pago, con descuento por cantidad.

1. Instalación y activación

1. En Administración del sitio › Extensiones › Instalar complementos, sube primero local_tiendacursos-1.2.0.zip y luego (opcional) block_tiendacursos-1.2.0.zip.
2. La tienda funciona de inmediato en su versión gratuita (sección 2). Si compraste una licencia, abre Checkout para Moodle › Licencia en el menú principal y pega el código de activación que te entregó Norteduc (empieza con RA1.). El código vale para un solo dominio; se activa una vez en línea.
3. Comprueba que el cron de Moodle se ejecute al menos cada 5 minutos: las tareas de la tienda lo necesitan (revisar pagos pendientes cada 15 minutos, reintentar correos cada 10 y buscar nuevas versiones una vez al día).

2. Versión gratuita y licencia

Sin código de activación la tienda nunca queda cerrada: funciona en la versión gratuita. Una licencia anual o perpetua habilita todo.

Las funciones de pago se ven en el panel con un candado y el botón «Comprar licencia», que abre la tienda de Norteduc.

Licencia anual: vencimiento sin perder datos

• 30 días antes del vencimiento el panel avisa «La licencia anual de Checkout vence en N días…» con el botón «Renovar licencia».
• Además, la administración del sitio recibe un correo 30, 15, 3 y 1 día antes del vencimiento (una vez cada uno, desde la dirección «no responder» y con el nombre del aula), con la fecha, los días que faltan, qué pasa al vencer, «Renovar licencia» y el enlace al panel.
• Al vencer hay 15 días de gracia con todas las funciones.
• Después la tienda vuelve a la versión gratuita sin borrar nada: los cupones, tramos, packs y usuarios del panel quedan guardados pero inactivos (el pago no aplica cupones ni tramos, y solo se ofrece el primer medio de pago activo). Al renovar, todo vuelve a funcionar igual que antes.
• Para renovar se pega el código nuevo en «Licencia»; no hace falta reactivar.

La licencia perpetua no vence e incluye las actualizaciones para siempre; la anual, mientras esté vigente.

3. El panel de la tienda

El administrador entra desde «Checkout para Moodle» en el menú principal (con el número de transferencias por confirmar). Esa entrada la ven solo las personas con acceso al panel. El panel tiene el mismo formato que el de Registro de avances: menú lateral, indicadores, tablas que se ordenan haciendo clic en sus títulos y se filtran con «Buscar», y en el pie el plan vigente y «Contactar a soporte».

4. Usuarios del panel y permisos

Con licencia, el administrador puede dar acceso al panel a otras personas (ventas, contabilidad, coordinación) desde Usuarios del panel › Agregar usuario: busca la cuenta de Moodle por nombre, correo o usuario y elige, sección por sección, «Editar», «Solo lectura» o «Sin acceso». Nada se concede por defecto: una persona nueva parte con solo lectura en Ventas, Cursos, Packs, Cupones, Compras grupales y Plantillas de correo, y sin acceso a Pasarelas, Correo, Sitios externos y Configuración.

• Con «Solo lectura» la persona ve la sección pero no los botones de cambio; el servidor además rechaza cualquier cambio.
• Las claves de las pasarelas y la contraseña SMTP nunca se muestran: ni siquiera a quien puede editarlas («Guardada · déjala vacía para mantenerla»).
• Descargar el Excel de ventas requiere al menos «Solo lectura» en Ventas (contiene datos personales).
• Los roles y capacidades de Moodle (por ejemplo, gestor) no dan acceso al panel: solo esta lista.
• En la versión gratuita los usuarios del panel quedan guardados pero no pueden entrar.

5. Configuración

Los ajustes se reparten en tres secciones del panel: Pasarelas de pago (sección 16), Correo (sección 14) y Configuración; los de compras grupales están en Compras grupales.

6. Poner cursos a la venta

En Cursos a la venta aparece cada curso del aula. Con «Editar» defines la oferta:

• Precio en pesos (sin decimales) y precio normal opcional, que se muestra tachado.
• Horas (informativas) y días de acceso: al pagar, la matrícula termina hoy + esos días.
• Visible en la tienda y Destacado (los destacados salen primero y con una marca).
• Orden dentro de la vitrina.

7. Packs de cursos

Un pack vende varios cursos juntos por un solo precio. En Packs › Nuevo pack defines:

• Nombre, descripción e imagen de la tarjeta (16:9; sin imagen se usa la del primer curso).
• Cursos incluidos (2 o más): los que ya están a la venta (muestran su precio) o cualquier curso visible.
• Precio normal: es la suma automática de los precios de los cursos; si cambias el precio de un curso, el del pack se actualiza solo.
• Precio de oferta (menor que el normal) y, opcional, oferta válida hasta: después de esa fecha se cobra el precio normal. Sin oferta se cobra la suma.
• Días de acceso a todos los cursos, Destacado, Activo y orden.

En la vitrina, la portada y el bloque de catálogo el pack sale primero, con su tarjeta propia: etiqueta «Pack», «N cursos», precio normal tachado, «Ahorras $X» y la lista desplegable de cursos.

• Se compra individual o grupal: usa los tramos generales de Compras grupales.
• Cupones: un cupón «para todos los cursos» descuenta sobre el precio del pack, con la misma regla de combinación con el descuento grupal; un cupón de un curso no aplica a packs.
• Al pagar, cada estudiante queda matriculado en todos los cursos con la misma fecha de término y recibe un solo correo de bienvenida con la lista de cursos. Si ya tenía acceso vigente a alguno, se conserva y se extiende hasta la fecha del pack si terminaba antes (nunca se acorta). Si tenía acceso a todos, no puede comprarlo.
• Renovación: cuando el acceso del pack vence, la tarjeta muestra «Renovar acceso» y el pago renueva todos los cursos.
• En Ventas y en el Excel el pedido aparece como pack con sus cursos; puedes filtrar por pack, y el filtro por curso incluye los packs que lo contienen.
• Un pack con ventas no se borra: queda inactivo para conservar el historial.

8. Cupones

Un cupón puede ser un porcentaje o un monto fijo, para todos los cursos o uno solo, con fecha de vencimiento y cantidad máxima de usos. Un uso se cuenta solo cuando el pedido queda pagado. Un cupón de 100 % deja el pedido en $0 y la matrícula se hace de inmediato, sin pasar por la pasarela.

9. Compras grupales y descuentos por cantidad

Los tramos aplican un descuento automático según la cantidad de estudiantes de un pedido. Ejemplo: 2 → 5 %, 3 a 5 → 10 %, 6 a 10 → 15 %, 11 o más → 20 %. Los tramos no se pueden superponer y solo el último puede quedar abierto («o más»). Un curso puede tener tramos propios: en ese caso usa solo los suyos y no los generales.

En el resumen de compra el cliente ve el descuento aplicado y un aviso del siguiente tramo («Inscribiendo 6 o más estudiantes obtienes 15 % de descuento»). Si además usa un cupón y la combinación es «no acumulables», se aplica el mayor y se le explica.

10. Vitrina, bloque, portada y menú

La vitrina (/local/tiendacursos/index.php) lista los cursos a la venta en tarjetas con portada, categoría, horas, días de acceso, precio y botón Comprar, con filtro por categoría. Se adapta al teléfono.

Si quien mira ya tiene el curso, la tarjeta cambia:

• Matriculado → botón «Ir al curso».
• Acceso vencido → botón «Renovar acceso».
• Acceso suspendido por un administrador → no se puede comprar; debe contactar a la administración.

Bloque «Catálogo de cursos»

Se agrega en la portada, el Área personal o un curso (modo edición › Agregar un bloque). Cada bloque se configura por separado: título, cantidad de cursos, categorías, solo destacados, orden (destacados, recientes, precio o nombre), formato tarjetas o lista, y botón «Ver todos los cursos».

Catálogo en la portada

Con temas como Boost, la portada del sitio solo admite bloques en el panel lateral. Para mostrar tarjetas en el centro de la portada activa Configuración › Catálogo en la portada (título, cantidad y solo destacados).

11. Cómo compra el cliente

El comprador no necesita cuenta. Completa sus datos (nombres, apellidos, RUT validado con dígito verificador, correo, teléfono y empresa opcional), los estudiantes, el medio de pago y acepta los términos.

Compra grupal

• Indica la cantidad de estudiantes y presiona «Actualizar»: aparece una ficha por estudiante.
• Desmarca «Yo también participo» si quien paga no hace el curso (por ejemplo, RR. HH. de la empresa).
• La empresa del comprador se hereda a cada estudiante y se puede cambiar por fila.
• No se permite el mismo RUT ni el mismo correo dos veces en el pedido.

Después de pagar

• Cada estudiante nuevo recibe su usuario (RUT sin puntos) y una contraseña temporal; al entrar debe cambiarla.
• Si el RUT ya tenía cuenta en el aula, se usa esa cuenta y conserva su contraseña; el correo se lo recuerda.
• El comprador recibe el comprobante y la lista de inscritos (sin contraseñas).
• El correo de ventas recibe el aviso de la venta.

12. Renovaciones y accesos vigentes

En un pedido grupal pueden mezclarse estudiantes nuevos y renovaciones; el panel marca «Renovación».

13. Panel de ventas

Primera sección del panel. Muestra indicadores (ventas pagadas, recaudado, por confirmar y estudiantes matriculados), filtros por estado, curso y texto (nombre, RUT, correo o pedido, también de los estudiantes; el orden por columna y la búsqueda se hacen en el servidor porque la lista se pagina) y la exportación a Excel con una fila por estudiante.

Acciones

14. Correos y SMTP

Todos los correos usan el logo, el nombre y el color de marca del sitio y salen en HTML con versión de texto.

Correo de Moodle o SMTP propio

Por defecto la tienda usa la configuración de correo saliente de Moodle. Si el aula envía mal (spam, rechazos) puedes usar una cuenta SMTP propia solo para la tienda: servidor, puerto, seguridad (ninguna, SSL o TLS), usuario, contraseña, remitente, nombre y «responder a».

Usa como remitente la misma casilla autenticada; si son distintas, la tienda te advierte porque muchos servidores lo rechazan o lo marcan como spam.

En Correo › Enviar correo de prueba se envía un mensaje de prueba y muestra el error exacto con una pista (usuario o contraseña, conexión, cifrado o remitente). La contraseña nunca aparece en pantalla ni en los registros.

Si un correo falla, queda en cola y se reintenta automáticamente (cada vez más espaciado, hasta 12 intentos). El panel avisa cuántos correos siguen pendientes. En la cola no se guardan contraseñas: si se reintenta una bienvenida de una cuenta nunca usada, se genera una contraseña temporal nueva.

15. Plantillas de correo y avisos de vencimiento

En Plantillas de correo están todos los correos que envía la tienda, con cuándo se envía, a quién y su estado:

Al abrir un correo ves la vista previa con datos ficticios (con el logo, nombre y color del sitio) y puedes editar el asunto, el título y el texto con el editor de Moodle. Las variables se escriben con llaves y se reemplazan en cada envío: {nombre}, {curso}, {cursos} (lista de cursos de un pack), {usuario}, {contrasena} (solo en la bienvenida con cuenta nueva), {enlace}, {fecha_termino}, {monto}, {referencia}, {sitio}, etc. La lista de cada correo está al pie de la página. Al guardar se rechaza una variable que no exista en ese correo y se exige mantener las obligatorias (en la bienvenida con cuenta nueva, {usuario} y {contrasena}).

• Vista previa sin guardar: muestra el resultado de lo escrito sin guardarlo.
• Enviarme una prueba: envía el correo con datos ficticios a tu casilla, con «[Prueba]» en el asunto.
• Restaurar original: vuelve al texto original de la tienda.
• Mientras no cambies un correo se usa el texto original en el idioma de quien lo recibe. Un texto personalizado es uno solo para todos los idiomas.
• Las plantillas nunca guardan contraseñas: {contrasena} se reemplaza solo al enviar.

Avisos de vencimiento de acceso

Cada día (tarea programada «Checkout para Moodle: avisos de vencimiento de acceso», 9:00) la tienda revisa los accesos que compraron sus estudiantes y envía «Tu acceso vence pronto» los días elegidos antes del término (por defecto 7 y 1) y «Tu acceso venció» al día siguiente, con un enlace para renovar el curso o el pack completo. Los días se cambian en la misma página («Días de anticipación»).

• Cada aviso se envía una sola vez por persona, curso o pack y fecha de término; al renovar, empieza de nuevo para la fecha nueva.
• Si el cron no corrió algunos días, se envía solo el aviso más cercano (no llegan juntos el de 7 días y el de 1 día). Un acceso que venció hace más de 3 días no recibe el aviso de vencido.
• Solo se avisa a estudiantes matriculados por la tienda (no a matrículas hechas a mano).

16. Sitios externos: tus cursos en tu sitio web

Con Sitios externos los cursos y packs a la venta aparecen en tu propio sitio web (WordPress, Wix, una página HTML o un sitio estático). El visitante ve las tarjetas en tu sitio y, al presionar «Comprar», se abre el pago en tu Moodle en una pestaña nueva (o en la misma ventana, si lo eliges). El pago siempre ocurre en el Moodle: Webpay, Flow y Mercado Pago no funcionan dentro de recuadros de otros sitios.

Paso 1: activar la publicación

• Publicar el catálogo: enciende el feed, el código para pegar y el iframe. Apagado, ninguno muestra datos.
• Exigir clave: si lo marcas, todo pedido debe traer la clave pública de un sitio activo (la clave ya viene en el código generado). Sin marcar, un servidor sin clave (por ejemplo, el generador de un sitio estático) también puede leer el feed; los navegadores igual solo lo muestran en los sitios autorizados.
• Pedidos por minuto: tope de pedidos por minuto desde una misma dirección IP (120 por defecto; 0 = sin límite).

Paso 2: autorizar tu sitio

Presiona Agregar sitio y escribe la dirección de tu sitio, por ejemplo https://www.otec-ejemplo.cl. Solo cuenta el dominio: se ignoran las rutas, y da lo mismo con o sin «www.». Cada sitio recibe una clave pública. La tabla se ordena por sus títulos y tiene buscador; desde ella puedes Editar, desactivar, generar una nueva clave (la anterior deja de funcionar al instante) o Borrar. «Último uso» indica cuándo ese sitio pidió el catálogo por última vez.

Paso 3: copiar el código

En Código para pegar elige el sitio, qué mostrar (packs y cursos, solo cursos o solo packs), la categoría, solo destacados, el máximo de tarjetas, el color de los botones, la tipografía, las esquinas y si el pago se abre en una pestaña nueva o en la misma ventana. El código y la vista previa se actualizan solos. Hay tres formas:

Paso 4: pegarlo en tu sitio

La sección Instrucciones para tu sitio explica los pasos para WordPress (bloque «HTML personalizado» o widget HTML de Elementor), una página HTML, Wix («Insertar un sitio» con la dirección del iframe) y sitios estáticos (feed JSON).

Qué se publica y qué no

Los cambios de precios y cursos se ven en los sitios en pocos minutos (el catálogo se guarda en caché un par de minutos).

Permiso de sección: en Usuarios del panel la sección «Sitios externos» parte en «Sin acceso»; con «Solo lectura» la persona ve los sitios y copia el código, con «Editar» además activa la publicación y agrega, quita o cambia claves.

17. Pasarelas: integración y producción

Cada pasarela tiene un modo: Integración (ambiente de pruebas, sin dinero real) o Producción, y credenciales separadas para cada modo. Todo se configura en Pasarelas de pago: «Ofrecer … en el pago», modo, credenciales, direcciones para copiar y prueba de conexión. En la versión gratuita solo puede haber un medio de pago activo: si intentas activar un segundo, el panel lo impide y te dice cuál está activo. El modo se ve en Pasarelas, en Ventas y, solo para administradores, en el formulario de compra («Modo integración: los pagos no son reales»).

Probar conexión

Prueba las credenciales guardadas (o unas escritas en el momento, sin guardarlas) de cada modo, sin cobrar nada:

• Flow: consulta firmada de solo lectura. Distingue credenciales válidas, API Key inexistente, firma incorrecta (Secret Key que no corresponde) y problemas de red.
• Mercado Pago: consulta la cuenta del token (id, usuario, sitio y país) y advierte si usas un token de prueba en producción o uno productivo en integración, o si la cuenta no es de Chile.

La misma pantalla muestra, con botón Copiar, las direcciones que debes registrar:

Obtener credenciales

• Flow: en sandbox.flow.cl (integración) o www.flow.cl (producción) › Integraciones › Datos de integración: API Key y Secret Key.
• Mercado Pago: Tus integraciones › tu aplicación (Checkout Pro) › Credenciales de prueba o de producción › Access token.

18. Alertas y estado del sistema

El panel de ventas avisa cuando:

• un pago en línea lleva más de una hora pendiente (puede que el aviso de la pasarela esté bloqueado por un firewall o un complemento de seguridad del servidor);
• hay estudiantes de pedidos pagados sin matricular;
• hay correos sin enviar.

Además, Administración › Informes › Estado del sistema incluye «Checkout para Moodle»: código no válido, varios medios activados en la versión gratuita, pasarelas habilitadas, modo integración, última prueba de conexión, cron, pagos pendientes y correo.

19. Soporte y nuevas versiones

• Contactar a soporte (pie del panel y página Licencia, en todas las versiones) abre un correo a contacto@norteduc.cl con el asunto «Soporte Checkout para Moodle <versión> — <dominio>» y los datos técnicos (versión de Moodle, versión y plan de la tienda, sitio) ya escritos. Solo lo ven quienes usan el panel.
• Nueva versión: una tarea diaria consulta la versión publicada por Norteduc. Si hay una más nueva, el panel muestra «Hay una nueva versión disponible: X.Y.Z» con las novedades y el botón Descargar el ZIP (con licencia vigente, la descarga va validada con tu código; en la versión gratuita, la descarga pública). La tienda nunca se actualiza sola: se instala desde Administración del sitio. El aviso lo ven el administrador y los usuarios del panel con acceso a Configuración, y se puede ocultar hasta la próxima versión.

20. Preguntas frecuentes

¿El cliente necesita crear una cuenta antes de comprar?

No. La cuenta se crea al confirmarse el pago, con el RUT sin puntos como usuario.

¿Qué pasa si el estudiante ya tenía cuenta?

Se usa esa cuenta, conserva su contraseña y recibe un recordatorio de acceso.

¿Se puede pagar por varios trabajadores con una sola factura?

Sí: es un solo pedido y un solo pago; cada estudiante recibe su propio acceso y el comprador el comprobante con la lista. La factura tributaria se emite fuera de la tienda (por ahora la tienda no emite documentos del SII).

¿Puedo vender un curso a alguien que ya lo tiene?

Solo si su acceso venció: la compra renueva la misma matrícula. Si está vigente o suspendido no se puede.

¿Qué pasa si el comprador cierra el navegador al pagar?

Nada se pierde: la pasarela avisa al servidor y, si ese aviso no llega, la tarea programada consulta el estado cada 15 minutos. También puedes usar «Verificar con la pasarela».

¿La versión gratuita tiene límite de cursos o de ventas?

No. Vende todos los cursos que quieras; lo limitado es 1 medio de pago, 1 estudiante por compra, sin cupones y sin usuarios del panel.

¿Puedo cambiar el texto de los correos?

Sí, en Plantillas de correo, en todas las versiones. Puedes volver al original cuando quieras.

¿Un pack cuenta como un curso para los cupones?

Un cupón «para todos los cursos» aplica al pack. Un cupón creado para un curso específico no aplica a packs.

¿Puedo mostrar mis cursos en mi sitio web y cobrar desde ahí?

Sí, con la licencia: en Sitios externos autorizas tu sitio y copias el código. Las tarjetas se ven en tu sitio y el pago se hace en el Moodle (pestaña nueva), que matricula y envía los accesos como siempre.

¿Dónde veo cuánto se ha vendido?

En el panel de ventas (indicadores y filtros) o exportando a Excel.

21. Solución de problemas