通过“立即付款”在线收款（银行卡或银行，使用 Stripe）

开通在线支付后，您的客户只需点几下，就能通过银行卡或银行支付发票：发票邮件、付款提醒、发票在线页面和客户门户中都会出现 立即付款 按钮。款项直接进入 您自己的 Stripe 账户（Stripe 是负责收款的支付公司）。Kaam360 绝不会看到卡或银行信息，并会在 Stripe 确认付款后自动将发票标记为已付。

谁可以设置：管理员，以及角色拥有 设置在线支付 权限的人（见 创建您自己的角色）。此功能包含在 Team 和 Business 套餐中。

1. 开立 Stripe 账户

1. 前往 stripe.com 创建账户（开户免费；Stripe 会从每笔付款中收取少量手续费）。
2. Stripe 一开始处于 测试模式：一切都不是真的，您可以放心试用。以后要收取真实付款时，Stripe 会要求您提供企业和银行信息（Activate payments）。

2. 连接到 Kaam360（先用测试模式）

1. 在 Stripe 中打开 Developers > API keys。确认 Test mode 已打开（顶部的开关）。
2. 在 Secret key 旁点击 Reveal test key 并复制。它以 sk_test_ 开头。
3. 在 Kaam360 中点击 设置，然后点击 在线支付 卡片。
4. 将密钥粘贴到 密钥（Secret key） 并点击 连接。Kaam360 会向 Stripe 验证密钥，并显示 已连接 和 测试模式。

密钥加密保存，不会再完整显示；只显示最后四个字符，方便您辨认。切勿粘贴可公开密钥（pk_...）：Kaam360 需要的是密钥（Secret key）。

3. 添加 webhook（让付款自动记录）

webhook 是 Stripe 告诉 Kaam360“这张发票已付款”的方式。没有它，就不会提供 立即付款。

1. 在 在线支付 页面的 Webhook 下，点击 端点 URL 旁的 复制。
2. 在 Stripe 中打开 Developers > Webhooks，点击 Add endpoint（在较新的 Stripe 界面中：Add destination，选择 Your account 和 Webhook endpoint）。
3. 将地址粘贴到 Endpoint URL。
4. 在 Select events 中，准确选择 Kaam360 页面上列出的事件：checkout.session.completed、checkout.session.async_payment_succeeded、checkout.session.async_payment_failed、checkout.session.expired、payment_intent.succeeded、payment_intent.payment_failed 和 charge.refunded, payout.paid, payout.failed。点击 Add endpoint。
5. 在 Stripe 的端点页面中，于 Signing secret 下点击 Reveal 并复制。它以 whsec_ 开头。
6. 回到 Kaam360，将其粘贴到 签名密钥 并点击 保存。标记会变为 签名密钥已保存。

4. 选择客户看到的内容

在 客户看到的内容 下：

• 在发票上提供“立即付款”：随时开启或关闭在线支付。
• 付款方式：银行卡（客户有 Apple Pay 和 Google Pay 时也可使用），以及适用时的银行直接借记：美元用 美国银行账户（ACH 直接借记），欧元用 SEPA 直接借记，英镑用 Bacs 直接借记（英国）。也请在 Stripe 中开启每种方式（Settings > Payment methods）。全部不勾选，则提供 Stripe 中已开启的所有方式。
• 部分付款：勾选 客户可以支付发票的一部分，客户即可输入金额（不会超过仍欠金额），并设置 最低部分付款。
• 在线支付手续费：默认关闭（0%）。有些国家和卡组织禁止或限制此类费用，添加前请先确认。客户付款前会看到它，且不会加到发票上。
• 哪些发票：仅某些币种（例如 USD, EUR），如果您有多家公司，也可仅限其中几家。

点击 保存。

5. 用测试卡试一试

1. 给自己发送一张发票（或打开一张已开具的发票，点击 发票在线页面 旁的 打开）。
2. 点击 立即付款。Stripe 的付款页面打开。
3. 使用 Stripe 测试卡 4242 4242 4242 4242、任意未来日期和任意三位数字付款。
4. 您会回到发票页面，发票现已显示为已付。在 Kaam360 的发票页面上，在线支付 卡片会列出这笔付款，您也会收到通知和邮件。

