Плагин подписок для Discourse

[Discourse]

	Сводка	Плагин Discourse Subscriptions позволяет владельцам сайтов продавать подписки с регулярными и разовыми платежами, предоставляющими доступ к группе на инстансе Discourse.
	Руководство по установке	Этот плагин входит в ядро Discourse. Отдельная установка плагина не требуется.

Поскольку это #официальный плагин, поддерживаемый командой Discourse, запросы на #поддержку, #внесение изменений:bug, #внесение изменений:ux и #внесение изменений:feature можно направлять в соответствующие категории здесь на Meta, помечая их соответствующим тегом плагина. Нажмите на ссылку ниже, чтобы начать.

Поддержка Ошибка UX Функция

Плагин Discourse Subscriptions позволяет создавать разовые, а также регулярные подписки, за которые пользователи могут платить для доступа к защищенному контенту. Это может быть отличным способом покрыть расходы на хостинг вашего сообщества.

Функции

Плагин Discourse Subscriptions поддерживает следующие функции:

• Создание новых продуктов и тарифных планов из админ-панели
• Отмена и возврат средств за подписки из админ-панели
• Создание тарифных планов с разовым платежом или регулярными подписками
• Добавление бесплатных пробных периодов для регулярных подписок
• Поддержка SCA/3D Secure
• Добавление/удаление пользователей из групп тарифных планов при их подписке/отмене
• Отмена подписки из профиля пользователя
• Отмена подписки в конце периода подписки
• Необязательная поддержка Stripe Checkout
• Автоматический расчет и сбор налога на продажи
• Пользователи могут обновлять свои карты для отдельных подписок

Кнопка «Подписаться», расположенная в верхней навигации, перенаправит вас на страницу подписки /s, где перечислены настроенные вами для сайта подписки:

Когда пользователь нажимает на одну из кнопок «Подписаться» для конкретного тарифного плана, открывается страница оплаты для этого плана:

После того, как пользователь заполнит свои платежные данные и адрес и нажмет «Подписаться», ему будет показано сообщение «Спасибо!» и он будет перенаправлен на свою страницу выставления счетов:

Пользователь также автоматически добавляется в выбранную вами группу, чтобы вы могли легко видеть, какие пользователи подписались, а также предоставлять защищенный контент в категориях, видимых только этой группе.

Термины

• Подписка (Subscription) - Подписки — это план регулярных платежей, который позволяет вам контролировать доступ к контенту в вашем сообществе. Когда подписка создается или удаляется, пользователь добавляется или удаляется из группы пользователей, связанной с вашим тарифным планом подписки. Подписка состоит из продукта и тарифных планов.
• Продукт (Product) - В терминологии Stripe продукт — это то, что вы продаете. Продукт может содержать один или несколько тарифных планов.
  • Чтобы добавить описание к вашему продукту, добавьте поле метаданных с именем «description» и используйте его вместо этого. Вы можете использовать Markdown.
• Тарифный план (Plan) - Тарифный план содержит цену, цикл регулярных платежей и ассоциируется с группой, к которой получают доступ ваши подписчики.

Будьте очень осторожны и всегда храните ваши приватные ключи Stripe в безопасности.

Если вы закроете ваш инстанс Discourse, удалите этот плагин или ваш сайт выйдет из сети, Stripe продолжит выставлять счета вашим клиентам за вашу услугу, пока подписка не будет отменена.

Конфигурация

1. Установите и включите плагин
2. Настройте платежный шлюз (Stripe)
3. Настройте вебхуки и события в Stripe
4. Добавьте ваши ключи Stripe (публичный, секретный, секрет вебхука) в разделе Админ > Плагины > Установленные > Subscriptions > Настройки /admin/site_settings/category/discourse_subscriptions?filter=plugin%3Adiscourse-subscriptions.
5. Создайте группу, в которую пользователи будут вступать посредством покупки
6. Создайте продукт и тарифный план в разделе Админ > Плагины > Subscriptions
7. Зарабатывайте!

Настройте ваш платежный шлюз.

Во-первых, вам понадобится аккаунт в платежном шлюзе Stripe. Чтобы начать, вы можете настроить аккаунт в режиме тестирования и посмотреть, как все работает, не совершая реальных транзакций и не создавая банковский счет. В плагине нет переключателя режима тестирования; вместо этого убедитесь, что вы используете свои ключи разработчика (они начинаются с pk_test, sk_test)

