Moyens de paiement · Argentine · Bolivie · Guatemala · Pérou
Paiements par QR en Argentine, en Bolivie, au Guatemala et au Pérou
Affichez un QR au paiement en Argentine, Bolivie, Pérou ou Guatemala. Votre client valide dans l’app de sa banque ou de son wallet et vous recevez le statut final par webhook.
- QR
- Argentine, Bolivie, Guatemala et Pérou
- Encaissement
QREscanea el QR · vence en 29:59
Ya paguéChiffres clés
QR par virement en Argentine
Chiffres pour l’Argentine, le plus grand des quatre marchés QR de cette page (BCRA, Informe de Pagos Minoristas Anual 2025).
841,2 millions
Paiements interopérables par virement (PCT, principalement QR; transactions, 2025)
80 millions
Trajets en transport public payés par QR, VQR (un peu moins de, 2025)
64,1%
Part des paiements instantanés dans les opérations de paiement de détail (% des opérations, 2025)
61%
Part des virements instantanés push impliquant un compte CVU (% des virements, plus de, 2025)
De quoi s’agit-il
Une méthode QR, quatre marchés locaux
Le QR est un moyen de paiement alternatif : le payeur scanne un code et valide le paiement dans l’app de sa banque ou de son wallet. Aucune donnée de carte n’intervient. Il est asynchrone : le statut final arrive toujours par webhook signé. Localpayment le propose en Argentine, en Bolivie et au Pérou, et au Guatemala sous la forme QR Fri (SoyFri). Les plafonds varient selon le pays ; consultez le tableau des informations clés.
- Argentine (1050), Bolivie (1150), Pérou (6080) et Guatemala QR Fri (1870)
- Le payeur valide dans l’app de sa banque ou de son wallet ; pas de données de carte
- Statut final par webhook signé via le même endpoint Create Payin
Escanea el QR · vence en 29:59
Ya paguéComment ça marche
Comment fonctionne un paiement QR
Les acteurs et les étapes suivent le flux documenté. Le statut final arrive toujours par webhook signé.
- 1
Votre entrepriseLocalpayment:
Génère le QR
POST /api/payin/ avec le pays, la devise, le montant et les données du payeur. La réponse renvoie le QR code que le payeur doit scanner ; le paiement reste en attente jusqu’à l’arrivée du statut final.
- 2
ClientBanque · QR:
Le client scanne dans l’app de sa banque ou de son wallet
Le payeur scanne le QR dans l’app de sa banque ou de son wallet et valide le paiement.
- 3
Banque · QRLocalpayment:
Paiement
Localpayment reçoit la confirmation et met à jour la transaction.
- 4
LocalpaymentVotre entreprise:
Webhook
Signé en HMAC-SHA256 (x-Signature). Le statut 200 signifie terminé ; dédoublonnez sur externalId.
Schéma simplifié. Les délais dépendent du rail et de la banque ; voir les informations clés ci-dessous.
Comment ça marche
QR en action
Un parcours simplifié et fictif. Les noms et les montants sont des exemples.
- 1QRUn QR code (ou un code à copier-coller) est affiché au payeur.
- 2Banco EjemploLe payeur vérifie PEN 120,00 et valide dans l’app de sa banque ou de son wallet.
- 3Paiement confirméVotre système reçoit le webhook signé et libère la commande.
Informations clés
QR : informations clés
Pays
- Détail
- 🇦🇷 Argentine · 🇧🇴 Bolivie · 🇬🇹 Guatemala · 🇵🇪 Pérou
Devise
- Détail
- ARS · BOB · GTQ · PEN
Sens
- Détail
- Encaissement uniquement
Argentine · Paiements par QR code
- Détail
- Asynchrone, confirmé par webhook · ARS 1 – 10 000 000
Bolivie · Paiements par QR code
- Détail
- Asynchrone, confirmé par webhook · BOB 1 – 1 000 000
Guatemala · QR Fri (SoyFri)
- Détail
- Asynchrone, confirmé par webhook · GTQ 1 – 10 000
Pérou · Paiements par QR code
- Détail
- Asynchrone, confirmé par webhook · PEN 1 – 500
Statut
- Détail
- Webhook
Tiré de la documentation Localpayment de chaque pays. Les plafonds et la disponibilité peuvent évoluer ; confirmez-les avec votre gestionnaire de compte.
Expérience client
Ce que voit votre client avec QR
Autorisation, plafonds et remboursements selon docs.localpayment.com. Les plafonds ne sont affichés que lorsque la documentation les précise.
Comment le client autorise
Le client scanne le QR avec l’app de sa banque ou de son wallet, choisit le compte à débiter (vous n’envoyez jamais ses données bancaires), vérifie le montant et confirme. Chaque QR a une date d’expiration dans la réponse : au Guatemala, le code QR Fri expire cinq minutes après sa génération ; affichez un compte à rebours et régénérez-le au besoin.
Plafonds documentés
Paiements par QR code (Encaissement): ARS 1 – 10 000 000 · Paiements par QR code (Encaissement): BOB 1 – 1 000 000 · QR Fri (SoyFri) (Encaissement): GTQ 1 – 10 000 · Paiements par QR code (Encaissement): PEN 1 – 500. Par transaction, selon la documentation publiée ; les plafonds contractuels peuvent différer.
Remboursements et retours
Un encaissement terminé se rembourse avec PATCH /api/payin/{externalId}/refund. Seuls les remboursements intégraux sont pris en charge ; l’argent revient sur un compte bancaire du payeur et la transaction se termine au statut 902 (REFUNDED). Tant qu’un paiement est en attente, il peut être annulé.
Checklist d’intégration
Passez en production avec QR en cinq étapes
La même séquence pour chaque rail. Regardez le checkout animé de ce pays avant de développer.
Obtenez des identifiants Stage
Demandez l’accès, recevez des identifiants sandbox et obtenez un JWT via POST /api/token/.
Créez l’encaissement
POST /api/payin/ avec le code Localpayment du tableau des informations clés, le pays ISO-3, la devise, le montant et les données du payeur.
Affichez les instructions
Affichez le QR, le code, la redirection ou les coordonnées renvoyés et respectez la date d’expiration.
Vérifiez le webhook
Validez x-Signature (HMAC-SHA256), libérez la commande au statut 200 et dédoublonnez sur externalId.
Regardez le checkout animé
Chaque méthode de ce pays, écran par écran, dans la galerie des expériences de paiement.
Historique
Comment le QR est devenu interopérable dans la région
Sources : BCRA, Informe de Pagos Minoristas Anual 2025 ; Banco Central de Bolivia ; BCRP, Circular 024-2022-BCRP ; Banco de Guatemala.
Argentine : Transferencias 3.0
La BCRA rend interopérables les paiements QR par virement : tout wallet ou app bancaire peut payer n’importe quel QR, obligatoire dès fin 2021.
Pérou : circulaire d’interopérabilité
La BCRP impose aux wallets et aux banques d’interopérer ; dès 2023, les QR codes se lisent aussi bien depuis les apps bancaires que depuis les wallets.
Bolivie : le QR multiplié par 48
Le dispositif de QR interopérable de la Banco Central de Bolivia fait passer la valeur payée par QR de 3,2 milliards BOB en 2021 à 157 milliards BOB en 2024.
Argentine : 841 millions de virements QR
Les paiements par virement (PCT, surtout QR) atteignent 841 millions d’opérations, +40,7 % sur l’année, plus près de 80 millions de trajets en transport payés par QR.
Pourquoi Localpayment
Pourquoi utiliser QR avec Localpayment
Une API pour les encaissements et les décaissements
QR utilise la même API que toutes les autres méthodes : POST /api/payin/ pour encaisser, POST /api/payout/ pour décaisser, et de nouveaux marchés par configuration.
Statut par webhook pour chaque transaction
Chaque changement de statut est envoyé à votre endpoint, signé en HMAC-SHA256, pour vérifier et automatiser.
Rapprochement dans le Business Portal
Rapprochez chaque transaction via votre externalId et notre internalId, avec les rapports du Business Portal et les API de solde.
Pour aller plus loin
Encaissements
Encaissez en devise locale avec les méthodes réellement utilisées.
Encaissements —Argentine
Méthodes, rails, devises et licences en Argentine.
Argentine —CVU & COELSA
Rails, plafonds et flux, étape par étape.
CVU & COELSA —Debin
Rails, plafonds et flux, étape par étape.
Debin —Méthodes par pays
L’annuaire complet des encaissements et rails de décaissement documentés.
Méthodes par pays —
FAQ
QR : questions fréquentes
Où le QR est-il disponible ?
En Argentine (code 1050), en Bolivie (1150), au Pérou (6080) et au Guatemala, où il s’appelle QR Fri ou SoyFri (1870).
Comment le paiement est-il confirmé ?
Le QR est asynchrone. Le payeur valide dans l’app de sa banque ou de son wallet et le statut final vous parvient par webhook signé ; construisez votre parcours de commande autour de cette notification.
Quels sont les plafonds ?
Bolivie : de BOB 1 à 1 000 000. Pérou : de PEN 1 à 500. Guatemala : de GTQ 1 à 10 000. Argentine : de ARS 1 à 10 000 000. Confirmez vos plafonds avec votre gestionnaire de compte.
Ai-je besoin du compte bancaire du payeur pour créer un QR ?
Non. Pour l’Argentine, la documentation est explicite : vous n’envoyez pas le compte du payeur ; le client le sélectionne au moment du scan. Il en va de même pour les flux QR de Bolivie et du Pérou.
Quelle taille doit avoir le QR ?
Affichez-le à 250×250 pixels minimum (comme documenté pour la Bolivie) avec un contraste suffisant, et montrez le montant à côté pour que le payeur le vérifie avant de confirmer.
Comment sont gérés les remboursements QR ?
Intégralement uniquement, avec PATCH /api/payin/{externalId}/refund sur un encaissement terminé. En Argentine, la demande de remboursement comporte les coordonnées bancaires du payeur pour renvoyer l’argent via le réseau local.
Quelles apps peuvent payer un QR Fri au Guatemala ?
La documentation liste le wallet Fri ainsi que les apps des banques participantes et des coopératives Micoope ; deux grandes banques sont exclues. Vérifiez la liste en vigueur dans la documentation avant le lancement.
Ajoutez QR à vos encaissements
Indiquez-nous vos marchés et vos volumes. Vous démarrez avec des identifiants Stage (sandbox) et nous vous accompagnons jusqu’à la mise en production.