Pular para o conteúdo

Meios de pagamento · Colômbia

Bre-B na Colômbia: pagamentos instantâneos, de entrada e de saída

Dê a cada cliente uma conta virtual com a própria chave Bre-B para receber, e pague as chaves Bre-B dos beneficiários em tempo real, 24/7.

Fale com vendasIr para a documentação
  • Transferência instantânea
  • Colômbia
  • Pay-in · Payout

Dados principais

Bre-B após os primeiros meses

Números atribuídos ao Banco de la República.

O que é

O trilho de pagamentos instantâneos da Colômbia

O Bre-B é o sistema de pagamentos instantâneos da Colômbia, lançado em 6 de outubro de 2025 pelo Banco de la República. O dinheiro circula de conta a conta em segundos, a qualquer hora. Com a Localpayment você o usa de duas formas: para receber, com uma conta virtual identificada por uma chave Bre-B, e para pagar as chaves Bre-B dos beneficiários.

  • Conta virtual identificada por uma chave Bre-B (código 2006)
  • Pay-ins para a chave, 24/7, confirmados por webhook
  • Payouts para chaves Bre-B em tempo real, 24/7 (código 0062)

Como funciona

Como se recebe uma transferência Bre-B

Os atores e as etapas seguem o fluxo documentado. O status final sempre chega por webhook assinado.

  1. 1

    Sua empresaLocalpayment:

    Cria a conta virtual

    POST /api/virtual-account, uma a uma ou em lote. O número ou a chave no formato local, pronto para compartilhar.

  2. 2

    Sua empresaCliente:

    Compartilha os dados de pagamento

    No seu checkout, fatura ou app.

  3. 3

    ClienteBanco · Bre-B:

    Transfere pelo banco

    Somente transferências eletrônicas; depósitos em dinheiro não são creditados.

  4. 4

    LocalpaymentSua empresa:

    Webhook: pagamento recebido

    A Localpayment associa a transferência à conta virtual automaticamente. Webhook assinado com dados do pagador e valor; os fundos são creditados no seu saldo Localpayment.

Diagrama simplificado. Os prazos dependem do trilho e do banco; veja os dados principais abaixo.

Como funciona

Como funciona um payout com Bre-B

Os atores e as etapas seguem o fluxo documentado. O status final sempre chega por webhook assinado.

  1. 1

    Sua empresaLocalpayment:

    Envia a solicitação de payout

    POST /api/payout/ com os dados do beneficiário, valor e externalId. Verificações de compliance são aplicadas; com requireAuth, um segundo aprovador assina antes de movimentar os fundos.

  2. 2

    LocalpaymentBanco · Bre-B:

    Bloqueia os fundos e envia a instrução

    O payout passa de Locked a In Progress por Bre-B.

  3. 3

    Banco · Bre-BBeneficiário:

    Credita o beneficiário

    Os prazos dependem do trilho; veja os dados principais abaixo.

  4. 4

    LocalpaymentSua empresa:

    Webhook: payout concluído

    A Localpayment atualiza o payout para o status final. Webhook assinado com o status final; o comprovante de pagamento pode ser baixado.

Diagrama simplificado. Os prazos dependem do trilho e do banco; veja os dados principais abaixo.

Como funciona

Veja Bre-B em ação

Um passo a passo simplificado e fictício. Nomes e valores são exemplos.

  1. 1Comercio EjemploO checkout mostra os dados da conta para pagar COP 185.000,00.
  2. 2Banco EjemploO pagador transfere COP 185.000,00 para a conta indicada.
  3. 3Pagamento confirmadoSeu sistema recebe o webhook assinado e libera o pedido.
Fale com vendas

Dados principais

Bre-B: dados principais

  • País

    Detalhe
    🇨🇴 Colômbia

  • Moeda

    Detalhe
    COP

  • Direção

    Detalhe
    Pay-in e payout

  • Pay-in · Conta virtual (chave Bre-B)

    Detalhe
    Em tempo real, confirmado por webhook · COP 1 – 11.000.000

  • Payout · Chave Bre-B

    Detalhe
    Em tempo real, 24/7 · COP 1 – 11.552.000

Extraídos da documentação da Localpayment de cada país. Limites e disponibilidade podem mudar; confirme com seu gerente de conta.

Experiência do cliente

O que seu cliente vê com Bre-B

Autorização, limites e reembolsos conforme docs.localpayment.com. Os limites aparecem apenas quando a documentação os informa.

  • Como o cliente autoriza

    Seu checkout mostra uma chave Bre-B como @LPTechColomb0001, gerada ao criar a conta virtual. O cliente abre o app do banco, escolhe “transferir por chave”, digita a chave, informa o valor e confirma. A transferência é liquidada em tempo real e o webhook dispara quando os fundos estão totalmente creditados.

  • Limites documentados

    Conta virtual (chave Bre-B) (Pay-in): COP 1 – 11.000.000 · Chave Bre-B (Payout): COP 1 – 11.552.000. Por transação, conforme a documentação publicada; os limites contratuais podem variar.

  • Reembolsos e devoluções

    Uma transferência creditada é reembolsada com PATCH /api/payin/{externalId}/refund. Só há reembolsos totais e os fundos voltam automaticamente para a conta de origem do pagador, sem dados adicionais do beneficiário. Depósitos em dinheiro nunca são creditados.

