Vai al contenuto

Metodi di pagamento · Argentina · Bolivia · Guatemala · Perù

Pagamenti con QR in Argentina, Bolivia, Guatemala e Perù

Mostra un QR al checkout in Argentina, Bolivia, Perù o Guatemala. Il tuo cliente approva nell’app della banca o del wallet e tu ricevi lo stato finale via webhook.

Contatta le venditeVai alla documentazione
  • QR
  • Argentina, Bolivia, Guatemala e Perù
  • Incasso

Dati chiave

QR con bonifico in Argentina

Dati per l’Argentina, il più grande dei quattro mercati QR di questa pagina (BCRA, Informe de Pagos Minoristas Anual 2025).

Che cos’è

Un metodo QR, quattro mercati locali

Il QR è un metodo di pagamento alternativo: il pagatore scansiona un codice e approva il pagamento nell’app della banca o del wallet. Non sono coinvolti dati di carta. È asincrono: lo stato finale arriva sempre tramite webhook firmato. Localpayment lo offre in Argentina, Bolivia e Perù, e in Guatemala come QR Fri (SoyFri). I limiti variano per paese; consulta la tabella dei dati chiave.

  • Argentina (1050), Bolivia (1150), Perù (6080) e Guatemala QR Fri (1870)
  • Il pagatore approva nell’app della banca o del wallet; nessun dato di carta
  • Stato finale via webhook firmato con lo stesso endpoint Create Payin

Come funziona

Come funziona un pagamento con QR

Attori e passaggi seguono il flusso documentato. Lo stato finale arriva sempre tramite webhook firmato.

  1. 1

    La tua aziendaLocalpayment:

    Genera il QR

    POST /api/payin/ con paese, valuta, importo e dati del pagatore. La risposta restituisce il QR code da far scansionare al pagatore; il pagamento resta in sospeso fino all’arrivo dello stato finale.

  2. 2

    ClienteBanca · QR:

    Il cliente scansiona nell’app della banca o del wallet

    Il pagatore scansiona il QR nell’app della banca o del wallet e approva il pagamento.

  3. 3

    Banca · QRLocalpayment:

    Pagamento

    Localpayment riceve la conferma e aggiorna la transazione.

  4. 4

    LocalpaymentLa tua azienda:

    Webhook

    Firmato con HMAC-SHA256 (x-Signature). Lo stato 200 indica completato; deduplica su externalId.

Schema semplificato. Le tempistiche dipendono dal circuito e dalla banca; vedi i dati chiave qui sotto.

Come funziona

QR in azione

Un percorso semplificato e fittizio. Nomi e importi sono esempi.

  1. 1QRAl pagatore viene mostrato un QR code (o un codice da copiare).
  2. 2Banco EjemploIl pagatore verifica PEN 120,00 e approva nell’app della banca o del wallet.
  3. 3Pagamento confermatoIl tuo sistema riceve il webhook firmato e rilascia l’ordine.
Contatta le vendite

Dati chiave

QR: dati chiave

  • Paesi

    Dettaglio
    🇦🇷 Argentina · 🇧🇴 Bolivia · 🇬🇹 Guatemala · 🇵🇪 Perù

  • Valuta

    Dettaglio
    ARS · BOB · GTQ · PEN

  • Direzione

    Dettaglio
    Solo incasso

  • Argentina · Pagamenti con QR

    Dettaglio
    Asincrono, confermato via webhook · ARS 1 – 10.000.000

  • Bolivia · Pagamenti con QR

    Dettaglio
    Asincrono, confermato via webhook · BOB 1 – 1.000.000

  • Guatemala · QR Fri (SoyFri)

    Dettaglio
    Asincrono, confermato via webhook · GTQ 1 – 10.000

  • Perù · Pagamenti con QR

    Dettaglio
    Asincrono, confermato via webhook · PEN 1 – 500

  • Stato

    Dettaglio
    Webhook

Tratti dalla documentazione Localpayment di ciascun paese. Limiti e disponibilità possono cambiare; confermali con il tuo account manager.

Esperienza del cliente

Cosa vede il tuo cliente con QR

Autorizzazione, limiti e rimborsi come documentati su docs.localpayment.com. I limiti sono mostrati solo dove la documentazione li indica.

  • Come autorizza il cliente

    Il cliente scansiona il QR con l’app della banca o del wallet, sceglie il conto da addebitare (non invii mai i suoi dati bancari), verifica l’importo e conferma. Ogni QR ha una data di scadenza nella risposta: in Guatemala il codice QR Fri scade cinque minuti dopo la generazione; mostra un conto alla rovescia e rigeneralo quando serve.

  • Limiti documentati

    Pagamenti con QR (Incasso): ARS 1 – 10.000.000 · Pagamenti con QR (Incasso): BOB 1 – 1.000.000 · QR Fri (SoyFri) (Incasso): GTQ 1 – 10.000 · Pagamenti con QR (Incasso): PEN 1 – 500. Per transazione, secondo la documentazione pubblicata; i limiti contrattuali possono variare.

  • Rimborsi e resi

    Un pay-in completato si rimborsa con PATCH /api/payin/{externalId}/refund. Sono supportati solo rimborsi totali; il denaro torna su un conto bancario del pagatore e la transazione termina nello stato 902 (REFUNDED). Finché il pagamento è in sospeso può invece essere annullato.

