使用 PayPal 和 PayPal.me 付款

PayPal 还是 PayPal.me——区别

• PayPal（在线）：俱乐部在管理后台中一次性连接其 PayPal 账户。会员在 WebApp 或 App 中点击“使用 PayPal 支付”，在 PayPal 页面付款，款项自动记入其账户，并通过电子邮件收到 PDF 收据。
• PayPal.me（付款链接）：俱乐部只填写一个地址，例如 https://paypal.me/club/{amount}EUR。会员会看到一个按钮，打开已填好金额的 PayPal。我们不会得知这笔付款——收银员在 PayPal 中看到后手动结算账户。
• 建议：如果收银员不应手动补录，选择 PayPal（在线）。如果俱乐部不想在 PayPal Developer 创建应用，且可以接受手动记账，选择 PayPal.me。
• 两者可以同时使用。会员会看到两个按钮。

您需要

• 俱乐部的 PayPal 账户。PayPal（在线）还需要 PayPal Developer 的访问权限以创建应用；所需账户类型由 PayPal 决定。
• 在 /admin 管理后台中具有俱乐部所有者或管理员权限——只有这些角色可以更改支付凭据和付款链接。
• 结算 PayPal.me 付款：需要可在管理后台或应用中收款的账号。

将 PayPal（在线）连接到俱乐部

1. 登录 PayPal Developer，打开“Apps & Credentials”。在那里创建一个应用，复制 Client ID 和 Secret。
2. 打开 /admin，在左侧选择俱乐部，进入“合同与付款”→“在线支付”。
3. 在“PayPal”卡片中填写 Client ID 和 Client Secret。如需不用真钱试用，勾选“Sandbox（测试环境）”并使用 sandbox 凭据。
4. 点击“验证并保存”。我们会立即用这些凭据登录 PayPal；成功后卡片显示“就绪”（测试时还显示“测试模式”）。凭据加密保存。
5. 以后用同样方式填写新凭据，然后点击“替换凭据”。“移除”会删除凭据，会员将无法再使用 PayPal 付款。

会员的操作——PayPal（在线）

1. 会员在自己的手机上打开应用——无需俱乐部平板——进入自己的账户并点击“付款”。只有存在未结金额时才会显示该按钮。 如果显示的是「你在此列表中还没有成员账户」，说明其登录未关联到该列表的任何账户：请在管理后台的「日记账与账户」→「账户」中为该账户填写其电子邮件地址。
2. 在“支付未结金额”窗口中点击“使用 PayPal 支付”。PayPal 页面会打开——在 WebApp 中于同一窗口打开，在 iPhone、iPad 和 Android 的 App 中于设备浏览器（Safari 或 Chrome）打开。
3. 在那里登录 PayPal 并确认付款。支付全部未结金额；如果俱乐部提供凑整捐款且会员选择了，也一并支付。
4. 然后返回应用。应用显示“谢谢！您的付款已收到并记账。”，余额已结清。

何时记账——PayPal（在线）

• 只有当我们完成在 PayPal 上已批准的付款时才会扣款。在此之前，我们会将金额和币种与未结金额核对——如有不符，不会扣款。
• 会员返回时立即完成。如果会员没有返回，每五分钟一次的核对会完成付款。PayPal 不需要 webhook。
• 付款页面有效期为 23 小时。会员发起新的付款后，旧的不再有效。会员取消时，不会记账。
• 记账后，会员通过电子邮件收到 PDF 结算收据。在 /admin 的“日记账与账户”→“付款日记账”中可以看到该付款，付款方式为“PayPal”，PayPal 的编号显示在“服务商凭证”中。

填写 PayPal.me 链接

1. 打开 /admin，选择俱乐部，进入“合同与付款”→“银行信息与 GiroCode”。
2. 在“付款链接（例如 PayPal.me）”部分的“按钮文字”中填写例如 PayPal。
3. 地址处填写您的链接，例如 https://paypal.me/club/{amount}EUR。{amount} 必填——未结金额以小数点形式（12.50）填入该位置；{currency} 填入币种。地址必须以 https:// 开头。
4. 下方示例显示最终链接。点击即可检查。
5. 点击“保存付款链接”。点击“移除”后，按钮会从应用中消失。

会员的操作——PayPal.me

1. 会员在 WebApp 或 App 中点击“付款”。窗口中显示按钮“使用 PayPal 支付”——使用您填写的文字；没有文字时显示“在线付款”。
2. 按钮会打开带有未结金额的 PayPal。会员在那里付款。
3. 应用中附有提示：“收银员登记后，付款会立即显示。”在此之前金额仍为未结。

手动记录 PayPal.me 付款

1. 在您的 PayPal 账户中查看谁支付了多少。
2. 在 /admin 中打开列表，进入“日记账与账户”→“账户”。在该会员所在行点击“收款”。
3. 填写 PayPal 显示的金额。付款方式选择“银行转账”——手动收款时没有“PayPal”方式——并在“备注”中写上例如“PayPal.me”。
4. 点击“结算”。会员通过电子邮件收到 PDF 收据。在 WebApp 或 App 中通过账户上的“收款”操作相同。

须知

• PayPal.me 链接只包含金额，不含付款用途。您需要根据 PayPal 中付款人的姓名来对应付款。
• PayPal.me 链接中的金额是打开窗口时的未结金额。之后新增的部分仍为未结。
• PayPal 中的退款不会在这里自动冲销——会员账户仍保持已结清。请与会员沟通处理此类情况。
• PayPal 手续费可在您的 PayPal 账户中查看；“付款日记账”中的“手续费”列不显示该费用。
• 账户上的“通过电子邮件支付”会在已设置在线服务商时附带付款链接——如果同时设置了 SumUp，则为 SumUp 的链接。邮件中从不包含 PayPal.me 链接。
• 从旧应用迁移后：旧应用中填写的付款链接会被迁移，名称为“PayPal (Altsystem)”——请在“银行信息与 GiroCode”中检查按钮文字和地址（必须包含 {amount}）。旧应用的 PayPal 连接不会迁移：PayPal（在线）需重新填写 Client ID 和 Secret。

遇到问题时

• “验证并保存”失败：Client ID 和 Secret 有误，或属于另一个环境。Sandbox 凭据只能在勾选“Sandbox（测试环境）”时使用，正式凭据只能在不勾选时使用。
• 会员看不到“使用 PayPal 支付”：没有未结金额，或 PayPal 在“在线支付”中不是“就绪”。
• 付款没有立即显示：会员没有返回应用。核对会在几分钟内记账。
• 保存链接时出现“缺少 {amount} — 未付金额将填入该位置”或“请输入完整的 https:// 地址”：请填写包含 https:// 和 {amount} 的地址。
• 会员已通过 PayPal.me 付款，在您记账之前又在线付款了一次：仍请记录这笔 PayPal.me 付款——该金额将成为其账户上的余额。