Complemento de suscripciones de Discourse

[Discourse]

	Resumen	El plugin Discourse Subscriptions permite a los propietarios del sitio vender suscripciones recurrentes y de pago único 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.

Dado que este es un plugin #oficial mantenido por el equipo de Discourse, las solicitudes de Support, Contribute > Bug, Contribute > UX y Contribute > Feature pueden realizarse en las respectivas categorías aquí en Meta y etiquetarse con la etiqueta de plugin correspondiente. Haz clic en un enlace a continuación para comenzar.

Soporte Error UX Función

El plugin Discourse Subscriptions te permite crear suscripciones de pago único y recurrentes que los usuarios pueden pagar para acceder a contenido restringido. Esta puede ser una excelente manera de financiar el costo de alojamiento de tu comunidad.

Funciones

El plugin Discourse Subscriptions admite las siguientes funciones:

• 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 pago único o recurrentes
• Agregar pruebas gratuitas en suscripciones recurrentes
• Soporte para SCA/3D Secure
• Agregar/eliminar usuarios de los grupos de planes a medida que se suscriben/cancelan
• Cancelar suscripción desde el perfil de usuario
• Cancelación de la suscripción al final del período de suscripción
• Soporte opcional para Stripe Checkout
• Cálculo y cobro automático 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 enumeran 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 y para 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 está compuesta por un producto y planes.
• Producto - Un producto en los 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 usa ese en su lugar. Puedes usar Markdown.
• Plan - Un plan contiene un precio, un ciclo recurrente y se asocia con un grupo al que tus suscriptores obtienen acceso.

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

Si cerraras tu instancia de Discourse, desinstalaras este plugin o tu sitio se fuera de línea, Stripe continuará 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, secreta de webhook) en Administración > Plugins > Instalados > Subscriptions > 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 Administración > Plugins > Subscriptions
7. ¡Gana dinero!

Configura tu pasarela de pago.

En primer lugar, necesitarás una cuenta con la pasarela de pago Stripe. Para comenzar, 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 cambio, 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 que estén configurados correctamente.

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

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

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

Actualmente, Discourse Subscriptions responde a los siguientes eventos:

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

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

Stripe debe 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 los webhooks, agrega las claves de API y el secreto de webhook de Stripe a tu página de configuración (bajo Developers).

Agregar claves de producción realizará pagos en vivo. Si planeas probar, asegúrate de cambiar al modo View test data y obtener las claves pk_test y sk_test bajo Developers.

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

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

Agrega estas claves bajo la configuración correspondiente en Administración > Plugins > Instalados > Subscriptions > 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 la transacción de su 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 Administración > Plugins > Subscriptions, haz clic en agregar un nuevo Producto. Una vez que tengas un producto guardado, 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 miras tu Panel de Stripe, verás que todos esos productos y planes están enumerados. Discourse Subscriptions 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 (no requiere autenticación)
• 4000 0027 6000 3184 (requiere autenticación)

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

Visita /s e ingresa algunas transacciones de prueba.

Puesta en marcha

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

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 aún tendrán acceso al grupo. Para que Stripe cancele automáticamente las suscripciones, asegúrate de configurar tus ajustes de Gestión de pagos fallidos de manera similar a la imagen de abajo y configura los webhooks como se describe arriba.

Actualizar información de pago

Los usuarios pueden actualizar la tarjeta utilizada para suscripciones individuales visitando la página de facturación y haciendo clic en el botón de edición 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 producto y pago del plugin de suscripciones y usar en su lugar Stripe Checkout con Tablas de precios de Stripe.

En tu panel de Stripe:

1. Después de haber creado 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 bajo 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 que está seleccionado bajo 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 encontrado 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 que se complete el pago, de lo contrario se quedará en una página de confirmación de Stripe sin un enlace de vuelta a tu sitio.

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

Recopilación automática de impuestos

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

Si lo habilitas, pero no has configurado correctamente tu instancia de Stripe para recopilar impuestos, los usuarios pueden ver esta ventana emergente después de completar el proceso de pago:

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 también tus registros (paso 4):

Aquí hay un ejemplo de transacción del plugin de suscripción de Discourse en Stripe que muestra que se recopiló automáticamente el impuesto:

Configuración

Nombre	Descripción
discourse subscriptions enabled	Habilita el plugin Discourse Subscriptions.
discourse subscriptions extra nav subscribe	Muestra el botón de suscripción 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 de Webhook de Stripe
discourse subscriptions currency	Código de moneda predeterminado. Esto se puede sobrescribir 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	El objetivo numérico para tu campaña de apoyo (suscriptores o cantidad recaudada).
discourse subscriptions campaign type	Selecciona el tipo de campaña a ejecutar (suscriptores o cantidad mensual recaudada).
discourse subscriptions campaign banner location	Selecciona la ubicación del banner de campaña (arriba o barra lateral).
discourse subscriptions campaign banner bg image	Sube una imagen personalizada para usarla como fondo en el banner de campaña.
discourse subscriptions campaign banner shadow color	Selecciona el color de la sombra del banner de 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 de producto de Stripe para enviar a los supporters cuando hacen clic en el botón de la campaña. Si esta configuración está en blanco, los supporters 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 recopilar el impuesto sobre las ventas. Requiere cierta configuración en Stripe.
discourse_subscriptions_enable_verbose_logging	Habilita registros más detallados para ayudar en la depuración. Por favor, no lo deje habilitado permanentemente en producción.

¿¿Nosotros te alojamos? Este plugin está disponible en nuestros planes de alojamiento Pro, Business y Enterprise Subscriptions | Discourse - Civilized Discussion