设置 Stripe 或 GoCardless 和直接借记

需要什么

• 俱乐部的 Stripe 账户，已完成全部验证并绑定用于提现的银行账户。
• 在 Stripe 中开启 SEPA Direct Debit 支付方式。
• 在 /admin 管理后台中拥有俱乐部所有者或管理员身份。各列表的直接扣款也只能由他们开启或关闭——列表的管理者和收银员不可以。
• 成员账户上的邮箱地址：每次扣款前的通知和之后的收据都会发送到这些地址。

准备 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 后台的 Developers → Create → Access token 中创建一个具有读写权限的 access token。
3. 在 /admin 中打开“合同与付款”→“在线支付”，在“GoCardless (SEPA-Lastschrift)”卡片中填入 access token（试用时使用 sandbox token 并勾选“Sandbox”），然后点击“验证并保存”。
4. 在 GoCardless 的 Developers → Create → Webhook endpoint 中用卡片下方显示的地址创建 webhook，并将其中显示的密钥填入“Webhook 密钥”字段。这样付款、失败和退单会立即入账，否则在定期对账时处理。该地址仅适用于您的俱乐部，并且只有在保存 access token 后才会显示。如果 GoCardless 中仍是以前的公共地址 …/api/webhooks/gocardless（无后缀），请将 webhook 改为新地址——以前的地址仅在过渡期内继续接受。
5. 如果同时设置了 Stripe 和 GoCardless，请在“在线支付”→“SEPA 直接扣款通过”中选择新授权使用哪一个。已有授权仍留在原服务商。其余一切——扣款日、预先通知、扣款——都相同；会员在 GoCardless 页面输入 IBAN。退单会自动冲回，金额重新变为未结。
6. 入账的付款方式为“直接扣款（GoCardless）”，会计（DATEV）中通过在途资金账户：GoCardless 扣除手续费后批量转账，由出纳在对账时匹配。
7. 除我们的预先通知外，GoCardless 还会向付款人发送自己的邮件（授权确认、每次扣款通知）。如果不希望这样，可以向 GoCardless 申请自定义通知（custom notifications）。
8. 删除 GoCardless 访问权限后，通过它的所有授权都会结束。已通知的扣款取消，会员会收到重新设置直接扣款的邮件。

为列表开启直接借记

1. 在左侧选择列表，打开「运营」→「直接扣款」。
2. 勾选「为此列表提供 SEPA 直接借记」。
3. 选择「每月扣款日」（1 至 28）、「起扣金额」中的最低金额，以及「提前通知（天）」中提前几天通知成员（2 至 14）。
4. 点击「保存」。如果还缺少什么（例如 Stripe），旁边会显示黄色提示。

成员需要做什么

1. 成员在 WebApp 或 App 中打开自己的账户，现在会看到「直接借记」部分。 如果显示的是「你在此列表中还没有成员账户」，说明其登录未关联到该列表的任何账户：请在管理后台的「日记账与账户」→「账户」中为该账户填写其电子邮件地址。
2. 点击「设置直接借记」，会打开 Stripe 的安全页面——在 iPhone、iPad 和 Android 的 App 中于设备浏览器（Safari 或 Chrome）打开。
3. 在那里输入姓名、邮箱和 IBAN，并确认 SEPA 授权。
4. 回到应用后显示「直接借记已启用」及 IBAN 后四位。成员可随时点击「终止直接借记」结束。

扣款流程

• 扣款日前几天（按您设置的天数），每位未付金额达到最低金额的成员会收到邮件，包含金额、扣款日、IBAN 末位和授权参考号。
• 扣款日当天扣款：最多为通知的金额，且不超过届时仍未付的金额。通知之后新增的记账将在下次扣款。
• Stripe 确认付款后才记账——SEPA 需要几个银行工作日。之后成员会通过邮件收到 PDF 结算收据。
• 如果扣款失败（例如余额不足或账户已关闭），金额仍为未付，成员会收到邮件。下个月会再次尝试。
• 如果未付金额低于最低金额，当月不扣款。

/admin 中的总览

• 「运营」→「直接扣款」：所有开通直接借记的成员、状态、IBAN 末位、上次扣款的金额和结果，以及有效授权数和最近失败的扣款数。
• 「日记账与账户」→「付款日记账」：每笔已扣款的付款，支付方式为「Stripe」，并附 PDF 收据。 如果俱乐部不通过 Stripe，而是自己通过银行扣款（例如批量扣款），请在「日记账与账户」→「账户」中以「直接扣款」方式结算这些账户。
• 在 Stripe 后台可查看付款、手续费以及转入您银行账户的款项。

遇到问题时

• 成员看不到「直接借记」部分：此列表未开启直接借记、列表不是欧元，或尚未添加 Stripe。
• 「Der Verein hat Stripe nicht eingerichtet」（德语提示）：按上文在「在线支付」中输入密钥并点击「验证并保存」。
• 「设置尚未完成」：成员没有填完 Stripe 页面。再次点击「设置直接借记」即可。
• Stripe 拒绝或不提供直接借记：请检查 Stripe 中是否已开启 SEPA 直接借记，以及账户是否已完成全部验证。
• 不使用真实资金进行测试：使用测试密钥（sk_test_…）和 Stripe 的测试 IBAN DE89 3704 0044 0532 0130 00。