Pular para o conteúdo

Meios de pagamento · Peru

CCI e CCE no Peru: receba por transferência, pague em tempo real até PEN 30.000

Dê aos seus clientes uma conta virtual CCI em soles ou dólares e envie payouts por CCE, LBTR ou direto para uma carteira com a mesma integração.

  • Conta virtual
  • Peru
  • Pay-in · Payout

Dados principais

Transferências imediatas em escala nacional

Números publicados pelo Banco Central de Reserva do Peru.

O que é

Os trilhos interbancários do Peru, de entrada e de saída

No Peru as contas são identificadas por um CCI (código de conta interbancário) e os pagamentos interbancários correm pelo CCE, com LBTR para valores maiores. Com a Localpayment você atribui a cada cliente uma conta virtual CCI em PEN ou USD e concilia os créditos automaticamente; os pay-ins são assíncronos e confirmados por webhook. Em payouts você escolhe a via pelo valor: CCE em tempo real, LBTR no mesmo dia ou CCE direto para uma carteira.

  • Contas virtuais CCI em PEN (até PEN 30.000) e USD (até USD 10.000)
  • Payouts CCE em tempo real, 24/7, até PEN 30.000; LBTR no mesmo dia acima de PEN 30.000
  • Payouts CCE diretos para carteiras em tempo real, de PEN 1 a 500 (até PEN 3.000 para o Yape)

Como funciona

Como se recebe uma transferência CCI

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

    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 CCI

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

    Bloqueia os fundos e envia a instrução

    O payout passa de Locked a In Progress por CCI.

  3. 3

    Banco · CCIBeneficiá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 CCI 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 PEN 1.250,00.
  2. 2Banco EjemploO pagador transfere PEN 1.250,00 para a conta indicada.
  3. 3Pagamento confirmadoSeu sistema recebe o webhook assinado e libera o pedido.

Dados principais

CCI: dados principais

  • País

    Detalhe
    🇵🇪 Peru
  • Moeda

    Detalhe
    PEN · USD
  • Direção

    Detalhe
    Pay-in e payout
  • Pay-in · Conta virtual (CCI, PEN)

    Detalhe
    Assíncrono, confirmado por webhook · PEN 1 – 30.000
  • Pay-in · Conta virtual (CCI, USD)

    Detalhe
    Assíncrono, confirmado por webhook · USD 1 – 10.000
  • Payout · Transferência bancária (CCE)

    Detalhe
    Em tempo real, 24/7 · Até PEN 30.000
  • Payout · Transferência bancária (LBTR)

    Detalhe
    No mesmo dia, corte às 18h (horário local) · Acima de PEN 30.000
  • Payout · Carteiras digitais (CCE, direto)

    Detalhe
    Em tempo real · PEN 1 – 3.000 (Yape) · PEN 1 – 500 (outras carteiras)

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 CCI

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 o CCI de 20 dígitos da conta virtual (em PEN ou USD) com o nome do beneficiário. O cliente abre o app do banco, escolhe “transferir para outro banco”, informa o CCI e o valor, e confirma. O crédito é conciliado com a conta automaticamente e o status final chega por webhook.

  • Limites documentados

    Conta virtual (CCI, PEN) (Pay-in): PEN 1 – 30.000 · Conta virtual (CCI, USD) (Pay-in): USD 1 – 10.000 · Transferência bancária (CCE) (Payout): Até PEN 30.000 · Transferência bancária (LBTR) (Payout): Acima de PEN 30.000 · Carteiras digitais (CCE, direto) (Payout): PEN 1 – 3.000 (Yape) · PEN 1 – 500 (outras carteiras). 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 CCI 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

Da compensação eletrônica de cheques às transferências imediatas 24/7

Fontes: Banco Central de Reserva del Perú, páginas de sistemas de pagamentos e estratégia de interoperabilidade (Circular 0024-2022-BCRP).

  1. Câmara de compensação eletrônica

    A Câmara de Compensação Eletrônica (CCE) do Peru, regulada e supervisionada pelo banco central, substitui em novembro de 2000 a compensação manual de cheques pela compensação eletrônica.

  2. Transferências interbancárias

    É adicionada a compensação de transferências interbancárias: os fundos passam entre contas de diferentes entidades, identificadas pelo seu CCI, com liquidação diferida.

  3. Transferências imediatas

    É lançado o serviço de “Transferencia Inmediata”, que credita as transferências interbancárias em segundos em vez de por ciclos de compensação.

  4. Operação 24/7

    As transferências interbancárias ampliam o horário para 24 horas por dia, 7 dias por semana.

  5. Regulamento de interoperabilidade

    O banco central emite a Circular 0024-2022-BCRP, que torna os serviços de pagamento interoperáveis em fases: carteiras em 2023, apps bancários e QR Codes no mesmo ano, contas de dinheiro eletrônico a partir de dezembro de 2023.

  6. 20 milhões de transferências imediatas por mês

    As transferências imediatas da CCE têm média de 20,6 milhões de operações e cerca de PEN 15 bilhões por mês, com limite por transferência de aproximadamente USD 10.000.

Por que a Localpayment

Por que usar CCI com a Localpayment

  • Uma API para pay-ins e payouts

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

Perguntas frequentes

CCI: perguntas frequentes

Como funcionam os pay-ins CCI e em quanto tempo são confirmados?

Cada cliente, pedido ou fatura recebe uma conta virtual CCI e paga por transferência do próprio banco. Os pay-ins são assíncronos: o status final chega por webhook assinado; conduza o fluxo dos seus pedidos por essa notificação.

Quais são os limites?

As contas virtuais CCI documentam até PEN 30.000 em soles e até USD 10.000 em dólares. Os payouts CCE são em tempo real, 24/7, até PEN 30.000; o payout direto para carteiras por CCE vai de PEN 1 a 500 (até PEN 3.000 para o Yape). Confirme seus próprios limites com seu gerente de conta.

Quando os payouts usam LBTR em vez de CCE?

Acima de PEN 30.000 os payouts usam LBTR, que liquida no mesmo dia em vez de em tempo real. Você envia as duas vias pela mesma API de payouts.

Quais documentos são aceitos no Peru?

Os tipos de documento documentados são DNI, CE, RUC e PASS.

O que é um CCI?

O Código de Cuenta Interbancario é o identificador de conta interbancário de 20 dígitos do Peru. Toda conta virtual da Localpayment no Peru retorna um CCI, e todo beneficiário de payout é identificado pelo seu CCI.

Um pay-in CCI tem chargeback?

Não. A transferência é um pagamento push autorizado pelo pagador no app do próprio banco, então não existe chargeback como no cartão. Devoluções são reembolsos iniciados por você como payout ao pagador.

Como pago direto para uma carteira?

Envie POST /api/payout/ com o código 0171 e o número de celular do beneficiário. O payout direto para carteira pelo CCE é em tempo real para valores de PEN 1 a 500 (até PEN 3.000 para o Yape).

Quais são os status do payout?

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

Adicione CCI 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.

Como podemos ajudar?

Baixe o seu exemplar

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