Manual de usuario · versión 1.11.0 · 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.
local_tiendacursos-1.2.0.zip y luego (opcional) block_tiendacursos-1.2.0.zip.RA1.). El código vale para un solo dominio; se activa una vez en línea.Sin código de activación la tienda nunca queda cerrada: funciona en la versión gratuita. Una licencia anual o perpetua habilita todo.
| Función | Versión gratuita | Licencia anual o perpetua |
|---|---|---|
| Cursos a la venta, vitrina, bloque y catálogo en portada | Sin límite | Sin límite |
| Medios de pago activos a la vez | 1 (Flow, Mercado Pago o transferencia; la transferencia cuenta como medio de pago) | Todos |
| Estudiantes por compra | 1 (sin compras grupales ni descuentos por cantidad) | Hasta el máximo configurado, con tramos de descuento |
| Cupones de descuento | No | Sí |
| Packs de cursos | No (los packs guardados quedan inactivos) | Sí |
| Tarjetas compactas y ficha pública del curso («Más información») | Sí (la ficha de packs, con los packs) | Sí |
| Plantillas de correo (ver, editar, restaurar, probar) | Sí | Sí |
| Sitios externos (feed, código para pegar e iframe en tu sitio web) | No (los sitios guardados se conservan) | Sí |
| Avisos de vencimiento de acceso a estudiantes | No (la plantilla se puede dejar lista) | Sí |
| Usuarios del panel (Editar / Solo lectura por sección) | No: solo el administrador del sitio | Sí |
| Botón «Contactar a soporte» y aviso de nueva versión | Sí | Sí |
Las funciones de pago se ven en el panel con un candado y el botón «Comprar licencia», que abre la tienda de Norteduc.




Con una licencia anual o perpetua vigente, la página Licencia ya no muestra «Qué incluye la versión gratuita»: en su lugar aparece «Qué incluye tu licencia» (todas las funciones, con las actualizaciones hasta el vencimiento o para siempre) y el botón «Renovar licencia» en la anual (la perpetua no muestra botón de compra). Si la licencia anual vence y termina el período de gracia, vuelve a aparecer el cuadro de la versión gratuita.

La licencia perpetua no vence e incluye las actualizaciones para siempre; la anual, mientras esté vigente.
| Plan | Botones |
|---|---|
| Versión gratuita | «Ver licencias anual y perpetua»: abre la página de Checkout en norteduc.cl, en la sección de licencias y precios. |
| Anual | «Renovar licencia anual» y «Pasar a licencia perpetua». El segundo abre el producto «Mejora a licencia perpetua» con la dirección de tu Moodle ya escrita: pagas solo la diferencia entre la perpetua y la anual (sin prorrateo). Antes de cobrar, la tienda comprueba que tu licencia anual esté vigente o dentro de los 15 días de gracia. Al confirmarse el pago recibes por correo un código nuevo para el mismo sitio y el mismo número de licencia: lo pegas en «Licencia» y guardas; no hay que reinstalar ni se pierde nada. |
| Perpetua | Ninguno (no hay nada más que comprar). |
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 que ocupan todo el ancho del panel (3 o 4 por fila en el computador, 2 en la tableta y 1 en el celular), 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». Cada tabla muestra como máximo 30 filas: con más resultados aparecen «Anterior» y «Siguiente», «Página X de Y» y «N resultados». Ordenar y buscar actúan sobre todas las filas (buscar vuelve a la página 1) y las casillas marcadas se conservan al cambiar de página.
| Sección | Para qué |
|---|---|
| Ventas | Pedidos, confirmación de transferencias, matrícula por estudiante y exportación a Excel. |
| Cursos a la venta | Precio, horas, días de acceso y qué cursos se venden. |
| Packs | Varios cursos juntos por un solo precio, con oferta y vigencia (licencia). |
| Cupones | Códigos de descuento (licencia). |
| Compras grupales | Tramos de descuento por cantidad, combinación con cupones y máximo por compra (licencia). |
| Pasarelas de pago | Flow, Mercado Pago y transferencia: modo, credenciales, prueba de conexión y direcciones. |
| Correo | Correo de Moodle o SMTP propio, correo de avisos de venta y correo de prueba. |
| Plantillas de correo | Texto de cada correo, activar o desactivar los opcionales, vista previa, prueba y avisos de vencimiento. |
| Sitios externos | Sitios web autorizados y código para mostrar el catálogo en ellos (licencia). |
| Configuración | Días de acceso, términos y privacidad, enlace en el menú y catálogo en la portada. |
| Usuarios del panel · Licencia | Solo el administrador del sitio. |
| Ver la vitrina · Documentación | Accesos directos para todos los que usan el panel. |
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.



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.

