> ## Documentation Index
> Fetch the complete documentation index at: https://docs.killb.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Visão Geral de Pagamentos

> Envie fundos do seu saldo pré-financiado diretamente para beneficiários

## 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.

<Info>
  Pagamentos requerem uma conta pré-financiada ativa com saldo suficiente. Certifique-se de ter fundos depositados antes de criar um pagamento.
</Info>

<CardGroup cols={2}>
  <Card title="Bank Transfer" icon="building-columns">
    **Saldo → Conta Bancária**

    Envie COP para contas bancárias colombianas via Bank Transfer
  </Card>

  <Card title="BREB" icon="id-card">
    **Saldo → Alias Registrado**

    Envie para telefone, email ou CPF via BREB
  </Card>
</CardGroup>

## Fluxo de Transação

<Steps>
  <Step title="Verificar Saldo">
    Verifique se sua conta pré-financiada tem fundos suficientes
  </Step>

  <Step title="Criar Pagamento">
    Envie o pagamento com o ID da conta pré-financiada, valor e dados do beneficiário
  </Step>

  <Step title="Processamento">
    A KillB roteia o pagamento para a conta ou carteira do beneficiário
  </Step>

  <Step title="Liquidação">
    Fundos entregues — receba uma notificação webhook ao completar
  </Step>
</Steps>

## Conceitos Principais

<AccordionGroup>
  <Accordion title="Conta Pré-Financiada Obrigatória" icon="vault">
    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.
  </Accordion>

  <Accordion title="Tipos de Beneficiário" icon="users">
    Os tipos de beneficiário atualmente suportados são **Bank Transfer** (transferência para conta bancária padrão) e **BREB** (alias registrado: telefone, email ou CPF). Cada tipo requer campos específicos de conta.
  </Accordion>

  <Accordion title="Idempotência via Header" icon="fingerprint">
    Envie um header `Idempotency-Key` para retentar a criação de pagamentos com segurança sem risco de desembolsos duplicados.
  </Accordion>

  <Accordion title="Notificações Webhook" icon="bell">
    Assine eventos webhook de `PAYOUT` para receber atualizações de status em tempo real para cada desembolso.
  </Accordion>
</AccordionGroup>

## Início Rápido

```javascript theme={null}
// 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: 'BANK',
      account: {
        firstName: 'Maria',
        lastName: 'Garcia',
        email: 'maria@exemplo.com',
        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

<CardGroup cols={2}>
  <Card title="Criar um Pagamento" icon="paper-plane" href="/pt/guides/payouts/create-payout">
    Implementação passo a passo com exemplos de código
  </Card>

  <Card title="Rastreamento de Status" icon="chart-line" href="/pt/guides/payouts/payout-status">
    Monitore o progresso do pagamento com polling e webhooks
  </Card>

  <Card title="Contas Pré-Financiadas" icon="vault" href="/pt/guides/pre-fund/pre-fund-accounts">
    Configure e financie sua conta pré-financiada
  </Card>

  <Card title="Referência da API" icon="code" href="/api-reference/endpoint/payouts-create">
    Documentação completa da API de Pagamentos
  </Card>
</CardGroup>