Plugin de Suscripciones de Discourse

[Discourse]

	Resumen	El plugin Suscripciones de Discourse permite a los propietarios de sitios vender suscripciones recurrentes y de compra única que otorgan acceso a un grupo en una instancia de Discourse.
	Guía de instalación	Este plugin viene incluido en el núcleo de Discourse. No es necesario instalar el plugin por separado.

Al tratarse de un plugin #oficial mantenido por el equipo de Discourse, las solicitudes de #soporte, bug, ux y #funcionalidades pueden realizarse en las categorías correspondientes aquí en Meta, etiquetadas con la etiqueta del plugin adecuada. Haz clic en un enlace a continuación para iniciar uno.

Soporte Error UX Funcionalidad

El plugin Suscripciones de Discourse te permite crear suscripciones de compra única y recurrentes por las que los usuarios pueden pagar para acceder a contenido restringido. Esta puede ser una excelente manera de financiar los costos de alojamiento de tu comunidad.

Funcionalidades

El plugin Suscripciones de Discourse admite las siguientes características:

• Crear nuevos productos y planes desde el panel de administración
• Cancelar y reembolsar suscripciones desde el panel de administración
• Crear planes de suscripción de compra única o recurrente
• Agregar pruebas gratuitas en suscripciones recurrentes
• Soporte SCA/3D Secure
• Agregar/eliminar usuarios de los grupos de planes a medida que se suscriben o cancelan
• Cancelar suscripción desde el perfil del usuario
• Cancelación de la suscripción al final del período de suscripción
• Soporte opcional para Stripe Checkout
• Cálculo y recaudación automática de impuestos sobre las ventas
• Los usuarios pueden actualizar su tarjeta para suscripciones individuales

El botón “Suscribirse” ubicado en la navegación superior te llevará a la página de Suscripción /s, donde se listan las suscripciones que has configurado para tu sitio:

Una vez que un usuario hace clic en uno de los botones “Suscribirse” para un plan específico, se abrirá la página de pago para ese plan:

Después de que un usuario complete sus datos de pago y su dirección y haga clic en “Suscribirse”, se le mostrará un mensaje de “¡Gracias!” y será llevado a su página de facturación:

El usuario también se agrega automáticamente a un grupo de tu elección para que puedas ver fácilmente qué usuarios se han suscrito, así como proporcionar contenido restringido en categorías que solo ese grupo puede ver.

Términos

• Suscripción - Las suscripciones son un plan de pago recurrente que te permite controlar el acceso al contenido en tu comunidad. Cuando se crea o elimina una suscripción, un usuario se agrega o elimina del grupo de usuarios que asocias con tu plan de suscripción. Una suscripción se compone de un producto y planes.
• Producto - Un producto, en términos de Stripe, es lo que estás vendiendo. Un producto puede contener uno o más planes.
  • Para agregar una descripción a tu producto, agrega un campo de metadatos llamado “description” y úsalo en su lugar. Puedes usar Markdown.
• Plan - Un plan contiene un precio, un ciclo recurrente y se asocia con un grupo al cual tus suscriptores obtienen acceso.

Ten mucho cuidado de mantener tus claves privadas de Stripe seguras y protegidas en todo momento.

Si apagas tu instancia de Discourse, desinstalas este plugin o tu sitio se queda sin conexión, Stripe seguirá cobrando a tus clientes por tu servicio hasta que se cancele la suscripción.

Configuración

1. Instala y habilita el plugin
2. Configura la pasarela de pago (Stripe)
3. Configura Webhooks y Eventos en Stripe
4. Agrega tus claves de Stripe (pública, secreta, secreto del webhook) en Admin > Plugins > Instalados > Suscripciones > Configuración /admin/site_settings/category/discourse_subscriptions?filter=plugin%3Adiscourse-subscriptions.
5. Crea un grupo para que tus suscriptores se unan mediante la compra
6. Crea un producto y un plan en Admin > Plugins > Suscripciones
7. ¡A ganar dinero!

Configura tu pasarela de pago.

En primer lugar, necesitarás una cuenta con la pasarela de pago Stripe. Para empezar, puedes configurar una cuenta en modo de prueba y ver cómo funciona todo sin realizar transacciones reales ni tener que configurar una cuenta bancaria. No hay un interruptor de modo de prueba en el plugin; en su lugar, asegúrate de usar tus claves de desarrollador (comienzan con pk_test, sk_test)

