为什么提供 ACH Direct Debit?
Lower Processing Cost
ACH 每笔付款收取固定 1.5% 的费用,最高为 $15,而不是收取卡付款费用。请参阅 定价。
No Card Required
触达偏好从银行账户付款的美国客户,或不希望使用卡进行大额购买的客户。
Higher Value Orders
由于费用最高为 $15,与卡付款费用相比,订单金额越高,节省的费用越多。ACH 适用于大额一次性购买。
概览
工作原理
客户体验
- 客户在结账时选择 ACH Direct Debit。
- 客户输入账户持有人姓名、routing number、account number、account type(checking 或 savings)以及电子邮件地址。结账流程会检查 routing number 是否有效。
- 客户提交表单,根据 mandate 授权从其美国银行账户扣款。
- 付款提交至 ACH 网络并进入 processing 状态。结账流程完成时不会等待清算。
- 清算会在接下来的工作日内完成。
- 付款进入 succeeded 状态;如果银行退回扣款,则付款失败。
由于清算是异步的,请使用 webhooks 获取最终结果,而不要依赖结账重定向。结账后的重定向仅表示客户已授权扣款。扣款提交后,付款会发出
payment.processing;清算完成后,会发出 payment.succeeded 或 payment.failed。只有在 payment.succeeded 时才能履行订单。可用性
满足以下所有条件时,ACH Direct Debit 会在结账时显示:- 结算货币为
USD。 - 结算国家/地区为
US。 - 交易为一次性付款。
ACH Direct Debit 不适用于订阅。对于定期付款,请使用卡或其他支持订阅的付款方式。请参阅 Payment Methods 概览。
配置
ACH Direct Debit 要求使用 USD 结算货币和美国结算地址。如果您使用其他货币定价,请启用 Adaptive Currency,这样美国客户将以 USD 结算,并可使用 ACH。
API 方法类型
退款和争议
ACH 付款的退款和争议使用与其他所有付款方式相同的 API 和 dashboard 流程。您无需进行 ACH 特定处理。测试
1
Enable test mode
关闭 dashboard 侧边栏中的 Live Mode 开关,并使用在 test mode 中创建的 API keys。
2
Set currency and billing address
将结算货币设置为
USD,并将结算地址所在国家/地区设置为 US。3
Include ach in allowed methods
在
allowed_payment_method_types 中传入 ach,或省略该字段以显示所有符合条件的付款方式。4
Enter the test bank details
输入以下任意一组测试 routing number 和 account number。然后确认您的 webhook handler 收到了最终付款状态。
测试银行账户
客户在结账表单中输入 account number 和 routing number。在 test mode 中,将 routing number110000000 与以下任一 account number 搭配使用,以强制触发相应结果:
测试付款比正式付款更快进入最终状态,因此无需等待数天即可验证集成。例外情况是
000000000009,它会保持 processing 状态。最佳实践
Set customer expectations at checkout
Set customer expectations at checkout
告知客户银行付款不会立即完成清算。这样可以减少客户询问订单为何仍处于待处理状态的支持工单。
Provide card fallbacks
Provide card fallbacks
在
ach 旁边加入 credit 和 debit,以便需要立即访问产品的客户选择更快的付款方式。Use ACH for high-value one-time purchases
Use ACH for high-value one-time purchases
ACH 费用最高为 $15,因此大额一次性购买可节省最多费用。
故障排除
ACH not appearing at checkout
ACH not appearing at checkout
检查:
- 结算货币是否为
USD? - 客户的结算国家/地区是否为
US? ach是否包含在allowed_payment_method_types中?- 这是一次性付款吗?ACH 不适用于订阅。
- 金额是否至少为 $0.50?
allowed_payment_method_types 以查看所有符合条件的付款方式,然后在 API 请求中检查结算货币和地址国家/地区。ACH not appearing on a subscription checkout
ACH not appearing on a subscription checkout
原因: ACH Direct Debit 仅适用于一次性付款。解决方案: 对于周期性计费,请使用卡或其他支持订阅的方式。
Payment stuck in processing
Payment stuck in processing
原因: 这是预期行为。ACH 付款会在整个清算时间窗口内保持 processing 状态,该窗口远长于卡付款的清算时间。解决方案: 等待最终 webhook。不要重试付款,因为重试可能导致客户被扣款两次。
Payment failed after initially succeeding at checkout
Payment failed after initially succeeding at checkout
原因: 结账流程已完成,但客户的银行在清算期间退回了扣款,最常见的原因是资金不足或账户已关闭。付款会发出
payment.failed。解决方案: 将付款视为失败,并要求客户使用其他付款方式。只有在 succeeded 状态时才履行订单,以避免此问题。相关页面
Payment Methods Overview
查看所有支持的支付方式。
Adaptive Currency
货币支持和自动转换。
Checkout Guide
完整的结账实现指南。
Webhooks
异步处理延迟的付款确认。