Skip to main content

​
What are Payouts?

Payouts let you send money from your pre-funded KillB balance directly to any beneficiary — bank accounts, crypto wallets, or local payment aliases. Unlike ramps, there’s no quotation step or payment URL: you already hold the balance and push it out instantly.
Payouts require an active pre-funded account with sufficient balance. Make sure you have funds deposited before creating a payout.

PSE

Balance → Bank AccountDisburse COP to Colombian bank accounts via PSE

BREB

Balance → Registered AliasSend to phone number, email, or national ID via BREB

​
Transaction Flow

1

Check Balance

Verify your pre-funded account has sufficient funds
2

Create Payout

Submit the payout with pre-fund account ID, amount, and beneficiary details
3

Processing

KillB routes the payment to the beneficiary’s bank or wallet
4

Settlement

Funds delivered — receive a webhook notification on completion

​
Key Concepts

Every payout is debited from a pre-funded account. You must have one created and funded before initiating a payout. Payouts will fail if the balance is insufficient.
Currently supported beneficiary types are PSE (standard bank account transfer) and BREB (registered alias: phone, email, or national ID). Each type requires specific account fields.
Send an Idempotency-Key header to safely retry payout creation without risk of duplicate disbursements.
Subscribe to PAYOUT webhook events to receive real-time status updates for each disbursement.

​
Quick Start

// 1. Check your pre-fund balance
const balances = await fetch('/api/v2/customers/balances', {
  headers: { 'Authorization': `Bearer ${token}` }
}).then(r => r.json());

// 2. Create a payout
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 created:', payout.id, '| Status:', payout.status);

​
Next Steps

Create a Payout

Step-by-step implementation with code examples

Status Tracking

Monitor payout progress with polling and webhooks

Pre-Funded Accounts

Set up and fund your pre-fund account

API Reference

Complete Payouts API documentation