| Ajuste | Dónde | Qué hace |
|---|---|---|
| Días de acceso por defecto | Configuración | Días de acceso cuando el curso no define los suyos (0 = sin término). |
| Mostrar «Cursos a la venta» en el menú | Configuración | Agrega la vitrina a la navegación principal (también para visitantes). |
| Términos y condiciones · Política de privacidad | Configuración | Textos con página propia, enlazados donde el comprador los acepta. También se puede usar una URL externa para los términos. |
| Estilo de tarjeta | Configuración | Compacta (predeterminada desde la 1.4: portada, nombre, precio, «Comprar» y «Más información») o Con descripción (además categoría, horas, días de acceso y un resumen, como hasta la 1.3). Vale para la vitrina, la portada, el bloque, el iframe y el código para pegar (sección 10). |
| Mostrar el temario en la ficha del curso | Configuración | Lista en la ficha pública los nombres de las secciones visibles del curso que tengan nombre propio (al menos 2). Nunca muestra su contenido. |
| Catálogo en la portada | Configuración | Tarjetas de packs y cursos al final de la portada del sitio (sección 10). Cantidad 0 = todos. |
| Buscador y filtros (1.10) | Configuración | Barra lateral con buscador, filtros y orden en la tienda, la portada y los bloques (cada uno se activa por separado) y qué filtros se muestran: buscador, categoría, precio, duración, solo con descuento, tipo, etiquetas y orden. Todo activado por defecto (sección 10). |
| Correo para avisos de venta | Correo | Recibe cada venta y cada transferencia por confirmar. Vacío = correo de soporte del sitio. |
| Máximo de estudiantes por pedido | Compras grupales | Límite de una compra grupal (por defecto 100). |
| Descuento grupal y cupón | Compras grupales | No acumulables (recomendado: se aplica el mayor) o acumulables (primero el grupal y luego el cupón sobre el resto). |
En Configuración › Moneda y país:

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


Cada curso a la venta puede ofrecer su temario en PDF para descargar desde la ficha pública del curso. En la configuración del curso subes un archivo PDF («Temario (PDF)») y eliges en «Descarga del temario»:


El correo de agradecimiento es una plantilla editable («Temario del curso») en Plantillas de correo (sección 15), con sus variables y vista previa. El adjunto se agrega automáticamente. Los leads capturados quedan registrados y se declaran en la política de privacidad del complemento.
Un pack vende varios cursos juntos por un solo precio. En Packs › Nuevo pack defines:


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.




Además de vender cursos con un solo pago, puedes cobrar cada mes, cada trimestre o cada año con la tarjeta que el alumno registra en la pasarela (este sitio nunca ve la tarjeta). Hay dos tipos de plan:


Medios de pago que cobran suscripciones: Flow (solo pesos chilenos: el alumno registra su tarjeta en Flow), Mercado Pago (en la moneda de la cuenta) y PayPal (en dólares u otra moneda de PayPal con el tipo de cambio y margen de «Medios de pago»). Webpay, Khipu, MACH, Getnet, Stripe y transferencia no se ofrecen para planes.
Cambios de precio: las suscripciones que ya corren siguen con el precio que aceptaron; el precio nuevo vale para las nuevas. En PayPal, además, cada suscripción queda con el monto en dólares del día en que empezó: si cambia el tipo de cambio, Checkout crea otro plan en PayPal solo para las suscripciones nuevas.
Desde la vitrina o la ficha pulsa Suscribirme, escribe sus datos (nombre, país, RUT o documento, correo), elige el medio de pago, acepta el cobro automático y aprueba en la pasarela. Al volver, Checkout consulta a la pasarela y, si está activa, crea su cuenta (o usa la que ya tiene), lo matricula y le envía el correo de bienvenida con su acceso.





