Pular para o conteúdo

Meios de pagamento · Argentina · Bolívia · Guatemala · Peru

Pagamentos por QR na Argentina, Bolívia, Guatemala e Peru

Exiba um QR no checkout na Argentina, Bolívia, Peru ou Guatemala. Seu cliente aprova no app do banco ou da carteira e você recebe o status final por webhook.

Fale com vendasIr para a documentação
  • QR
  • Argentina, Bolívia, Guatemala e Peru
  • Pay-in

Dados principais

QR por transferência na Argentina

Números para a Argentina, o maior dos quatro mercados QR desta página (BCRA, Informe de Pagos Minoristas Anual 2025).

O que é

Um método QR, quatro mercados locais

QR é um meio de pagamento alternativo em que o pagador escaneia um código e aprova o pagamento no app do banco ou da carteira. Não há dados de cartão envolvidos. É assíncrono: o status final sempre chega por webhook assinado. A Localpayment oferece na Argentina, Bolívia e Peru, e na Guatemala como QR Fri (SoyFri). Os limites variam por país; veja a tabela de dados principais.

  • Argentina (1050), Bolívia (1150), Peru (6080) e Guatemala QR Fri (1870)
  • O pagador aprova no app do banco ou da carteira; sem dados de cartão
  • Status final por webhook assinado no mesmo endpoint Create Payin

Como funciona

Como funciona um pagamento com QR

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

  1. 1

    Sua empresaLocalpayment:

    Gera o QR

    POST /api/payin/ com país, moeda, valor e dados do pagador. A resposta retorna o QR Code para o pagador escanear, e o pagamento fica pendente até a chegada do status final.

  2. 2

    ClienteBanco · QR:

    O cliente escaneia no app do banco ou da carteira

    O pagador escaneia o QR no app do banco ou da carteira e aprova o pagamento.

  3. 3

    Banco · QRLocalpayment:

    Pagamento

    A Localpayment recebe a confirmação e atualiza a transação.

  4. 4

    LocalpaymentSua empresa:

    Webhook

    Assinado com HMAC-SHA256 (x-Signature). O status 200 indica concluído; deduplique por externalId.

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

Como funciona

Veja QR em ação

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

  1. 1QRO pagador vê um QR Code (ou um código para copiar e colar).
  2. 2Banco EjemploO pagador confere PEN 120,00 e aprova no app do banco ou da carteira.
  3. 3Pagamento confirmadoSeu sistema recebe o webhook assinado e libera o pedido.
Fale com vendas

Dados principais

QR: dados principais

  • Países

    Detalhe
    🇦🇷 Argentina · 🇧🇴 Bolívia · 🇬🇹 Guatemala · 🇵🇪 Peru

  • Moeda

    Detalhe
    ARS · BOB · GTQ · PEN

  • Direção

    Detalhe
    Somente pay-in

  • Argentina · Pagamentos por QR

    Detalhe
    Assíncrono, confirmado por webhook · ARS 1 – 10.000.000

  • Bolívia · Pagamentos por QR

    Detalhe
    Assíncrono, confirmado por webhook · BOB 1 – 1.000.000

  • Guatemala · QR Fri (SoyFri)

    Detalhe
    Assíncrono, confirmado por webhook · GTQ 1 – 10.000

  • Peru · Pagamentos por QR

    Detalhe
    Assíncrono, confirmado por webhook · PEN 1 – 500

  • Status

    Detalhe
    Webhook

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 QR

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

  • Como o cliente autoriza

    O cliente escaneia o QR com o app do banco ou da carteira, escolhe a conta a debitar (você nunca envia os dados bancários dele), confere o valor e confirma. Todo QR traz uma data de expiração na resposta: na Guatemala o código QR Fri expira cinco minutos após ser gerado, então mostre uma contagem regressiva e gere outro quando necessário.

  • Limites documentados

    Pagamentos por QR (Pay-in): ARS 1 – 10.000.000 · Pagamentos por QR (Pay-in): BOB 1 – 1.000.000 · QR Fri (SoyFri) (Pay-in): GTQ 1 – 10.000 · Pagamentos por QR (Pay-in): PEN 1 – 500. Por transação, conforme a documentação publicada; os limites contratuais podem variar.

  • Reembolsos e devoluções

    Um pay-in concluído é reembolsado com PATCH /api/payin/{externalId}/refund. Só há reembolsos totais; o dinheiro volta para uma conta bancária do pagador e a transação termina no status 902 (REFUNDED). Enquanto o pagamento está pendente, ele pode ser cancelado.

Checklist de integração

Entre em produção com QR 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 o QR se tornou interoperável na região

Fontes: BCRA, Informe de Pagos Minoristas Anual 2025; Banco Central de Bolivia; BCRP, Circular 024-2022-BCRP; Banco de Guatemala.

  1. Argentina: Transferências 3.0

    O BCRA torna interoperáveis os pagamentos por QR via transferência: qualquer carteira ou app bancário pode pagar qualquer QR, obrigatório desde o fim de 2021.

  2. Peru: circular de interoperabilidade

    O BCRP determina que carteiras e bancos interoperem; desde 2023 os QR Codes podem ser lidos tanto por apps bancários quanto por carteiras.

  3. Bolívia: o QR cresce 48 vezes

    O esquema de QR interoperável do Banco Central de Bolivia leva o valor pago com QR de BOB 3,2 bilhões em 2021 para BOB 157 bilhões em 2024.

  4. Argentina: 841 milhões de transferências QR

    Os pagamentos por transferência (PCT, principalmente QR) chegam a 841 milhões de operações, +40,7% no ano, além de quase 80 milhões de viagens de transporte pagas com QR.

Por que a Localpayment

Por que usar QR com a Localpayment

  • Uma API para pay-ins e payouts

    QR 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

QR: perguntas frequentes

Onde o QR está disponível?

Na Argentina (código 1050), Bolívia (1150), Peru (6080) e Guatemala, onde se chama QR Fri ou SoyFri (1870).

Como o pagamento é confirmado?

O QR é assíncrono. O pagador aprova no app do banco ou da carteira e o status final chega por webhook assinado; baseie o fluxo dos seus pedidos nessa notificação.

Quais são os limites?

Bolívia: de BOB 1 a 1.000.000. Peru: de PEN 1 a 500. Guatemala: de GTQ 1 a 10.000. Argentina: de ARS 1 a 10.000.000. Confirme seus limites com seu gerente de conta.

Preciso da conta bancária do pagador para criar um QR?

Não. Na Argentina a documentação é explícita: você não envia a conta do pagador; o cliente a seleciona ao escanear. O mesmo vale para os fluxos QR da Bolívia e do Peru.

Qual deve ser o tamanho do QR?

Exiba-o com no mínimo 250×250 pixels (como documentado para a Bolívia) e bom contraste, e mostre o valor ao lado para o pagador conferir antes de confirmar.

Como funcionam os reembolsos de QR?

Apenas totais, com PATCH /api/payin/{externalId}/refund sobre um pay-in concluído. Na Argentina a solicitação de reembolso leva os dados bancários do pagador para devolver o dinheiro pela rede local.

Quais apps pagam um QR Fri na Guatemala?

A documentação lista a carteira Fri e os apps dos bancos participantes e das cooperativas Micoope; dois grandes bancos ficam de fora. Confira a lista vigente na documentação antes de ir ao ar.

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