6. 正式上线

1. 在 Stripe 中关闭 Test mode，并完成 Activate payments。
2. 复制正式密钥（sk_live_...）。在 在线支付 页面点击 更换密钥，粘贴后点击 连接。标记显示 正式。
3. 在正式模式下重新添加 webhook（第 3 步：Stripe 将测试和正式 webhook 分开），并保存新的签名密钥。

客户看到什么

• 发票邮件和提醒 中有 立即付款 按钮。在提醒中您也可以使用 {pay_link} 一词。
• 发票在线页面：每张发票都有一个私密地址，客户无需登录即可在那里查看发票、下载 PDF 并付款。在发票页面上，在线支付 卡片显示该地址并提供 复制；WhatsApp 消息中也包含它。
• 客户门户：在仍有欠款的发票上，立即付款 位于 如何付款 下方。

您自己的付款说明（银行信息）仍保留在 立即付款 下方，客户仍可按原来的方式付款。

付款之后会发生什么

• 银行卡付款 会立即确认：发票被标记为已付（或部分已付，并显示仍欠金额），所对应的项目付款也随之更新。
• 银行直接借记 需要几天。在银行确认之前，付款显示为 处理中，任何人都无法重复支付同一金额。如果银行拒绝，付款显示为 失败，并会通知您。
• Stripe 手续费 在 Stripe 报告后显示在每笔付款旁边。
• 客户会收到收据 邮件，以您公司的名义发送。
• 您会收到通知（铃铛）和邮件；开具发票的人也会收到。

退款

请在您的 Stripe 后台退款（打开付款并点击 Refund）。Kaam360 会自动跟进：付款显示已退款金额，发票上该金额重新变为欠款。如果客户不会再付，请为此开具贷项通知单（见 贷项通知单、退款和客户对账单）。

如果客户重复付款（例如在两个浏览器标签页中），第二笔付款会记录为 超出欠款，并提示您在 Stripe 中退还差额。

打款到您的银行

Stripe 每隔几天会把收到的钱扣除手续费和退款后打到您的银行，这就是一笔打款。Stripe 发送 payout.paid 时，Kaam360 会自动读取每笔打款及其全部内容。

1. 在 在线支付 中找到 打款到您的银行。每笔打款显示到账日、其中的付款、退款和 Stripe 手续费，以及到达您银行的金额。
2. 点击 显示 查看打款的每一行：每笔立即付款及其发票、每笔退款和每笔手续费。不是在 Kaam360 中通过立即付款完成的付款会标记为 非来自 Kaam360。
3. 点击 获取打款 从 Stripe 重新读取最近 60 天的打款（例如刚添加 webhook 之后）。

状态显示每笔打款的进度：处理中、已打款，尚未记账、已记账，银行流水尚未匹配 或 已对账。

在总账中（开启自动分录时），打款中的立即付款先记入 Stripe clearing 科目。打款到账当天，Kaam360 把净额从 Stripe clearing 转入您的银行，把 Stripe 手续费记入 Bank charges；客户额外支付的在线付款手续费记入 Other income。导入银行对账单时，这笔打款的银行流水与打款总额一致：在 银行对账单 中匹配后，打款显示 已对账。

检查一切是否正常

在 在线支付 页面：

• 在线支付 列出每笔付款及其状态、手续费和客户。
• 来自 Stripe 的消息 列出 Stripe 发送的每条消息以及 Kaam360 的处理结果。重复发送的消息只会使用一次。
• 如果看到“收到签名不匹配的消息”的警告，说明 Kaam360 中保存的签名密钥不是该 webhook 的（或来自另一模式）。请从 Stripe 重新复制并点击 保存。

谁可以做什么

在 角色和权限 的 财务 下：设置在线支付 可连接账户并更改选项（默认仅管理员，除非您授予他人）。查看发票 可看到发票的在线付款及其在线页面。连接、更改和断开都会记录在活动日志中，每笔付款和退款也是如此。