Muestra el ingreso mensual recurrente (MRR), las suscripciones vigentes, nuevas y perdidas del mes con la tasa de cancelación, y pestañas por estado: Activas, En prueba, Morosas (en gracia o suspendidas), Canceladas y Vencidas. Cada tabla se ordena por sus títulos, tiene buscador y muestra 30 filas por página; se exporta a Excel o CSV. En el detalle puedes consultar a la pasarela, reintentar el cobro / reactivar, cancelar (al fin del período o de inmediato) y reembolsar el último cobro. El permiso «Suscripciones» se da por usuario del panel (Ver o Editar).


En el menú de usuario aparece Mis suscripciones: estado, plan, próximo cobro, monto e historial de cobros, con los botones Cambiar tarjeta o medio de pago (en la pasarela) y Cancelar suscripción (con confirmación).

En Plantillas de correo hay ocho nuevas, editables: bienvenida, cobro con comprobante, cobro fallido, suspensión, reactivación,
prueba por terminar (3 días antes), cancelación y aviso de nueva suscripción al administrador. Variables nuevas: {plan},
{proximo_cobro} y {enlace_suscripcion}.
subscription_preapproval y
subscription_authorized_payment. Si copias la clave secreta de los webhooks en Medios de pago, Checkout verifica la firma.BILLING.SUBSCRIPTION.* y PAYMENT.SALE.*.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.

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.
La vitrina (/local/tiendacursos/index.php) lista los packs y cursos a la venta en tarjetas compactas:
portada, nombre, precio (con el precio normal tachado y «Ahorras $X» cuando hay oferta) y los botones Comprar y
Más información, junto a una barra lateral con buscador y filtros (1.10, ver abajo). Se adapta al teléfono. Si
prefieres las tarjetas con categoría, horas, días de acceso y un resumen, elige Configuración › Estilo de tarjeta › Con
descripción.

En la vitrina, en el catálogo de la portada y en el bloque, las tarjetas van acompañadas de una barra lateral con:
La barra acompaña al bajar por la lista (queda fija bajo la barra de navegación del tema). En el celular, en tabletas angostas y en columnas laterales, el acceso a los filtros es un botón flotante «Filtros» fijo abajo (con la cantidad de resultados y de filtros activos) que queda siempre a la vista mientras recorres los cursos y abre el panel de filtros; el panel se cierra con la ×, con la tecla Esc o con «Ver N resultados». El buscador queda sobre las tarjetas. Las tarjetas se muestran de a 3 por fila en el computador, 2 en tabletas y 1 en el celular.
Los filtros quedan en la dirección de la página, así que puedes compartir una búsqueda o enlazarla desde un correo o una
publicación, por ejemplo /local/tiendacursos/index.php?cat=4&offer=1&sort=priceasc (categoría 4, solo con
descuento, del más barato al más caro). Parámetros: q (texto), cat (id de la categoría),
price y hours (tramo), offer=1, type (course o
pack), tag (ids separados por coma) y sort (priceasc,
pricedesc, name, newest). Los enlaces antiguos con ?cat= siguen
funcionando.






Se configura en Configuración › Buscador y filtros: dónde se muestra (tienda, portada, bloques) y qué filtros aparecen. Todo viene activado; cada filtro aparece solo cuando tiene sentido con tus cursos, y la barra solo aparece con 2 tarjetas o más. Está incluida en la versión gratuita.

Para que el filtro de Duración sirva, completa las horas de cada curso en Cursos › Editar oferta. Para el de Etiquetas, agrega etiquetas en la configuración de cada curso de Moodle (Etiquetas) con las etiquetas activadas en el sitio.
«Más información» (y también la portada y el nombre de la tarjeta) abre la ficha pública del curso
(/local/tiendacursos/course.php?id=ID; la de un pack, ?pack=ID). No pide iniciar sesión y existe solo
mientras el curso está a la venta (oferta visible con precio y curso visible); si no, muestra «no disponible». Contiene:
La ficha trae título y descripción para buscadores, imagen y textos para compartir en redes (Open Graph) y datos estructurados de curso (schema.org), con el nombre, los colores y el logo del propio Moodle.




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

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 (0 = todos, desde el bloque 1.3), categorías, solo destacados, orden (destacados, recientes, precio o nombre), formato tarjetas o lista, Buscador y filtros (según la configuración de Checkout, mostrar o no mostrar; desde el bloque 1.3 con Checkout 1.10) y botón «Ver todos los cursos». El formato lista no lleva barra lateral. En una columna lateral angosta, el bloque muestra el botón «Filtros», que abre el panel desde ese lado de la pantalla.


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). Con Cantidad de cursos = 0 (1.10) se muestran todos (hasta 200) y, con el buscador y los filtros, la portada funciona como la tienda completa.

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.




