Plugin de Suscripciones de Discourse

Plugin
, , ,
709

¿Has configurado correctamente los webhooks? Recuerdo que eran bastante complicados de configurar y las instrucciones para hacerlo podrían ser un poco más claras.

710

Sí, configuré los webhooks correctamente, así es como fluía la respuesta.

Descubrí el problema. Las instrucciones omiten un punto donde tenemos que configurar las etiquetas personalizadas con el nombre del grupo al que se promocionará en la página de configuración de precios de Stripe.

Ahora funciona bien para mí. El plugin es genial, pero la documentación no es detallada.

1 me gusta
711

¿Puedes explicar esto un poco más para que podamos pedirle a alguien que actualice la documentación? ¿Qué etiqueta personalizada añadiste y dónde la añadiste?

712

[Guía] Cómo configurar suscripciones de Discourse con tablas de precios de Stripe (y errores comunes)

Hola a todos,

Después de un largo proceso de solución de problemas, quería compartir una guía definitiva para configurar el plugin oficial discourse-subscriptions utilizando el método moderno de Tabla de precios de Stripe. Este enfoque es potente, pero tiene algunos pasos críticos que no son inmediatamente obvios y pueden generar errores como webhooks fallidos (404 Not Found) o que los usuarios no se agreguen a grupos después de un pago exitoso.

Aquí está el proceso paso a paso que se confirma que funciona.

Parte 1: Configuración de Stripe

Este proceso utiliza Stripe como la “fuente de verdad” para todos los productos y precios.

1. Crea tus productos y precios

  • En tu Panel de Stripe, asegúrate de estar en Modo en vivo.
  • Ve a Productos > Catálogo de productos.
  • Crea primero tus productos principales (por ejemplo, “Membresía Premium”, “Acceso VIP”).
  • Debajo de cada producto, crea todos los precios asociados (por ejemplo, XX / mes, XXX / año).

2. El paso CRUCIAL de metadatos Para que el plugin agregue automáticamente a los usuarios a un grupo, debes agregar metadatos específicos a cada objeto de Precio que crees. La interfaz de usuario del panel de Stripe puede dificultar su localización.

  • Al crear un nuevo precio (o si puedes encontrar la opción “Editar precio”), debes agregar metadatos. Es posible que debas hacer clic en “Opciones adicionales” durante la creación del precio para revelar los campos de metadatos.
  • Haz clic en + Agregar metadatos e introduce lo siguiente:
    • CLAVE: group_name
    • VALOR: El slug/identificador único y seguro para URL del grupo de Discourse, no su nombre completo.

Ejemplo:

  • Si el nombre completo de tu grupo de Discourse es “Enclave Plus”, su slug probablemente sea EnclavePlus.
  • Debes usar EnclavePlus como valor. Usar "Enclave Plus" con un espacio fallará.
  • Debes repetir esto para cada plan de precios que desees vincular a un grupo.

Screenshot 2025-07-01 at 11.58.13 PM
Screenshot 2025-07-01 at 11.58.13 PM1912×708 132 KB

3. Crea tu tabla de precios de Stripe

  • Ve a Productos > Tablas de precios.
  • Crea una nueva tabla y agrega los precios que acabas de configurar.
  • Después de publicar la tabla, haz clic en el botón “Copiar código” para obtener tu ID de tabla de precios (comienza con prctbl_...).

4. Configura el endpoint del webhook (La solución al error 404) Este es el punto de fallo más común.

  • Ve a Desarrolladores > Webhooks y haz clic en + Agregar endpoint.
  • La URL del endpoint debe tener el siguiente formato: https://tu-sitio-discourse.com/s/hooks
    • Nota: La ruta correcta es /s/hooks, no /s/stripe/webhook.
  • Para Eventos a enviar, agrega como mínimo:
    • checkout.session.completed
    • customer.subscription.deleted
  • Crea el endpoint y copia el Secreto de firma (comienza con whsec_...).

Parte 2: Configuración de Discourse

Ahora, configuremos el plugin para usar todo lo que configuraste en Stripe.

1. Introduce las claves API y el ID de la tabla de precios

  • Ve a Admin > Ajustes y busca discourse subscriptions.
  • Introduce tus claves de Stripe en vivo:
    • discourse subscriptions public key (pk_live_...)
    • discourse subscriptions secret key (sk_live_...)
    • discourse subscriptions webhook secret (whsec_...)
  • Habilita el modo de tabla de precios:
    • Marca la casilla discourse subscriptions pricing table enabled.
    • Pega tu ID prctbl_... en el campo discourse subscriptions pricing table id.

2. Vincula productos de Stripe a grupos de Discourse Incluso con una tabla de precios, necesitas decirle a Discourse qué grupo pertenece a qué producto.

  • Ve a Admin > Plugins > Subscriptions y haz clic en la pestaña Products.
  • Haz clic en Create New Product.
  • Introduce un Product Name que coincida exactamente con el Product Name en Stripe (por ejemplo, Enclave Plus).
  • Guarda el producto. En la página del producto, desplázate hacia abajo y haz clic en Add New Plan.
  • Este plan es solo un “puente”. El único campo crítico es User Group.
    • Plan Nickname: Enclave Plus Group Link (o cualquier cosa para tu referencia).
    • User Group: Selecciona el grupo de Discourse correcto del menú desplegable.
    • Los otros campos (Amount, Interval) se pueden dejar por defecto, ya que se ignorarán.
  • Guarda el plan. Repite esto para todos tus diferentes productos.