Configura Webhooks y Eventos en tu cuenta de Stripe

Los Webhooks son necesarios para que las cancelaciones de suscripción funcionen completamente. Asegúrate de haberlos configurado correctamente.

Una vez que tengas una cuenta en Stripe, necesitarás indicarle a Stripe la dirección de tu sitio web para que pueda notificarte sobre ciertas transacciones. Puedes ingresar esto en tu panel de control de Stripe en Endpoints > URL.

Dirección del Webhook: [tu dirección de servidor]/s/hooks – donde [tu dirección de servidor] es la URL de tu instalación de Discourse.

También necesitarás decirle a Stripe qué eventos debe notificarte a través de la URL del webhook.

Actualmente, Suscripciones de Discourse responde a los siguientes eventos:

• customer.subscription.deleted
• customer.subscription.updated
• checkout.session.completed

Agrega las claves API y Webhook de Stripe a la configuración de tu plugin

Stripe necesita estar autorizado para comunicarse con tu sitio web. Para hacer esto, publica un par de claves API privadas y públicas y un secreto de firma para tus webhooks.

Para autorizar webhooks, agrega las claves API y el secreto del webhook de Stripe a tu página de configuración (en Desarrolladores).

Agregar claves de producción realizará pagos en vivo. Si planeas probar, asegúrate de cambiar al modo Ver datos de prueba y obtener las claves pk_test y sk_test en Desarrolladores.

En la configuración de tu cuenta de Stripe, consulta:

• https://dashboard.stripe.com/apikeys
• https://dashboard.stripe.com/webhooks

Agrega estas claves en la configuración apropiada en Admin > Plugins > Instalados > Suscripciones > Configuración /admin/site_settings/category/discourse_subscriptions?filter=plugin%3Adiscourse-subscriptions.

Configura tus Grupos de Usuarios en Discourse

Cuando un usuario se suscribe correctamente a tu aplicación de Discourse, después de que se haya procesado su transacción con tarjeta de crédito, se agrega a un Grupo de Usuarios. Al asignar usuarios a un Grupo de Usuarios, puedes gestionar a qué tienen acceso tus usuarios en tu sitio web. Los grupos de usuarios son una funcionalidad central de Discourse y este plugin no hace nada con ellos excepto agregar y eliminar usuarios del grupo que asociaste con tu Plan.

Crea uno o más productos con planes.

En Admin > Plugins > Suscripciones, haz clic en agregar un nuevo Producto. Una vez que hayas guardado un producto, puedes agregarle planes. Ten en cuenta que los precios y los intervalos de facturación de los planes no se pueden cambiar una vez que los creas. Esto es para evitar confusiones en la gestión de suscripciones.

Si echas un vistazo a tu Panel de control de Stripe, verás que todos esos productos y planes están listados. Suscripciones de Discourse no los crea localmente. Se crean en Stripe.

Pruebas

Prueba con estos números de tarjeta de crédito:

• 4242 4242 4242 4242
• 4111 1111 1111 1111 (sin autenticación requerida)
• 4000 0027 6000 3184 (autenticación requerida)

Para más números de tarjeta de prueba: Test card numbers | Stripe Documentation

Visita /s e introduce algunas transacciones de prueba.

Puesta en producción

Una vez que estés listo para ir en vivo, cambia tus claves API y de secreto de webhook por claves de producción. Necesitarás crear nuevos productos y planes en modo en vivo.

Ten en cuenta que si no configuras correctamente los webhooks de Stripe y los pagos recurrentes no se procesan por alguna razón (tarjeta de crédito vencida, etc.), los usuarios seguirán teniendo acceso al grupo. Para que Stripe cancele automáticamente las suscripciones, asegúrate de configurar tus Gestionar pagos fallidos de manera similar a la imagen a continuación y configura los webhooks como se describe anteriormente.

Actualizar información de pago

Los usuarios pueden actualizar su tarjeta utilizada para suscripciones individuales visitando la página de facturación y haciendo clic en el botón de editar junto a la suscripción, lo que abrirá esta pantalla:

Stripe Checkout con Tablas de precios de Stripe

También puedes optar por reemplazar las páginas de productos y checkout del plugin Suscripciones y usar en su lugar Stripe Checkout con Tablas de precios de Stripe.

En tu panel de control de Stripe:

