Pular para o conteúdo principal

​
O que são Pagamentos?

Pagamentos permitem que você envie dinheiro do seu saldo pré-financiado da KillB diretamente para qualquer beneficiário — contas bancárias, carteiras cripto ou aliases de pagamento locais. Ao contrário dos ramps, não há etapa de cotação nem URL de pagamento: você já tem o saldo e o empurra para o destino instantaneamente.
Pagamentos requerem uma conta pré-financiada ativa com saldo suficiente. Certifique-se de ter fundos depositados antes de criar um pagamento.

PSE

Saldo → Conta BancáriaEnvie COP para contas bancárias colombianas via PSE

BREB

Saldo → Alias RegistradoEnvie para telefone, email ou CPF via BREB

​
Fluxo de Transação

1

Verificar Saldo

Verifique se sua conta pré-financiada tem fundos suficientes
2

Criar Pagamento

Envie o pagamento com o ID da conta pré-financiada, valor e dados do beneficiário
3

Processamento

A KillB roteia o pagamento para a conta ou carteira do beneficiário
4

Liquidação

Fundos entregues — receba uma notificação webhook ao completar

​
Conceitos Principais

Cada pagamento é debitado de uma conta pré-financiada. Você precisa ter uma criada e financiada antes de iniciar um pagamento. Pagamentos falharão se o saldo for insuficiente.
Os tipos de beneficiário atualmente suportados são PSE (transferência para conta bancária padrão) e BREB (alias registrado: telefone, email ou CPF). Cada tipo requer campos específicos de conta.
Envie um header Idempotency-Key para retentar a criação de pagamentos com segurança sem risco de desembolsos duplicados.
Assine eventos webhook de PAYOUT para receber atualizações de status em tempo real para cada desembolso.

​
Início Rápido

// 1. Verificar saldo pré-financiado
const balances = await fetch('/api/v2/customers/balances', {
  headers: { 'Authorization': `Bearer ${token}` }
}).then(r => r.json());

// 2. Criar um pagamento
const payout = await fetch('/api/v2/payouts', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': 'pagamento-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('Pagamento criado:', payout.id, '| Status:', payout.status);

​
Próximos Passos

Criar um Pagamento

Implementação passo a passo com exemplos de código

Rastreamento de Status

Monitore o progresso do pagamento com polling e webhooks

Contas Pré-Financiadas

Configure e financie sua conta pré-financiada

Referência da API

Documentação completa da API de Pagamentos