Resumen de solución de problemas

  • Problema: Los webhooks fallan con un error 404 Not Found.
    • Solución: La URL del endpoint en Stripe es incorrecta. Debe ser https://tu-sitio-discourse.com/s/hooks.
  • Problema: El webhook es exitoso (200 OK) y el pago aparece en el perfil de facturación del usuario, pero no se agrega al grupo.
    • Solución: Tus metadatos son incorrectos. Comprueba tres cosas:
      1. Los metadatos deben estar en el objeto Stripe Price, no en el objeto Product.
      2. La CLAVE de metadatos debe ser exactamente group_name.
      3. El VALOR de metadatos debe ser el slug/identificador único del grupo (por ejemplo, EnclavePlus), no su nombre completo con espacios.

Espero que esta guía ahorre a otros el tiempo y la frustración de esta configuración compleja pero muy potente.

5 Me gusta
713

[quote=“SubStrider, post:712, topic:140818”]
4. Configure el punto de conexión del Webhook (La solución al error 404) Este es el punto de fallo más común.

  • Vaya a **Developers
4 Me gusta
714

La parte clave que falta en la documentación es esta. Lo señalo ya que citaste otra parte.

2 Me gusta
715

¿Hay alguna forma de establecer automáticamente la fecha de anclaje con esto? Si alguien paga, tengo que ajustar manualmente el período de suscripción para que se restablezca el día 1 del mes para cada usuario. La documentación de Stripe dice que se puede hacer con la API al finalizar la compra, pero actualmente no tenemos una forma de ajustarlo en el plugin.

716

Moviendo esto al nuevo hilo ya que podría alargarse a medida que publique actualizaciones.

3 Me gusta
719

:partying_face: Este plugin ahora viene incluido con el núcleo de Discourse como parte de Bundling more popular plugins with Discourse core. Si te autoalojas y usas el plugin, necesitas eliminarlo de tu app.yml antes de tu próxima actualización.

2 Me gusta
720

¿Cómo lo elimino del núcleo? Ya que usaría la bifurcación del plugin que he mejorado.

3 Me gusta
722

Algo como

rm - rf discourse-subscroptions

Antes del git clone.

3 Me gusta
723

Lo siento, no entendí, durante la reconstrucción obtendrá este código de plugin integrado y lo compilará, ¿todo en un solo paso?

725

No he probado esto, pero estoy bastante seguro de que funcionará:

hooks:
  after_code:
    - exec:
        cd: $home/plugins
        cmd:
          - rm -rf discourse-subscriptions
          - git clone https://github.com/yourForkUser/discourse-subscriptions

Dado que esto se ejecuta desde el directorio de plugins, eliminará discourse-subscriptions que ahora está incluido en el núcleo y lo reemplazará con el que siempre has usado antes. Por lo tanto, agregar solo ese rm -rf a tu app.yml antes de tu git clone (para este o cualquier otro plugin que no quieras incluir o quieras reemplazar) debería hacer lo que deseas y reemplazar el plugin principal con tu fork.

6 Me gusta
726

Bien, entonces cuando dicen que el plugin X ahora es parte del núcleo, todo lo que quieren decir es que el plugin vendrá preempaquetado en el repositorio principal en el directorio de plugins y no tendremos que extraer ese código opcionalmente. Entendido. Estructuralmente nada cambia.

1 me gusta
729

Si ahora está preempaquetado. ¿Perderé todos los datos de la versión del plugin? ¿Tendré que configurarlo todo de nuevo o se transferirá?

730

No perderás datos. Simplemente elimina la línea de app.yml y el plugin seguirá funcionando como antes.

1 me gusta
732

¿Se espera que después de ingresar un código de cupón, el monto total de la suscripción no se actualice inmediatamente?

Probado en Discourse 3.5.0.beta8-dev

733

He descubierto que si un usuario intenta registrarse y su pago falla, se elimina la entrada en la tabla discourse_subscriptions_customer que lo asocia con su ID de cliente de Stripe. No estoy seguro de si este comportamiento es intencional, pero en cualquier caso, no creo que sea un buen comportamiento, ya que resulta en clientes huérfanos en Stripe que deben eliminarse manualmente. Esto también da como resultado la creación de clientes duplicados si lo intentan de nuevo, lo que puede afectar nuestros informes.

3 Me gusta
734

¿Hay alguna forma de restablecer la campaña? Esperaba un objetivo de donación mensual, pero es el comienzo de un nuevo mes y no veo una forma de restablecerlo a cero para un nuevo objetivo mensual.

735

Me encantaría ver este plugin en acción en un sitio. ¿Alguien está dispuesto a compartir el enlace a su foro que utiliza el Plugin de Suscripciones? ¡Gracias!