1. Después de crear los productos en Discourse, ve a Productos > Catálogo de productos
2. Haz clic en el producto que deseas incluir en la tabla de precios
3. Haz clic en Editar producto
4. Más opciones e ingresa lo siguiente en Metadatos:
   • Clave: group_name
   • Valor: El nombre del grupo en Discourse (por ejemplo, trust_level_0)
5. Haz clic en Actualizar producto para guardar

Asegúrate de que el nombre del grupo coincida con el grupo seleccionado en User_Groups en Discourse

Crea tu tabla de precios de Stripe

1. Ve a Productos > Tablas de precios
2. Crea una nueva tabla y agrega los productos que acabas de crear
3. Después de publicar la tabla, copia el ID de la tabla de precios que se encuentra dentro del código de inserción (comienza con prctbl_...)
4. Pega el ID de la tabla de precios en tu discourse_subscriptions_pricing_table_id y habilita la configuración de la tabla de precios de suscripciones.
5. Haz clic en las marcas de verificación verdes para guardar ambas configuraciones.

Paso recomendado:

Al configurar la Tabla de precios dentro de Stripe, se recomienda vincular al usuario a tu sitio después de completar el checkout, de lo contrario permanecerán en una página de confirmación de Stripe sin un enlace de regreso a tu sitio.

Redirigir a https://<tu-sitio>/my/billing/subscriptions es una buena opción para suscripciones. Para pagos únicos, podrías enlazar directamente a https://<tu-sitio>/my/billing/payments.

Recaudación automática de impuestos

Para habilitar la recaudación automática de impuestos, marca la casilla de Configuración del sitio para discourse_subscriptions_enable_automatic_tax.

Si la habilitas, pero no has configurado correctamente tu instancia de Stripe para recaudar impuestos, los usuarios podrían ver esta ventana emergente después de completar el proceso de checkout:

Hay esta guía para más información, pero no debería haber mucho que hacer ya que el plugin ahora está pasando el parámetro automatic_tax[enabled]=true apropiado (paso 5).

Asegúrate de configurar tus registros (paso 4) también:

Aquí hay un ejemplo de transacción del plugin Suscripciones de Discourse en Stripe que muestra que se recaudaron impuestos automáticamente:

Configuración

Nombre	Descripción
discourse subscriptions enabled	Habilita el plugin Suscripciones de Discourse.
discourse subscriptions extra nav subscribe	Muestra el botón Suscribirse en la navegación principal
discourse subscriptions public key	Clave pública de Stripe
discourse subscriptions secret key	Clave secreta de Stripe
discourse subscriptions webhook secret	Secreto del webhook de Stripe
discourse subscriptions currency	Código de moneda predeterminado. Esto puede ser sobrescrito al crear un plan de suscripción.
discourse subscriptions campaign enabled	Habilita un banner de campaña para promover el apoyo financiero a esta comunidad.
discourse subscriptions campaign goal	La meta numérica para tu campaña de apoyo (suscriptores o monto recaudado).
discourse subscriptions campaign type	Selecciona el tipo de campaña a ejecutar (suscriptores o monto mensual recaudado).
discourse subscriptions campaign banner location	Selecciona la ubicación del banner de la campaña (superior o barra lateral).
discourse subscriptions campaign banner bg image	Sube una imagen personalizada para usar como fondo en el banner de la campaña.
discourse subscriptions campaign banner shadow color	Selecciona el color de la sombra del banner de la campaña.
discourse subscriptions campaign show contributors	Muestra los avatares de las compras más recientes de productos de suscripción.
discourse subscriptions campaign product	El ID del producto de Stripe para enviar a los seguidores cuando hacen clic en el botón de la campaña. Si esta configuración está en blanco, los seguidores serán dirigidos a la página principal de productos.
discourse subscriptions campaign grant	Otorga al usuario un mes gratis de suscripciones
discourse subscriptions pricing table id	El ID de la tabla de precios de Stripe del código de inserción
discourse subscriptions pricing table enabled	Habilita el uso de la tabla de precios de Stripe y reemplaza la página de suscripción existente
discourse_subscriptions_enable_automatic_tax	Alterna si se va a recaudar el impuesto sobre las ventas. Requiere cierta configuración en Stripe.
discourse_subscriptions_enable_verbose_logging	Habilita un registro más detallado para ayudar en la depuración. Por favor, no lo dejes habilitado permanentemente en producción.

¿Alojado por nosotros? Este plugin está disponible en nuestros planes de alojamiento Pro, Business y Enterprise Subscriptions | Discourse - Civilized Discussion