什么是付款？
付款是出站付款功能，允许您将 KillB 预存余额中的资金发送给任何收款方——银行账户、加密货币钱包或本地支付别名。这是大规模分发资金最简单的方式：无需报价步骤，无需支付 URL，无需等待最终用户操作。您持有余额；KillB 将其路由到目的地。付款是 B2B 功能，专为需要向多个收款方发送资金的企业设计（工资发放、供应商付款、平台结算、加密货币分发等）。
付款 vs. Ramps
付款和 ramps 都能转移资金，但用途不同：| 付款 | Off-Ramps | |
|---|---|---|
| 方向 | 预存账户 → 收款方 | 加密货币钱包 → 法币账户 |
| 发起方 | 您的后端 | 您的终端用户 |
| 需要报价？ | 否 | 是 |
| 支付 URL？ | 否 | 是 |
| 使用场景 | 批量付款、工资、结算 | 用户提现 |
| 资金来源 | 预存账户 | 用户的加密货币钱包 |
工作原理
前提条件
每笔付款需要：- 活跃的预存账户 — 持有待发放的余额
- 足够的余额 — 等于或大于付款金额
- 有效的收款方信息 — 与所选付款通道要求的字段匹配
设置预存账户
了解如何创建和充值预存账户
付款生命周期
状态
| 状态 | 含义 |
|---|---|
CREATED | 付款已接收并持久化，等待进入处理队列。 |
PENDING | 付款已排队，等待发送至支付服务商。 |
PROCESSING | 付款已提交至支付服务商，等待确认。 |
COMPLETED | 支付服务商已确认资金成功交付给收款方。 |
ERROR | 内部系统错误，未进行任何付款。 |
FAILED | 因收款方账户信息无效或不正确，付款被拒绝。 |
REJECTED | 付款因合规审查被拦截，不会被处理。 |
REFUNDED | 已发送的资金已退回预存余额。 |
支持的收款方类型
| 类型 | 地区 | 说明 |
|---|---|---|
PSE | 哥伦比亚 | 通过 PSE 进行银行账户转账 |
BREB | 哥伦比亚 | 已注册别名（手机号、邮箱、身份证） |
幂等性
为防止网络重试时产生重复付款，每次创建付款请求时请传入唯一的Idempotency-Key 请求头。如果相同的 key 被接收两次，KillB 将返回原始付款而不是创建新记录。
常见问题
付款失败后我的余额会怎样？
付款失败后我的余额会怎样？
如果付款达到
FAILED 状态，不会从预存余额中扣款。只有付款达到 COMPLETED 时才会扣款。我可以取消付款吗？
我可以取消付款吗？
处于
PENDING 状态的付款可能可以取消——请联系支持。一旦付款进入 PROCESSING，由于资金已在途中，取消将不再可能。ERROR、FAILED 和 REJECTED 有什么区别？
ERROR、FAILED 和 REJECTED 有什么区别？
每种状态反映不同的失败来源：
ERROR— KillB 内部系统错误，未进行任何付款。FAILED— 因发送方提供的收款方账户信息无效或不正确，银行拒绝了转账。REJECTED— 付款因 KillB 的合规审查被拦截，不会被处理。
什么时候会出现 REFUNDED 状态？
什么时候会出现 REFUNDED 状态？
当已发送的资金退回到您的预存余额时，付款状态变为
REFUNDED——可能发生在 FAILED 交付之后，或在某些情况下，COMPLETED 的付款被收款方银行事后撤销。付款需要多长时间？
付款需要多长时间？
PSE 和 BREB 转账通常在几分钟到几个工作小时内结算，具体取决于银行和截止时间。
幂等性如何工作？
幂等性如何工作？
在付款创建请求中传入唯一的
Idempotency-Key 请求头。如果相同的 key 被接收两次（例如重试时），KillB 将返回原始付款而不是创建重复付款。最佳实践
- 先检查余额 — 创建付款前始终调用
GET /api/v2/customers/balances，避免因余额不足导致失败 - 使用
Idempotency-Key— 每笔付款始终传入唯一 key，安全重试不产生重复 - 订阅 webhooks — 配置
PAYOUT事件 webhooks，实时获取状态更新 - 监控 REJECTED 付款 — 拒绝时记录完整收款方数据，以便识别和修正无效账户信息
- 每日对账 — 获取前一天的所有付款，与内部账本核对
相关指南
创建付款
分步实现指南
状态跟踪
通过 webhooks 和轮询监控付款
预存账户
充值预存账户
Webhooks
实时事件通知