El formulario empieza con el país (el de la tienda por defecto). Si es Chile se pide el RUT, como siempre; si es otro país, se elige el tipo de documento (pasaporte, DNI, cédula u otro) y se escribe su número (4 a 20 letras o números). Los estudiantes del pedido son del mismo país que el comprador. Al cambiar el país, el formulario se actualiza y muestra solo los medios de pago disponibles para ese país.
pe-pasaporte-pe1234567) y el número queda en el «Número de ID» del perfil.


Privacidad del resultado (1.8): la página del pedido muestra los datos completos a quien hizo la compra (en el mismo navegador), al comprador con sesión iniciada y a los usuarios del panel. Cualquier otra persona con el enlace solo los ve mientras el pedido está pendiente o se pagó hace menos de 24 horas (y nunca después de 7 días), con el correo parcialmente oculto; fuera de ese plazo ve solo el estado y el número de pedido.

| Situación del estudiante en el curso | ¿Puede comprar? | Qué pasa al pagar |
|---|---|---|
| Sin matrícula | Sí | Se matricula por los días de acceso del curso. |
| Acceso vigente | No: «ya tiene acceso hasta dd-mm-aaaa» | — |
| Acceso vencido | Sí (Renovar acceso) | Se reactiva la misma matrícula desde hoy por los días del curso; conserva calificaciones y avance. Recibe «Tu acceso fue renovado hasta…». |
| Suspendido por un administrador (con fecha vigente) | No: «contacta a la administración» | — |
En un pedido grupal pueden mezclarse estudiantes nuevos y renovaciones; el panel marca «Renovación».

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.

| Acción | Cuándo |
|---|---|
| Confirmar pago | Transferencia recibida: matricula a todos y envía los accesos. |
| Verificar con la pasarela | Pago en línea pendiente: consulta el estado real a Flow o Mercado Pago. |
| Anular | Pedido pendiente que no se pagará. |
| Reenviar acceso | Por estudiante. Si la cuenta nunca se usó, genera una contraseña temporal nueva; si no, envía un recordatorio. |
| Reintentar matrícula | Por estudiante, cuando su matrícula falló (los demás del grupo no se ven afectados). |

Si el RUT o documento de un estudiante ya pertenece a una cuenta del aula con otro correo, y esa cuenta no está ni estuvo matriculada en los cursos del pedido, la tienda no la matricula automáticamente: el estudiante queda Por revisar, el correo de ventas recibe un aviso y en el detalle del pedido aparece «Matricular de todos modos». Así nadie puede comprar un curso para la cuenta de otra persona escribiendo su RUT. Las renovaciones de una cuenta que ya estaba en el curso no se detienen.

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


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».
| Proveedor | Servidor | Puerto / seguridad | Usuario y contraseña |
|---|---|---|---|
| Gmail o Google Workspace | smtp.gmail.com | 587 / TLS (o 465 / SSL) | La cuenta completa y una contraseña de aplicación (Cuenta de Google › Seguridad › Verificación en dos pasos › Contraseñas de aplicaciones). La contraseña normal no funciona. |
| Hosting con cPanel | mail.tudominio.cl | 465 / SSL (o 587 / TLS) | La casilla
completa (cursos@tudominio.cl) y su contraseñ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.
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:
| Correo | A quién | ¿Se puede desactivar? |
|---|---|---|
| Bienvenida con cuenta nueva (usuario y contraseña temporal) | Cada estudiante | No |
| Bienvenida con cuenta existente | Cada estudiante | No |
| Inscripción presencial (1.16, sin credenciales) | Cada estudiante | No |
| Renovación de acceso | Cada estudiante | No |
| Comprobante al comprador | Quien compra | Sí |
| Datos para transferir | Quien compra | No |
| Nueva venta | Administración | Sí |
| Transferencia por confirmar | Administración | Sí |
| Tu acceso vence pronto | Cada estudiante | Sí (licencia) |
| Tu acceso venció | Cada estudiante | Sí (licencia) |

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}).

