Pular para o conteúdo principal

​
O que são Pagamentos?

Pagamentos são desembolsos de saída que permitem enviar fundos do seu saldo pré-financiado da KillB para qualquer beneficiário — contas bancárias, carteiras cripto ou aliases de pagamento locais. É a forma mais simples de distribuir dinheiro em escala: sem etapa de cotação, sem URL de pagamento, sem aguardar ação do usuário final. Você tem o saldo; a KillB roteia para o destino.
Pagamentos são um recurso B2B projetado para empresas que precisam desembolsar fundos para muitos destinatários (folha de pagamento, pagamentos a fornecedores, liquidações de marketplace, distribuições cripto, etc.).

​
Pagamentos vs. Ramps

Tanto pagamentos quanto ramps movem dinheiro, mas servem propósitos diferentes:

​
Como Funciona

​
Pré-requisitos

Cada pagamento requer:
  1. Uma conta pré-financiada ativa — mantém o saldo a ser desembolsado
  2. Saldo suficiente — igual ou maior que o valor do pagamento
  3. Dados válidos do beneficiário — correspondentes aos campos exigidos pelo rail de pagamento escolhido

Configurar Contas Pré-Financiadas

Aprenda a criar e financiar suas contas pré-financiadas

​
Ciclo de Vida do Pagamento

FAILED e ERROR durante a fase de Cash In são terminais — nenhum fundo foi coletado, portanto nenhum reembolso é emitido. Para as fases seguintes (KYT Out, Cash Out), esses status iniciam o fluxo de reembolso. REJECTED também aciona o fluxo de reembolso, pois ocorre apenas após o Cash In.

​
Status

​
Tipos de Beneficiário Suportados

​
Idempotência

Para evitar desembolsos duplicados em novas tentativas de rede, passe um header único Idempotency-Key em cada solicitação de criação de pagamento. Se a mesma chave for recebida duas vezes, a KillB retorna o pagamento original em vez de criar um novo.

​
Perguntas Frequentes

Depende da fase em que a falha ocorre:
  • Durante Cash In — Nenhum fundo foi coletado, portanto nada é debitado do seu saldo pré-financiado.
  • Após Cash In (KYT Out, Cash Out) — Os fundos já foram coletados. O pagamento segue para o fluxo de reembolso (REFUND_PENDING → REFUND_PROCESSING → REFUNDED), devolvendo-os ao seu saldo pré-financiado.
Cada status reflete uma origem de falha distinta:
  • ERROR — Erro interno do sistema na KillB. Nenhum fundo foi desembolsado.
  • FAILED — O banco do beneficiário recusou a transferência devido a dados de conta inválidos ou incorretos fornecidos pelo remetente.
  • REJECTED — O pagamento foi bloqueado por uma revisão de conformidade na KillB. Os fundos são devolvidos ao seu saldo pré-financiado via fluxo de reembolso.
Um pagamento entra em REVIEW_NEEDED quando a verificação KYT Out sinaliza a transação para revisão manual. Nenhuma ação é necessária da sua parte — o pagamento será retomado automaticamente após a conclusão da revisão ou mudará para REJECTED se bloqueado.
Um pagamento atinge REFUNDED quando FAILED ou ERROR ocorre após a fase de Cash In (KYT Out ou Cash Out), ou quando o pagamento é REJECTED por compliance. Como os fundos já foram coletados, o pagamento passa automaticamente por REFUND_PENDING → REFUND_PROCESSING → REFUNDED.Se FAILED ou ERROR ocorrer durante Cash In, nenhum fundo foi coletado e nenhum reembolso é emitido.
Transferências Bank Transfer e BREB tipicamente liquidam em minutos a algumas horas úteis dependendo do banco e dos horários de corte.
Passe um header único Idempotency-Key nas solicitações de criação de pagamentos. Se a mesma chave for recebida duas vezes (ex.: em uma nova tentativa), a KillB retorna o pagamento original em vez de criar um desembolso duplicado.

​
Boas Práticas

  • Verifique o saldo primeiro — sempre chame GET /api/v2/customers/balances antes de criar um pagamento para evitar falhas por saldo insuficiente
  • Use Idempotency-Key — sempre passe uma chave única por desembolso para retentar com segurança sem duplicatas
  • Assine webhooks — configure webhooks de eventos PAYOUT para atualizações de status em tempo real
  • Monitore pagamentos REJECTED — registre dados completos do beneficiário na rejeição para identificar e corrigir detalhes inválidos de conta
  • Reconcilie diariamente — obtenha todos os pagamentos do dia anterior e compare com seu livro-razão interno

​
Guias Relacionados

Criar um Pagamento

Guia de implementação passo a passo

Rastreamento de Status

Monitore pagamentos com webhooks e polling

Contas Pré-Financiadas

Financie suas contas pré-financiadas

Webhooks

Notificações de eventos em tempo real