Pular para o conteúdo

Meios de pagamento · Colômbia

TransfiYa na Colômbia: payouts em tempo real

Pague beneficiários na Colômbia em tempo real, até COP 50.000.000 por transferência, e receba o status final por webhook.

Fale com vendasIr para a documentação
  • Trilho de payouts
  • Colômbia
  • Payout

Dados principais

Payouts conta a conta na Colômbia

Fontes: Banco de la República, Superintendencia Financiera, Banco Mundial.

O que é

Um trilho de payouts em tempo real para a Colômbia

O TransfiYa permite enviar dinheiro a beneficiários na Colômbia em tempo real. Na Localpayment é um método de payout (código 0061) com máximo documentado de COP 50.000.000 por transferência. Os payouts passam por verificações de compliance, aprovação opcional de dupla assinatura e bloqueio de fundos antes de a instrução ser enviada.

  • Payouts em tempo real, código 0061
  • Até COP 50.000.000 por transferência
  • Aprovação opcional de dupla assinatura; status final por webhook assinado

Como funciona

Como funciona um payout com TransfiYa

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 · TransfiYa:

    Bloqueia os fundos e envia a instrução

    O payout passa de Locked a In Progress por TransfiYa.

  3. 3

    Banco · TransfiYaBeneficiá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 TransfiYa em ação

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

  1. 1Comercio EjemploSua plataforma envia um payout de COP 1.200.000,00 por TransfiYa.
  2. 2Banco EjemploO beneficiário vê o crédito de COP 1.200.000,00 na conta ou carteira.
  3. 3Payout concluídoSeu sistema recebe o webhook assinado e atualiza o pedido.
Fale com vendas

Dados principais

TransfiYa: dados principais

  • País

    Detalhe
    🇨🇴 Colômbia

  • Moeda

    Detalhe
    COP

  • Direção

    Detalhe
    Somente payout

  • TransfiYa

    Detalhe
    Em tempo real, 24/7 · COP 40 – 50.000.000

  • Chave Bre-B

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

  • Transferência bancária (ACH)

    Detalhe
    No mesmo dia ou D+1, corte às 15h (horário local) · Mín. COP 40, sem valor máximo

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 TransfiYa

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

  • Como o cliente autoriza

    O beneficiário não faz nada: sua plataforma envia o payout com nome, documento e número de celular (TransfiYa) ou chave Bre-B, e o dinheiro aparece na conta bancária ou carteira em tempo real. Se sua conta exigir aprovação, um segundo usuário assina no Business Portal antes de os fundos saírem.

  • Limites documentados

    TransfiYa (Payout): COP 40 – 50.000.000 · Chave Bre-B (Payout): COP 1 – 11.552.000 · Transferência bancária (ACH) (Payout): Mín. COP 40, sem valor máximo. Por transação, conforme a documentação publicada; os limites contratuais podem variar.

  • Reembolsos e devoluções

    Se o banco do beneficiário rejeitar um payout concluído dias depois (conta encerrada ou inválida), os fundos voltam ao seu saldo Localpayment e o payout passa a Returned, com aviso por webhook. Um recall por dados errados do beneficiário é um pedido manual à nossa equipe de operações e não é garantido.

Checklist de integração

Entre em produção com TransfiYa 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. Abasteça seu saldo

    Os payouts são debitados do seu saldo Localpayment em moeda local; abasteça-o localmente ou via Wire In com FX.

  3. Envie o payout

    POST /api/payout/ com o beneficiário, documento, conta ou alias, valor e um externalId único.

  4. Aprove e acompanhe

    Com requireAuth um segundo usuário aprova; acompanhe Received, Locked, In Progress e Completed por webhook assinado.

  5. Veja o fluxo animado

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

História

Das transferências por celular ao Bre-B

Fonte: Banco de la República, documento técnico Bre-B, fev. 2026.

  1. Nasce o TransfiYa

    A câmara de compensação interbancária da Colômbia lança o TransfiYa: transferências em tempo real entre contas e carteiras de instituições diferentes, endereçadas por número de celular.

  2. Regulado como sistema de baixo valor

    Com as regras do banco central, o TransfiYa passa a ser um dos sistemas de pagamento de baixo valor privados (SPBVI) obrigados a interoperar.

  3. Parte do Bre-B

    O TransfiYa é um dos SPBVI pelos quais as transferências por chave do Bre-B são roteadas, junto com os demais sistemas privados e públicos.

  4. 218 participantes no ecossistema

    Em janeiro de 2026 o ecossistema interoperável soma 218 entidades participantes e mais de 90 milhões de chaves registradas.

Por que a Localpayment

Por que usar TransfiYa com a Localpayment

  • Uma API para pay-ins e payouts

    TransfiYa 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

TransfiYa: perguntas frequentes

Qual é o prazo de um payout TransfiYa?

O TransfiYa está documentado como um método de payout em tempo real. O status do payout passa de Locked a In Progress e o resultado final chega por webhook assinado.

Qual é o valor máximo?

O máximo documentado é COP 50.000.000 por transferência. Veja a tabela de dados principais e confirme seus limites com seu gerente de conta.

Que outros trilhos de payout existem na Colômbia?

Além do TransfiYa, você pode pagar chaves Bre-B em tempo real, 24/7 (até COP 11.552.000) e usar ACH para transferências no mesmo dia ou D+1, com corte às 15h, horário local.

O que preciso do beneficiário para um payout TransfiYa?

Nome, tipo e número de documento e o número de celular cadastrado no banco ou na carteira. Para um payout por chave Bre-B, envie a chave em beneficiary.bank.account.alias e omita o número da conta.

Posso cancelar um payout depois de enviá-lo?

Sim, enquanto estiver em Pending Authorization, Received, Locked ou On Hold. Ao passar para In Progress ele já foi enviado à rede e não pode mais ser cancelado.

O que acontece se a conta estiver encerrada?

Se o banco do beneficiário rejeitar o pagamento após a conclusão, o payout passa a Returned e os fundos voltam ao seu saldo Localpayment, com aviso por webhook.

Quando devo usar ACH?

Para valores acima dos limites em tempo real da tabela de dados principais, ou quando o beneficiário só tem um número de conta tradicional; o ACH liquida no mesmo dia ou D+1 com corte às 15h.

Envie payouts com TransfiYa

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.