什么是付款？
付款功能让您可以将 KillB 预存余额中的资金直接发送给任何收款方——银行账户、加密货币钱包或本地支付别名。与 ramps 不同，无需报价步骤或支付 URL：您已持有余额，直接推送到目标地址即可。
付款需要一个有足够余额的活跃预存账户。在创建付款之前，请确保已存入资金。
PSE
余额 → 银行账户通过 PSE 将 COP 发送到哥伦比亚银行账户
BREB
余额 → 已注册别名通过 BREB 向手机号、邮箱或身份证发送
交易流程
创建付款
提交包含预存账户 ID、金额和收款方详情的付款请求
处理中
KillB 将付款路由到收款方的银行账户或钱包
结算
资金已交付——完成后收到 webhook 通知
关键概念
每笔付款都从预存账户中扣款。在发起付款之前，您必须已创建并充值预存账户。如果余额不足，付款将失败。
目前支持的收款方类型为 PSE（标准银行账户转账）和 BREB（已注册别名：手机号、邮箱或身份证）。每种类型需要特定的账户字段。
订阅 PAYOUT webhook 事件，实时接收每笔付款的状态更新。
快速开始
// 1. 检查预存余额
const balances = await fetch('/api/v2/customers/balances', {
headers: { 'Authorization': `Bearer ${token}` }
}).then(r => r.json());
// 2. 创建付款
const payout = await fetch('/api/v2/payouts', {
method: 'POST',
headers: {
'Authorization': `Bearer ${token}`,
'Content-Type': 'application/json',
'Idempotency-Key': 'payout-2024-001'
},
body: JSON.stringify({
preFundAccountId: 'prefund-account-id',
amount: 500000, // 500,000 COP
beneficiary: {
type: 'PSE',
account: {
firstName: 'Maria',
lastName: 'Garcia',
email: '[email protected]',
phone: '3001234567',
document: { type: 'CC', number: '12345678' },
accountNumber: '123456789',
bankCode: '001',
type: 'savings',
countryCode: 'CO'
}
}
})
}).then(r => r.json());
console.log('付款已创建:', payout.id, '| 状态:', payout.status);
下一步
状态跟踪
通过轮询和 webhooks 监控付款进度