{contrasena} se reemplaza solo al enviar.
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»).


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.

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.


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:
| Forma | Para qué sirve |
|---|---|
| 1. Código para pegar (recomendado) | Un <script> que dibuja tarjetas con el color y la
tipografía elegidos, se adapta al celular, es accesible y se carga cuando el visitante llega a esa parte de la página. |
| 2. Iframe de la vitrina | La vitrina del Moodle, sin cabecera ni pie, dentro de tu página. Útil cuando tu plataforma no permite scripts. Solo los sitios autorizados pueden mostrarla. |
| 3. Feed JSON | Los datos del catálogo para que un desarrollador o un sitio estático arme sus propias tarjetas (por ejemplo, al publicar el sitio, lo que además ayuda al posicionamiento en buscadores). |


Además del iframe general, el generador entrega dos iframes listos para incrustar en cualquier sitio:
Internamente usan el mismo iframe con el parámetro &mod=presencial o &mod=online en la
dirección de embed.php (también acepta mod=elearning o mod=semipresencial para una sola
modalidad). Así puedes tener, por ejemplo, una página «Cursos presenciales» y otra «Cursos online» en tu sitio, cada una con
su propio iframe. Usan el primer sitio autorizado.
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).

Desde la 1.4 las tarjetas del código para pegar y del iframe son compactas (portada, nombre, precio, «Comprar» y
«Más información»), según el Estilo de tarjeta de Configuración. «Más información» abre la ficha pública del curso en tu
Moodle, en una pestaña nueva o en la misma ventana según lo que elegiste para el pago. Para forzar un estilo en un sitio puntual,
agrega al código data-style="full" (con descripción) o data-style="compact". El feed JSON trae la
dirección de la ficha en info_url.


Desde la 1.6 el código para pegar muestra la tienda con el buscador («Buscar cursos») y el filtro por categoría (con la cantidad de cursos de cada una y «Limpiar filtros» cuando hay un filtro activo) en una barra lateral a la izquierda de las tarjetas, que se queda fija mientras el visitante baja por la página. Así tu sitio funciona como una tienda completa sin WooCommerce ni otro sistema de comercio electrónico: el pago y la matrícula siguen ocurriendo en tu Moodle. Puedes ver un ejemplo funcionando en www.norteduc.cl/prueba-checkout-moodle.
En el generador (Paso 3) hay dos opciones nuevas:
| Opción | Qué hace |
|---|---|
| Diseño del buscador y las categorías | Automático (recomendado): barra lateral cuando hay 2 o más
categorías o 6 o más cursos; si no, el diseño simple. Barra lateral fija a la izquierda: siempre al costado.
Sobre las tarjetas: el diseño anterior, con el buscador y las categorías arriba. En el código se ve como
data-layout="sidebar" o data-layout="top". |
| Espacio libre sobre la barra lateral | Si tu sitio tiene una cabecera fija (que no se mueve al bajar),
elige su alto para que la barra no quede debajo de ella. En el código se ve como data-sticky-top="80". Si no sabes
el alto, prueba con 80 o 100 px y revisa tu página. |

Se adapta al espacio donde lo pegas, no al tamaño de la pantalla: si el espacio es amplio, barra lateral y tres tarjetas por fila; si es intermedio, barra lateral y dos tarjetas; en una columna angosta o en el celular, el buscador queda arriba con un botón «Filtrar por categoría» que despliega las opciones. Siempre ocupa el 100 % del ancho disponible, sin desplazamiento lateral.


embed.js?v=… con la versión del complemento
instalada. Cuando actualices Checkout, vuelve a copiar el código desde el generador y reemplázalo en tu sitio: así tus
visitantes ven el diseño nuevo de inmediato, en vez del que su navegador tenía guardado. Si pegas dos códigos en la misma página,
usa un identificador distinto en cada uno (data-container).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.
En Pasarelas de pago cada medio de pago tiene su propia sección, plegada: la fila muestra el nombre, si está Activa o Inactiva, el modo (Integración o Producción), si está Completa o le faltan datos y el tipo de integración. Haz clic (o Enter/Espacio con el teclado) para desplegarla. Al guardar o probar la conexión, la página vuelve con esa pasarela abierta, y recuerda las que tenías abiertas mientras no cierres el navegador.

