Skip to main content
AgencyHandy 的 Stripe 集成让您可以通过平台内发送的发票直接接受客户的银行卡支付。连接后，您的客户将看到熟悉的 Stripe 托管结账页面，支付状态会自动同步回 AgencyHandy——无需手动对账。
只有 SuperAdmin 和 Admin 角色才能连接或管理 Stripe 集成。在开始之前，您还必须拥有一个具有相应权限的已验证 Stripe 账户。

​
连接 Stripe

1

打开 Stripe 集成设置

在左侧边栏中，导航至集成 → Stripe 集成。
2

在 Stripe 上授权

点击连接 Stripe，您将被重定向到 Stripe 的授权页面。登录您的 Stripe 账户，点击允许以授予 AgencyHandy 访问权限。批准后，Stripe 将自动将您重定向回 AgencyHandy。
3

配置支付偏好

重定向后，配置以下选项：
  • 货币 — 为您的工作区选择默认账单货币。
  • 支付方式 — 根据您的 Stripe 账户支持情况，启用或禁用银行卡类型（Visa、Mastercard 等）。
  • 账单偏好 — 可选择设置税率、发票前缀或默认付款条款和到期日。
4

保存并确认

点击保存，集成激活后将出现确认提示横幅。Stripe 现已与您的工作区关联，您的客户可以在线支付发票。

​
测试集成

在发送正式发票之前，进行快速的端到端测试以确认连接正常运行。
1

创建测试发票

在 AgencyHandy 中创建一张草稿发票，设置一个小金额。
2

发送给自己

将发票发送到您自己的电子邮件地址或可以协助测试的团队成员。
3

完成测试支付

打开发票链接，如果您的 Stripe 账户处于测试模式，使用 Stripe 测试卡（例如 4242 4242 4242 4242）完成支付；正式模式下使用真实银行卡。
4

验证状态更新

返回 AgencyHandy，确认发票状态已更改为已支付。如果已更改，说明您的集成运行正常。

​
管理您的 Stripe 连接

随时返回集成 → Stripe 集成以：
  • 更新支付设置 — 更改货币、支付方式或账单偏好。
  • 查看连接状态 — 检查 Stripe 当前是否处于活跃状态。
  • 断开连接 — 点击断开连接以取消关联您的 Stripe 账户，支付收款将立即暂停，直到您重新连接。
  • 重新连接 — 再次点击连接 Stripe并重新授权以恢复集成。
断开 Stripe 连接将暂停所有未结发票的支付收款。在您重新连接并重新授权之前，客户将无法在线支付。

​
附加说明

AgencyHandy 从不存储您的支付凭证。所有支付数据均由 Stripe 的安全基础设施独家处理。
  • 每个工作区一个账户 — 每个 AgencyHandy 工作区只能连接一个 Stripe 账户。如需切换账户，请先断开当前账户，然后使用新账户重新连接。
  • 实时发票状态 — 所有与 Stripe 关联的发票将持续反映直接从 Stripe 接收的实时状态更新。
  • 货币 — 确保 AgencyHandy 中配置的货币与您 Stripe 账户中启用的货币一致，以避免支付错误。