Checklist di integrazione

Vai in produzione con QR in cinque passi

La stessa sequenza per ogni circuito. Guarda il checkout animato di questo paese prima di sviluppare.

  1. Ottieni le credenziali Stage

    Richiedi l’accesso, ricevi le credenziali sandbox e ottieni un JWT con POST /api/token/.

  2. Crea il pay-in

    POST /api/payin/ con il codice Localpayment della tabella dei dati chiave, paese ISO-3, valuta, importo e dati del pagatore.

  3. Mostra le istruzioni

    Mostra il QR, il codice, il reindirizzamento o i dati del conto della risposta e rispetta la data di scadenza.

  4. Verifica il webhook

    Valida x-Signature (HMAC-SHA256), rilascia l’ordine allo stato 200 e deduplica su externalId.

  5. Guarda il checkout animato

    Ogni metodo di questo paese, schermata per schermata, nella galleria delle esperienze di checkout.

Storia

Come il QR è diventato interoperabile nella regione

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

  1. Argentina: Transferencias 3.0

    La BCRA rende interoperabili i pagamenti QR con bonifico: qualsiasi wallet o app bancaria può pagare qualsiasi QR, obbligatorio da fine 2021.

  2. Perù: circolare sull’interoperabilità

    La BCRP impone a wallet e banche di interoperare; dal 2023 i QR code si leggono sia dalle app bancarie sia dai wallet.

  3. Bolivia: il QR cresce di 48 volte

    Lo schema di QR interoperabile del Banco Central de Bolivia porta il valore pagato con QR da 3,2 miliardi di BOB nel 2021 a 157 miliardi nel 2024.

  4. Argentina: 841 milioni di bonifici QR

    I pagamenti con bonifico (PCT, soprattutto QR) raggiungono 841 milioni di operazioni, +40,7% nell’anno, più quasi 80 milioni di viaggi sui mezzi pagati con QR.

Perché Localpayment

Perché usare QR con Localpayment

  • Un’unica API per incassi e payout

    QR usa la stessa API di tutti gli altri metodi: POST /api/payin/ per incassare, POST /api/payout/ per pagare e nuovi mercati per configurazione.

  • Stato via webhook per ogni transazione

    Ogni cambio di stato arriva al tuo endpoint firmato con HMAC-SHA256, così puoi verificare e automatizzare.

  • Riconciliazione nel Business Portal

    Riconcilia ogni transazione con il tuo externalId e il nostro internalId, con report del Business Portal e API di saldo.

Continua a esplorare

FAQ

QR: domande frequenti

Dove è disponibile il QR?

In Argentina (codice 1050), Bolivia (1150), Perù (6080) e Guatemala, dove si chiama QR Fri o SoyFri (1870).

Come viene confermato il pagamento?

Il QR è asincrono. Il pagatore approva nell’app della banca o del wallet e lo stato finale arriva tramite webhook firmato: costruisci il flusso degli ordini su questa notifica.

Quali sono i limiti?

Bolivia: da BOB 1 a 1.000.000. Perù: da PEN 1 a 500. Guatemala: da GTQ 1 a 10.000. Argentina: da ARS 1 a 10.000.000. Conferma i tuoi limiti con il tuo account manager.

Mi serve il conto bancario del pagatore per creare un QR?

No. Per l’Argentina la documentazione è esplicita: non invii il conto del pagatore; il cliente lo seleziona durante la scansione. Lo stesso vale per i flussi QR di Bolivia e Perù.

Quanto deve essere grande il QR?

Mostralo ad almeno 250×250 pixel (come documentato per la Bolivia) con contrasto sufficiente, e indica l’importo accanto perché il pagatore lo verifichi prima di confermare.

Come si gestiscono i rimborsi QR?

Solo totali, con PATCH /api/payin/{externalId}/refund su un pay-in completato. In Argentina la richiesta di rimborso include i dati bancari del pagatore per restituire il denaro tramite la rete locale.

Quali app possono pagare un QR Fri in Guatemala?

La documentazione elenca il wallet Fri e le app delle banche partecipanti e delle cooperative Micoope; due grandi banche sono escluse. Controlla l’elenco aggiornato nella documentazione prima del lancio.

Aggiungi QR ai tuoi incassi

Raccontaci i tuoi mercati e i volumi. Parti con le credenziali Stage (sandbox) e ti accompagniamo fino al go-live.

Contatta le venditeVai alla documentazione

Come possiamo aiutarti?

Scarica la tua copia

Lasciaci i tuoi dati e ricevi subito l’edizione completa.