标准支付通常是“即时扣款（Immediate Sale）”，即用户支付的同时资金同步扣除。授权与扣款（Auth & Capture）将支付流程拆分为两个独立步骤：Documentation Index
Fetch the complete documentation index at: https://waffo.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
核心价值
使用场景
- AI 与按量计费服务
- 电商：发货模型
- 出行与租赁：押金模型
适用于成本高、费用波动大的场景，例如 AI 图像生成、LLM 推理以及云计算租用。
| 步骤 | 时机 | 发生什么 |
|---|---|---|
| 授权 | 任务开始前 | 用户提交一个复杂的生成任务。系统预估最高费用为 $10 并冻结该额度，确保用户的卡内有足够资金覆盖算力成本。 |
| 扣款 | 任务结束后 | 任务实际消耗 5,000 个 token，价值 4.50 的扣款，并自动释放剩余的 $5.50 信用额度。 |
关键能力与操作
部分扣款
支持对预授权订单按小于原冻结金额的金额进行扣款。场景： AI 任务预估 4.50。操作： 发起一笔 4.50，并自动释放剩余 $5.50 的额度。
撤销授权
在发起扣款前，你可以随时取消交易。场景： AI 任务因系统过载失败；未产生实际费用。操作： 调用 Void API。特性： 零成本（无处理费用）、即时释放（用户额度在几分钟内恢复）——相比退款（通常需要 3–7 天）优势显著。
集成
API 集成
在创建支付订单时设置参数capture_method: manual 以启用预授权模式。默认值为 automatic，用于即时扣款。
Webhook 通知
系统会在以下节点发送通知，帮助你同步业务状态：| Event | Description |
|---|---|
payment_intent.authorized | 信用额度冻结成功。你可以开始 AI 任务或发货。 |
payment_intent.captured | 资金扣款成功。资金已准备好进行结算。 |
payment_intent.canceled | 预授权已撤销或已过期。 |
常见问题
预授权有效期是多久？
预授权有效期是多久？
通常，Visa/Mastercard 的预授权有效期为 7 天。这通常足以满足 AI 服务或电商发货场景。如果您属于特殊行业（例如长期租赁），我们可以协助申请将预授权窗口延长至 30 天。
为什么我在账户里看不到预授权的金额？
为什么我在账户里看不到预授权的金额？
预授权仅”冻结”用户的信用额度，资金仍在用户的银行账户中，尚未转入商户账户。只有在您成功调用 Capture 接口后，资金才会开始结算并进入您的账户余额。
如果 AI 任务失败，我需要退款吗？
如果 AI 任务失败，我需要退款吗？
不需要发起”退款”，因为资金实际上并未被扣取。您只需调用 Void 接口，或什么都不做（等待自动过期），用户的额度即可恢复。这比退款流程更简单，也避免了用户对”先扣款后退款”产生的困惑。
我可以对同一笔授权进行多次扣款吗？
我可以对同一笔授权进行多次扣款吗？
目前我们主要支持单次扣款（Single Capture）。一旦发起 Capture（即使是部分金额），剩余的预授权额度将自动释放。如果您运营的是持续计费的 AI 服务（例如按分钟计费的流式对话），建议使用 Tokenization 功能绑定银行卡，并按周期（例如每小时，或累计达到 $10 时）主动发起扣款。
需要帮助？联系支持