Настройка Stripe или GoCardless и прямого дебета

Что нужно

• Аккаунт Stripe для клуба, полностью проверенный и с банковским счётом для выплат.
• Способ оплаты SEPA Direct Debit, включённый в Stripe.
• Доступ владельца или администратора клуба в разделе «Администрирование» (/admin). Включать и выключать прямое списание для списка тоже могут только они – не менеджеры и не кассиры списка.
• Адреса e-mail у счетов участников: на них приходят уведомление перед каждым списанием и затем квитанция.

Подготовить Stripe

1. Войдите на dashboard.stripe.com или создайте там аккаунт для клуба.
2. Завершите проверку: данные клуба, законный представитель и банковский счёт, на который выплачивает Stripe. Пока этого нет, Stripe ничего не может списать.
3. В Stripe откройте настройки способов оплаты и включите прямой дебет SEPA.
4. В Stripe откройте Developers → API keys и скопируйте секретный ключ (начинается с sk_live_). Вводите его только в месте, описанном ниже, и никому не передавайте.

Добавить Stripe в управление

1. Откройте /admin, выберите слева клуб и перейдите в «Договор и платежи» → «Онлайн-оплата».
2. Введите секретный ключ в карточке «Stripe».
3. Нажмите «Проверить и сохранить». Мы сразу проверяем ключ в Stripe, сохраняем его в зашифрованном виде и потом показываем только последние символы.
4. Необязательно: под карточкой теперь появился адрес webhook. Создайте в Stripe webhook с этим адресом, введите его секрет (whsec_…) в поле «Секрет webhook (необязательно, whsec_…)» и нажмите «Заменить доступ». Для прямого дебета это не нужно; так быстрее приходят сведения о возвратах.

Альтернатива: GoCardless вместо Stripe

1. Вместо Stripe клуб может проводить прямое дебетование и через собственный аккаунт GoCardless (manage.gocardless.com). GoCardless перечисляет деньги на банковский счёт клуба и берёт свою комиссию за каждое списание.
2. В панели GoCardless создайте access token с правами чтения и записи: Developers → Create → Access token.
3. В /admin откройте «Договор и платежи» → «Онлайн-оплата», введите access token в карточке «GoCardless (SEPA-Lastschrift)» (для пробы — sandbox-токен и флажок «Sandbox») и нажмите «Проверить и сохранить».
4. В GoCardless создайте вебхук: Developers → Create → Webhook endpoint с адресом, указанным под карточкой, и введите показанный там секрет в поле «Секрет вебхука». Тогда платежи, отказы и возвраты учитываются сразу, иначе — при регулярной сверке. Адрес действует только для вашего клуба и появляется только после сохранения токена доступа. Если в GoCardless ещё указан прежний общий адрес …/api/webhooks/gocardless (без добавки), измените вебхук на новый адрес – прежний принимается только временно.
5. Если настроены и Stripe, и GoCardless, выберите в «Онлайн-оплата» → «Прямое дебетование SEPA через», через кого идут новые мандаты. Существующие мандаты остаются у прежнего провайдера. Всё остальное — день списания, уведомление, списание — так же; участник вводит IBAN на странице GoCardless. Возврат платежа сторнируется автоматически, и сумма снова становится открытой.
6. Проводка идёт со способом оплаты «Прямое дебетование (GoCardless)», в бухгалтерии (DATEV) — через транзитный счёт: GoCardless перечисляет деньги пакетами за вычетом комиссии, казначей сопоставляет выплату при сверке.
7. GoCardless отправляет плательщикам собственные письма (подтверждение мандата, уведомление о каждом списании) в дополнение к нашему уведомлению. Если вы этого не хотите, можно запросить у GoCardless собственные уведомления (custom notifications).
8. Если удалить доступ GoCardless, все мандаты через него завершаются. Объявленные списания отменяются, а участники получают письмо с просьбой заново настроить прямое дебетование.

Включить прямой дебет для списка

1. Выберите слева список и откройте «Работа» → «Прямое списание».
2. Поставьте галочку «Предлагать прямой дебет SEPA для этого списка».
3. Выберите «День списания в месяце» (от 1 до 28), минимальную сумму в «Списывать от» и в «Уведомление (дней до)», за сколько дней участники узнают о списании (от 2 до 14).
4. Нажмите «Сохранить». Если чего-то ещё не хватает – например Stripe, – рядом появится жёлтое предупреждение.

Что делают участники

1. Участник открывает свой счёт в WebApp или приложении. Там теперь есть раздел «Прямой дебет». Если вместо этого написано «У тебя пока нет счёта участника в этом списке», его вход не связан ни с одним счётом списка: укажите его e-mail у счёта в «Управлении» в разделе «Журналы и счета» → «Счета».
2. Он нажимает «Подключить прямой дебет». Открывается защищённая страница Stripe – в приложении на iPhone, iPad и Android в браузере устройства (Safari или Chrome).
3. Там он вводит имя, e-mail и IBAN и подтверждает мандат SEPA.
4. Вернувшись в приложение, он видит «Прямой дебет активен» с последними четырьмя цифрами IBAN. Отключить его можно в любой момент кнопкой «Отключить прямой дебет».

Как проходит списание

• За несколько дней до дня списания – столько, сколько вы указали, – каждый участник с открытой суммой не ниже минимальной получает письмо с суммой, днём списания, окончанием IBAN и номером мандата.
• В день списания списывается не больше объявленной суммы и не больше того, что ещё открыто. То, что добавилось после уведомления, уйдёт со следующим списанием.
• Проводка создаётся, когда Stripe подтвердит платёж – для SEPA это несколько банковских рабочих дней. Затем участник получает квитанцию о расчёте в PDF по e-mail.
• Если списание не прошло (например, не хватило средств или счёт закрыт), сумма остаётся открытой, а участник получает письмо. В следующем месяце будет новая попытка.
• Если открытая сумма ниже минимальной, в этом месяце ничего не списывается.

Обзор в /admin

• «Работа» → «Прямое списание»: все участники с прямым дебетом, статус, окончание IBAN, последнее списание с суммой и результатом, а также число активных мандатов и недавно не прошедших списаний.
• «Журналы и счета» → «Журнал платежей»: каждый полученный платёж со способом «Stripe» и квитанцией в PDF. Если клуб списывает деньги сам через свой банк без Stripe (например, пакетным списанием), рассчитайте счета в «Журналы и счета» → «Счета» со способом «Прямое списание».
• В панели Stripe видны платежи, комиссии и выплаты на ваш банковский счёт.

Если что-то не получается

• Участник не видит раздел «Прямой дебет»: прямой дебет для этого списка не включён, список не в евро или Stripe ещё не добавлен.
• «Der Verein hat Stripe nicht eingerichtet» (сообщение на немецком): введите секретный ключ в «Онлайн-оплата», как описано выше, и нажмите «Проверить и сохранить».
• «Подключение ещё не завершено»: участник не заполнил страницу Stripe до конца. Достаточно ещё раз нажать «Подключить прямой дебет».
• Stripe отклоняет прямой дебет или не предлагает его: проверьте, что прямой дебет SEPA включён в Stripe и аккаунт полностью проверен.
• Попробовать без настоящих денег: с тестовым ключом (sk_test_…) и тестовым IBAN Stripe DE89 3704 0044 0532 0130 00.