Hay dos formas de cobrar en línea:
| Tipo | Pasarelas | Qué significa |
|---|---|---|
| Agregador | Flow, Mercado Pago | Un solo contrato. Flow cobra con Webpay, Khipu, MACH y otros medios bajo su contrato («Webpay vía Flow»), te descuenta su comisión y te deposita. |
| Integración directa | Webpay Plus (Transbank), Khipu, MACH, Getnet, PayPal | Tu propio contrato con cada empresa, con sus credenciales, su forma de avisar el pago y su abono. «Webpay directo» no es lo mismo que «Webpay vía Flow». |
| Manual | Transferencia bancaria | Confirmas el pago a mano en Ventas. |
Con licencia puedes ofrecer varios a la vez (incluso Flow y Webpay directo); el comprador los ve como opciones separadas. En la versión gratuita solo puede haber un medio activo: si intentas activar un segundo, el panel lo impide y te dice cuál está activo.

La página de pago de PayPal se muestra en el idioma de tu aula (español por defecto).
Cada pasarela muestra un recuadro «Dónde funciona» y el ajuste Disponible para: compradores de todos los países, solo compradores del país de la tienda, o los países que elijas. El comprador indica su país al pagar y solo ve los medios disponibles para él. Si eliges países donde la pasarela no opera, el panel avisa (no lo impide).
| Medio de pago | Dónde funciona | Por defecto |
|---|---|---|
| Flow, Webpay, Khipu, MACH, Getnet | Chile, solo pesos chilenos (algunas aceptan tarjetas extranjeras) | Solo el país de la tienda |
| Mercado Pago | El país de tu cuenta (Chile, Argentina, Brasil, Colombia, México, Perú o Uruguay), en su moneda | Solo el país de la tienda |
| PayPal | Casi todos los países; cobra en la moneda de PayPal elegida | Todos los países |
| Stripe | Compradores de todos los países; la empresa vendedora debe estar en un país donde Stripe opera (no Chile) | Todos los países |
| Transferencia | Donde puedas recibirla | Solo el país de la tienda |

Para tiendas cuya empresa está en un país donde Stripe opera (México, Brasil, Estados Unidos, España y otros; Stripe no opera con empresas chilenas). El comprador paga en la página de Stripe (tarjetas, Apple Pay, Google Pay y los medios locales que Stripe active en tu cuenta), en la moneda de la tienda.
sk_test_… en modo prueba,
sk_live_… en producción) en el modo correspondiente.checkout.session.completed; copia su secreto de firma (whsec_…). Sin webhook, el pago se confirma
cuando el comprador vuelve a la tienda y con la revisión programada.sk_test_… y la tarjeta 4242 4242 4242 4242
(cualquier fecha futura y CVC).Los reembolsos se hacen desde Ventas («Reembolsar el pago»).

Dentro de cada pasarela: «Ofrecer … en el pago», modo, credenciales de Integración y de Producción por separado (las claves guardadas nunca se muestran y se guardan cifradas), «Cómo obtener las credenciales y activar el medio de pago» (los pasos de cada empresa), las direcciones para copiar y la prueba de conexión de cada modo.

| Pasarela | Credenciales | Dónde se obtienen | Dirección a registrar |
|---|---|---|---|
| Flow | API Key, Secret Key | flow.cl (pruebas: sandbox.flow.cl) › Datos de integración | Ninguna (va en cada pago) |
| Webpay Plus | Código de comercio, API Key Secret | Integración: públicas de Transbank (vacío = se usan). Producción: Transbank, tras validar la integración (formulario con compras de prueba). | Ninguna: Webpay no avisa al servidor; el pago se confirma cuando el comprador vuelve. |
| Khipu | API Key, secreto de la cuenta de cobro | khipu.com › Opciones de la cuenta de cobro › Para integrar Khipu (pruebas: cuenta de cobro de desarrollo con DemoBank) | Ninguna (va en cada pago) |
| MACH | API Key, ID de la caja digital, token del webhook (opcional) | Portal MACH para comercios (pay.somosmach.com) › Configuraciones › Para Desarrolladores; Sandbox se activa al inscribirse, Producción al completar los datos legales | URL del webhook en Configuraciones › Webhooks (pagos en línea) |
| Getnet | Login, llave secreta | Pruebas: públicas de Getnet (vacío = se usan). Producción: Getnet, tras validar la integración | URL de notificación: pedir a Getnet que la registre |
| PayPal | Client ID, Secret, Webhook ID (opcional) + moneda y tipo de cambio | developer.paypal.com › Apps & Credentials (pestañas Sandbox y Live) | URL del webhook en la aplicación de PayPal |
| Mercado Pago | Access token | Tus integraciones › Credenciales | Webhooks (opcional) |
PayPal no acepta pesos chilenos ni varias otras monedas de la región. Elige la moneda de cobro (USD por defecto) y cómo se define el tipo de cambio (unidades de la moneda de la tienda por 1 unidad de la moneda de PayPal). Si la tienda está en la misma moneda que PayPal (por ejemplo, ambas en dólares), no hay conversión.
El margen por comisión y conversión (0 % a 15 %, por defecto 0 %) se suma al cobro en la moneda extranjera: con 3 % el comprador paga 3 % más, lo que cubre aproximadamente la comisión de PayPal y la conversión. Bajo el tipo de cambio verás el valor aplicado, su fuente, la fecha de actualización y un ejemplo («$29.900 = USD 30,25»). Sin tipo de cambio, PayPal no se ofrece. El comprador ve el monto convertido (redondeado hacia arriba al centavo) junto a la opción PayPal y en el resumen; la venta guarda el monto en pesos, la moneda, lo cobrado y el tipo de cambio, y el pago solo se acepta si PayPal capturó exactamente ese monto.