Checklist de integração

Entre em produção com Bre-B em cinco passos

A mesma sequência para todos os trilhos. Veja o checkout animado deste país antes de construir.

  1. Obtenha credenciais de Stage

    Solicite acesso, receba credenciais de Stage e obtenha um JWT com POST /api/token/.

  2. Crie o pay-in

    POST /api/payin/ com o código Localpayment da tabela de dados principais, país ISO-3, moeda, valor e dados do pagador.

  3. Mostre as instruções

    Exiba o QR, o código, o redirecionamento ou os dados da conta da resposta e respeite a data de expiração.

  4. Verifique o webhook

    Valide x-Signature (HMAC-SHA256), libere o pedido no status 200 e deduplique por externalId.

  5. Veja o checkout animado

    Cada método deste país, tela por tela, na galeria de experiências de checkout.

História

Como a Colômbia construiu um trilho instantâneo interoperável

Fonte: Banco de la República, “Bre-B: Sistema de Pagos Inmediatos Interoperado de Colombia”, documento técnico, fev. 2026.

  1. Estratégia de pagamentos instantâneos

    O Banco de la República decide fazer os sistemas de pagamento de baixo valor da Colômbia interoperarem por meio de um diretório central de chaves e liquidação em tempo real.

  2. Regras para os SPBVI

    O banco central publica a regulação dos sistemas de pagamento de baixo valor interoperáveis e define o padrão comum de chaves.

  3. Chaves e depois operação plena

    O registro de chaves abre em meados de 2025; a operação plena chega no segundo semestre, com transferências P2P gratuitas para os usuários.

  4. 90 milhões de chaves

    Mais de 90 milhões de chaves e 218 entidades participantes estão registradas, com mais de 370 milhões de operações liquidadas em tempo real desde o lançamento.

Por que a Localpayment

Por que usar Bre-B com a Localpayment

  • Uma API para pay-ins e payouts

    Bre-B usa a mesma API de todos os outros meios: POST /api/payin/ para receber, POST /api/payout/ para pagar, a mesma em todos os mercados.

  • Status por webhook em cada transação

    Cada mudança de status chega ao seu endpoint assinada com HMAC-SHA256, para você verificar e automatizar.

  • Conciliação no Business Portal

    Concilie cada transação com seu externalId e nosso internalId, com relatórios do Business Portal e APIs de saldo.

Continue explorando

Perguntas frequentes

Bre-B: perguntas frequentes

Em quanto tempo um pagamento Bre-B é confirmado?

O Bre-B é um trilho em tempo real que confirma em segundos, 24/7. Nos pay-ins o status final chega por webhook assinado; baseie o fluxo dos seus pedidos nessa notificação.

Quais são os limites?

A faixa documentada para contas virtuais é de COP 1 a 11.000.000, e os payouts para chaves Bre-B chegam a COP 11.552.000. Veja a tabela de dados principais e confirme seus limites com seu gerente de conta.

Posso receber e pagar com Bre-B?

Sim. Você recebe por uma conta virtual identificada por uma chave Bre-B e paga as chaves Bre-B dos beneficiários em tempo real, 24/7.

Como é construída a chave Bre-B de uma conta virtual?

De forma determinística a partir do nome do beneficiário informado na criação: prefixo @, LP, os dez primeiros caracteres do nome e um contador de quatro dígitos (10 a 16 caracteres no total). Não é possível escolher uma chave arbitrária.

Como envio um payout para uma chave Bre-B?

Envie POST /api/payout/ com paymentMethod.code 0062, type BankTransfer e flow DIRECT, e coloque a chave do destinatário em beneficiary.bank.account.alias; omita tipo e número de conta.

Um pay-in Bre-B pode ser reembolsado?

Sim, integralmente, com PATCH /api/payin/{externalId}/refund. Os fundos voltam automaticamente para a conta de origem do pagador e o pay-in termina em 902 (REFUNDED).

Quais são os status do payout?

100 Received, 101 Locked (passou no compliance), 102 In Progress (enviado ao Bre-B), 200 Completed (creditado) e 300 Rejected, cada um entregue por webhook assinado.

Adicione Bre-B aos seus recebimentos

Conte quais são seus mercados e volumes. Você começa com credenciais de Stage (ambiente de testes) e nós acompanhamos até a entrada em produção.

Fale com vendasIr para a documentação

Como podemos ajudar?

Baixe o seu exemplar

Deixe seus dados e receba a edição completa na hora.