Настройте вебхуки и события в вашем аккаунте Stripe

Вебхуки необходимы для полной работы отмены подписок. Убедитесь, что вы настроили их правильно.

Когда у вас будет аккаунт в Stripe, вам нужно будет сообщить Stripe адрес вашего сайта, чтобы он мог уведомлять вас о определенных транзакциях. Вы можете ввести это в вашей панели Stripe в разделе Endpoints > URL.

Адрес вебхука: [адрес вашего сервера]/s/hooks – где [адрес вашего сервера] — это URL вашего инсталляции Discourse.

Вам также нужно будет сообщить Stripe, о каких событиях он должен уведомлять вас через URL вебхука.

В настоящее время Discourse Subscriptions реагирует на следующие события:

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

Добавьте ключи API и вебхука Stripe в настройки вашего плагина

Stripe должен быть авторизован для общения с вашим сайтом. Для этого он публикует пару приватных и публичных ключей API и секрет подписи для ваших вебхуков.

Чтобы авторизовать вебхуки, добавьте ключи API и секрет вебхука из Stripe на вашу страницу настроек (в разделе Developers).

Добавление ключей production приведет к реальным платежам. Если вы планируете тестировать, убедитесь, что переключились в режим View test data и получили ключи pk_test и sk_test в разделе Developers.

В настройках вашего аккаунта Stripe см.:

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

Добавьте эти ключи в соответствующие настройки в разделе Админ > Плагины > Установленные > Subscriptions > Настройки /admin/site_settings/category/discourse_subscriptions?filter=plugin%3Adiscourse-subscriptions.

Настройте ваши группы пользователей в Discourse

Когда пользователь успешно подписывается на ваше приложение Discourse, после обработки транзакции по кредитной карте, он добавляется в группу пользователей. Назначая пользователей группе пользователей, вы можете управлять тем, к чему имеют доступ ваши пользователи на вашем сайте. Группы пользователей являются основной функцией Discourse, и этот плагин ничего с ними не делает, кроме добавления и удаления пользователей из группы, которую вы ассоциировали с вашим Тарифным планом.

Создайте один или несколько продуктов с тарифными планами.

В разделе Админ > Плагины > Subscriptions, нажмите «Добавить новый продукт». После сохранения продукта вы можете добавить к нему тарифные планы. Помните, что цены и интервалы выставления счетов тарифных планов не могут быть изменены после их создания. Это сделано, чтобы избежать путаницы в управлении подписками.

Если вы посмотрите на вашу Панель Stripe, вы увидите, что все эти продукты и тарифные планы перечислены там. Discourse Subscriptions не создает их локально. Они создаются в Stripe.

Тестирование

Тестируйте с этими номерами кредитных карт:

• 4242 4242 4242 4242
• 4111 1111 1111 1111 (без необходимости аутентификации)
• 4000 0027 6000 3184 (требуется аутентификация)

Для получения дополнительных тестовых номеров карт: Test card numbers | Stripe Documentation

Посетите /s и введите несколько тестовых транзакций.

Переход в боевой режим

Когда вы будете готовы перейти в боевой режим, измените ваши ключи API и секреты вебхука на ключи production. Вам нужно будет создать новые продукты и тарифные планы в живом режиме.

Обратите внимание, что, если вы не правильно настроите вебхуки Stripe, и регулярные платежи не будут обработаны по какой-либо причине (истекшая кредитная карта и т.д.), пользователи все равно будут иметь доступ к группе. Чтобы Stripe автоматически отменял подписки, убедитесь, что ваши настройки Управление неудачными платежами подобны изображению ниже, и настройте вебхуки, как описано выше.

Обновление платежных данных

Пользователи могут обновлять свою карту, используемую для отдельных подписок, посетив страницу выставления счетов и нажав кнопку редактирования рядом с подпиской, что откроет этот экран:

Stripe Checkout с таблицами ценообразования Stripe

Вы также можете выбрать замену страниц продукта и оформления заказа плагина Subscriptions и вместо этого использовать Stripe Checkout с таблицами ценообразования Stripe.

В вашей панели Stripe:

1. После создания продуктов в Discourse, перейдите в Products > Product catalog
2. Нажмите на продукт, который вы хотите включить в таблицу ценообразования
3. Нажмите Edit product
4. More Options и введите следующее в разделе Metadata:
   • Key: group_name
   • Value: Название группы в Discourse (например, trust_level_0)
5. Нажмите Update product, чтобы сохранить

Убедитесь, что название группы совпадает с группой, выбранной в User_Groups в Discourse

Создайте вашу таблицу ценообразования Stripe

1. Перейдите в Products > Pricing tables
2. Создайте новую таблицу и добавьте только что созданные продукты
3. После публикации таблицы скопируйте ID таблицы ценообразования, найденный внутри кода встраивания (он начинается с prctbl_...)
4. Вставьте ID таблицы ценообразования в discourse_subscriptions_pricing_table_id и включите настройку таблицы ценообразования подписок.
5. Нажмите зеленые галочки, чтобы сохранить обе настройки.

Рекомендуемый шаг:

При настройке таблицы ценообразования внутри Stripe рекомендуется перенаправлять пользователя на ваш сайт после завершения оформления заказа, иначе он останется на странице подтверждения Stripe без ссылки на ваш сайт.

Перенаправление на https://<ваш-сайт>/my/billing/subscriptions — хороший выбор для подписок. Для разовых платежей вы можете напрямую связать с https://<ваш-сайт>/my/billing/payments.

Автоматический сбор налогов

Чтобы включить автоматический сбор налогов, отметьте флажок настройки сайта discourse_subscriptions_enable_automatic_tax.

Если вы включите его, но не правильно настроите ваш инстанс Stripe для сбора налогов, пользователи могут увидеть это всплывающее окно после завершения процесса оформления заказа:

Есть это руководство для получения дополнительной информации, но делать не должно быть много, так как плагин теперь передает соответствующий параметр automatic_tax[enabled]=true (шаг 5).

Убедитесь, что вы также настроили ваши регистрации (шаг 4):

Вот пример транзакции плагина подписки Discourse в Stripe, показывающий, что налог был автоматически собран:

Настройки

Название	Описание
discourse subscriptions enabled	Включить плагин Discourse Subscriptions.
discourse subscriptions extra nav subscribe	Показывать кнопку подписки в основной навигации
discourse subscriptions public key	Публичный ключ Stripe
discourse subscriptions secret key	Секретный ключ Stripe
discourse subscriptions webhook secret	Секрет вебхука Stripe
discourse subscriptions currency	Код валюты по умолчанию. Это можно переопределить при создании тарифного плана подписки.
discourse subscriptions campaign enabled	Включает баннер кампании для продвижения финансовой поддержки этого сообщества.
discourse subscriptions campaign goal	Числовая цель вашей кампании поддержки (подписчики или собранная сумма).
discourse subscriptions campaign type	Выбирает тип кампании для проведения (подписчики или ежемесячная собранная сумма).
discourse subscriptions campaign banner location	Выбирает расположение баннера кампании (сверху или в боковой панели).
discourse subscriptions campaign banner bg image	Загрузите пользовательское изображение для использования в качестве фона на баннере кампании.
discourse subscriptions campaign banner shadow color	Выбирает цвет тени баннера кампании.
discourse subscriptions campaign show contributors	Показывать аватары последних покупок продуктов подписки.
discourse subscriptions campaign product	ID продукта Stripe, который отправляется сторонникам, когда они нажимают кнопку на кампании. Если эта настройка пуста, сторонников направят на главную страницу продуктов.
discourse subscriptions campaign grant	Предоставляет пользователю бесплатный месяц подписки
discourse subscriptions pricing table id	ID таблицы ценообразования Stripe из кода встраивания
discourse subscriptions pricing table enabled	Включает использование таблицы ценообразования Stripe и заменяет существующую страницу подписки
discourse_subscriptions_enable_automatic_tax	Переключает, будет ли сбор налога на продажи. Требуется некоторая настройка в Stripe.
discourse_subscriptions_enable_verbose_logging	Включает более подробное журналирование для помощи в отладке. Пожалуйста, не оставляйте это включенным постоянно в production.

Хостинг у нас? Этот плагин доступен в наших планах хостинга Pro, Business и Enterprise Subscriptions | Discourse - Civilized Discussion