Con la tienda en otra moneda (1.8), el tipo de cambio automático usa el mercado (open.er-api.com); el dólar observado de mindicador.cl solo se usa con la tienda en pesos chilenos.




Prueba las credenciales guardadas (o unas escritas en el momento, sin guardarlas) de cada modo, sin cobrar nada: cada pasarela hace una consulta de solo lectura (Flow: consulta firmada; Webpay: estado de una transacción inexistente; Khipu: lista de bancos; MACH: lista de pagos; Getnet: autenticación; PayPal: token de acceso y, si lo diste, el webhook; Mercado Pago: la cuenta del token) y distingue credenciales válidas, rechazadas, de otro ambiente y problemas de red.
En Ventas › detalle de una venta pagada con Webpay, Khipu, MACH, Getnet o PayPal aparece «Reembolsar el pago» (pide confirmación). Devuelve el monto total por la API de la pasarela y deja la venta como Reembolsado. El acceso de los estudiantes no se quita solo: si corresponde, suspende o quita la matrícula en el curso. Cada pasarela tiene sus plazos (Webpay: anulación de crédito o reversa de débito el mismo día; Khipu: antes de la rendición; MACH: reversa en 5 minutos o devolución hasta 14 días; Getnet: reversa normalmente el mismo día). Fuera de plazo, y siempre con Flow y Mercado Pago, el reembolso se hace desde el panel de la pasarela.



El panel de ventas avisa cuando:
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.

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.
No. La cuenta se crea al confirmarse el pago, con el RUT sin puntos como usuario (o el documento, si es de otro país).
Se usa esa cuenta, conserva su contraseña y recibe un recordatorio de acceso. Si la cuenta tiene otro correo y nunca estuvo en el curso, queda «Por revisar» hasta que la matricules (sección 13).
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).
Solo si su acceso venció: la compra renueva la misma matrícula. Si está vigente o suspendido no se puede.
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». Webpay no avisa al servidor: si el comprador no vuelve a la tienda, la tarea programada confirma la transacción con Transbank.
No: PayPal no acepta pesos chilenos. Checkout convierte el total con el tipo de cambio del día (automático) o el que escribas (manual), más el margen que definas, y cobra en la moneda elegida (USD por defecto); el comprador ve el monto convertido antes de pagar.
Sí (1.8). El comprador elige su país y se identifica con su pasaporte, DNI o cédula; le ofreces PayPal, Stripe, Mercado Pago o transferencia según el país. Los cursos SENCE siguen exigiendo RUT chileno.
Sí (1.8): cambia la moneda de la tienda en Configuración y revisa los precios. Webpay, Khipu, MACH, Getnet y Flow solo cobran en pesos chilenos.
Sí: en Licencia, «Pasar a licencia perpetua». Pagas la diferencia entre ambas y recibes un código nuevo para el mismo sitio.
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.
Sí, en Plantillas de correo, en todas las versiones. Puedes volver al original cuando quieras.
Un cupón «para todos los cursos» aplica al pack. Un cupón creado para un curso específico no aplica a packs.
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.
Sí (1.10): elige los filtros y copia la dirección de la página; quien la abra verá el mismo resultado y el mismo orden. Ver Buscador y filtros.
En el panel de ventas (indicadores y filtros) o exportando a Excel.
Sí (licencia anual o perpetua): Suscripciones › Planes › Nuevo plan › Membresía › Todo el catálogo. Ver 7b.
Desde la versión 1.11 las portadas de las tarjetas del catálogo se cargan de forma diferida (solo las que se ven; las de más abajo se descargan al acercarte) y se sirven en un tamaño ajustado a la tarjeta y en formato WebP cuando tu servidor lo admite (si no, en JPEG o en el original). Las portadas se ven igual pero pesan mucho menos, así que la vitrina, la portada del sitio y el bloque abren más rápido, sobre todo en el celular. No hay que configurar nada: es automático y, si tu servidor no tiene las herramientas de imagen, se usa la portada original sin romper nada.
| Síntoma | Causa probable | Qué hacer |
|---|---|---|
| Las funciones de pago aparecen con candado aunque compré la licencia | Falta activar el código, es de otro dominio o la licencia anual venció (pasados los 15 días de gracia). | Abre Licencia: muestra el plan, el error exacto y el vencimiento. Escríbenos con «Contactar a soporte». |
| No llegan los avisos de vencimiento | Versión gratuita, el aviso está desactivado, el cron no corre, o el estudiante no fue matriculado por la tienda. | Revisa Plantillas de correo (estado y días) y Alertas y estado del sistema. |
| No aparece el filtro de precio, duración, ofertas o etiquetas | El filtro está desactivado o no tiene sentido con los cursos a la venta: todos tienen el mismo precio, las mismas horas (o sin horas), todos o ninguno con descuento, o no tienen etiquetas. | Revisa Configuración › Buscador y filtros, las horas y precios de cada oferta y las etiquetas de los cursos. |
| No aparece la barra lateral de buscador y filtros | Hay menos de 2 tarjetas, está desactivada para ese lugar, el bloque está en formato lista o el bloque la tiene en «No mostrar». | Configuración › Buscador y filtros y la configuración del bloque. |
| Un pack no aparece en la vitrina | Inactivo, menos de 2 cursos, un curso oculto, precio $0 o sin licencia. | La columna Estado de Packs dice el motivo. |
| Un usuario del panel no ve una sección o no puede guardar | Su permiso en esa sección es «Sin acceso» o «Solo lectura», o se usa la versión gratuita. | El administrador lo cambia en Usuarios del panel. |
| Pagos en línea quedan «Pendiente» aunque el cliente pagó | El aviso de la pasarela no llega (firewall, Imunify360, ModSecurity, Cloudflare, sitio en mantenimiento). | Permite /local/tiendacursos/notify.php
sin exigir navegador ni cookies; usa «Verificar con la pasarela»; revisa que el cron funcione. |
| «Monto distinto» en el historial | La pasarela informó un monto menor que el pedido. | No se matricula; revisa el pago en la pasarela. |
| Correos no llegan | Configuración de correo del sitio o SMTP propio. | Usa «Probar correo» y sigue la pista; con Gmail, usa contraseña de aplicación; usa remitente = cuenta autenticada. |
| Estudiante con «Error» de matrícula | Problema puntual al crear la cuenta o matricular. | Lee el detalle en el pedido y usa «Reintentar matrícula». |
| Flow: «Flow no reconoce esa API Key» | API Key de otro ambiente. | Credenciales de sandbox van en Integración y las de www.flow.cl en Producción. |
| Mercado Pago: «token de prueba en modo producción» | Token TEST- en Producción. | Usa el access token de producción (APP_USR-) de la cuenta que cobra. |
| Las tarjetas no aparecen en mi sitio (solo el enlace «Ver los cursos a la venta») | La publicación está apagada, el sitio no está autorizado (o está inactivo), la dirección autorizada es otra (http/https, puerto) o la clave cambió. | Revisa Sitios externos; compara la dirección exacta de tu sitio con la autorizada y vuelve a copiar el código. La consola del navegador indica «Revisa que este dominio esté autorizado». |
| El iframe aparece en blanco o con «rechazó la conexión» | El sitio que lo muestra no está autorizado (el navegador bloquea el recuadro), o Wix lo inserta desde un dominio intermedio. | Autoriza la dirección exacta del sitio; en Wix usa «Insertar un sitio» o un botón con enlace a la vitrina. |