Zum Inhalt springen

Zahlungsmethoden · Argentinien · Bolivien · Guatemala · Peru

QR-Zahlungen in Argentinien, Bolivien, Guatemala und Peru

Zeigen Sie im Checkout in Argentinien, Bolivien, Peru oder Guatemala einen QR-Code an. Ihr Kunde bestätigt in seiner Bank- oder Wallet-App, den Endstatus erhalten Sie per Webhook.

Vertrieb kontaktierenZur Dokumentation
  • QR
  • Argentinien, Bolivien, Guatemala und Peru
  • Pay-in

Eckdaten

QR per Überweisung in Argentinien

Zahlen für Argentinien, den größten der vier QR-Märkte dieser Seite (BCRA, Informe de Pagos Minoristas Anual 2025).

Was es ist

Eine QR-Methode, vier lokale Märkte

QR ist eine alternative Zahlungsmethode: Der Zahler scannt einen Code und gibt die Zahlung in seiner Bank- oder Wallet-App frei. Es sind keine Kartendaten beteiligt. Die Methode ist asynchron, der Endstatus kommt immer per signiertem Webhook. Localpayment bietet sie in Argentinien, Bolivien und Peru an, in Guatemala als QR Fri (SoyFri). Die Limits unterscheiden sich je Land, siehe die Eckdaten.

  • Argentinien (1050), Bolivien (1150), Peru (6080) und Guatemala QR Fri (1870)
  • Freigabe in der Bank- oder Wallet-App des Zahlers; keine Kartendaten
  • Endstatus per signiertem Webhook über denselben Create-Payin-Endpunkt

So funktioniert es

So funktioniert eine QR-Zahlung

Akteure und Schritte folgen dem dokumentierten Ablauf. Der Endstatus kommt immer per signiertem Webhook.

  1. 1

    Ihr UnternehmenLocalpayment:

    Erzeugt den QR-Code

    POST /api/payin/ mit Land, Währung, Betrag und Zahlerdaten. Die Antwort liefert den QR-Code zum Scannen durch den Zahler; die Zahlung bleibt offen, bis der Endstatus eintrifft.

  2. 2

    KundeBank · QR:

    Kunde scannt in der Bank- oder Wallet-App

    Der Zahler scannt den QR-Code in seiner Bank- oder Wallet-App und gibt die Zahlung frei.

  3. 3

    Bank · QRLocalpayment:

    Zahlung

    Localpayment erhält die Bestätigung und aktualisiert die Transaktion.

  4. 4

    LocalpaymentIhr Unternehmen:

    Webhook

    Mit HMAC-SHA256 signiert (x-Signature). Status 200 bedeutet abgeschlossen; über externalId deduplizieren.

Vereinfachte Darstellung. Die Dauer hängt von Schiene und Bank ab; siehe die Eckdaten unten.

So funktioniert es

QR in Aktion

Ein vereinfachter, fiktiver Ablauf. Namen und Beträge sind Beispiele.

  1. 1QRDem Zahler wird ein QR-Code (oder ein Kopiercode) angezeigt.
  2. 2Banco EjemploDer Zahler prüft PEN 120,00 und gibt in seiner Bank- oder Wallet-App frei.
  3. 3Zahlung bestätigtIhr System empfängt den signierten Webhook und gibt den Auftrag frei.
Vertrieb kontaktieren

Eckdaten

QR: Eckdaten

  • Länder

    Detail
    🇦🇷 Argentinien · 🇧🇴 Bolivien · 🇬🇹 Guatemala · 🇵🇪 Peru

  • Währung

    Detail
    ARS · BOB · GTQ · PEN

  • Richtung

    Detail
    Nur Pay-in

  • Argentinien · QR-Zahlungen

    Detail
    Asynchron, Bestätigung per Webhook · ARS 1 – 10.000.000

  • Bolivien · QR-Zahlungen

    Detail
    Asynchron, Bestätigung per Webhook · BOB 1 – 1.000.000

  • Guatemala · QR Fri (SoyFri)

    Detail
    Asynchron, Bestätigung per Webhook · GTQ 1 – 10.000

  • Peru · QR-Zahlungen

    Detail
    Asynchron, Bestätigung per Webhook · PEN 1 – 500

  • Status

    Detail
    Webhook

Entnommen der Localpayment-Dokumentation je Land. Limits und Verfügbarkeit können sich ändern; bitte mit Ihrem Account Manager abstimmen.

Kundenerlebnis

Was Ihr Kunde bei QR erlebt

Autorisierung, Limits und Erstattungen gemäß docs.localpayment.com. Limits erscheinen nur, wo die Dokumentation sie nennt.

  • So autorisiert der Kunde

    Der Kunde scannt den QR mit seiner Bank- oder Wallet-App, wählt das zu belastende Konto (Sie senden nie seine Bankdaten), prüft den Betrag und bestätigt. Jeder QR hat ein Ablaufdatum in der Antwort: In Guatemala verfällt der QR-Fri-Code fünf Minuten nach Erzeugung; zeigen Sie einen Countdown und erzeugen Sie ihn bei Bedarf neu.

  • Dokumentierte Limits

    QR-Zahlungen (Pay-in): ARS 1 – 10.000.000 · QR-Zahlungen (Pay-in): BOB 1 – 1.000.000 · QR Fri (SoyFri) (Pay-in): GTQ 1 – 10.000 · QR-Zahlungen (Pay-in): PEN 1 – 500. Pro Transaktion, laut veröffentlichter Dokumentation; vertragliche Limits können abweichen.

  • Erstattungen und Rückläufer

    Ein abgeschlossener Pay-in wird mit PATCH /api/payin/{externalId}/refund erstattet. Nur Vollerstattungen sind möglich; das Geld geht auf ein Bankkonto des Zahlers zurück und die Transaktion endet im Status 902 (REFUNDED). Solange eine Zahlung aussteht, kann sie stattdessen storniert werden.

Integrations-Checkliste

Mit QR in fünf Schritten live gehen

Dieselbe Abfolge für jede Schiene. Sehen Sie sich vor der Umsetzung den animierten Checkout für dieses Land an.

  1. Stage-Zugangsdaten erhalten

    Zugang anfragen, Sandbox-Zugangsdaten erhalten und per POST /api/token/ ein JWT beziehen.

  2. Pay-in anlegen

    POST /api/payin/ mit dem Localpayment-Code aus der Eckdaten-Tabelle, ISO-3-Land, Währung, Betrag und Zahlerdaten.

  3. Anweisungen anzeigen

    QR, Code, Weiterleitung oder Kontodaten aus der Antwort darstellen und das Ablaufdatum beachten.

  4. Webhook prüfen

    x-Signature (HMAC-SHA256) validieren, bei Status 200 die Bestellung freigeben und über externalId deduplizieren.

  5. Animierten Checkout ansehen

    Jede Methode dieses Landes, Screen für Screen, in der Galerie der Checkout-Erlebnisse.

Geschichte

Wie QR in der Region interoperabel wurde

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

  1. Argentinien: Transferencias 3.0

    Die BCRA macht QR-Zahlungen per Überweisung interoperabel: Jede Wallet oder Bank-App kann jeden QR bezahlen, verpflichtend ab Ende 2021.

  2. Peru: Interoperabilitätsrundschreiben

    Die BCRP verpflichtet Wallets und Banken zur Interoperabilität; ab 2023 lesen Bank-Apps und Wallets dieselben QR-Codes.

  3. Bolivien: QR wächst um das 48-Fache

    Das interoperable QR-System der Banco Central de Bolivia hebt den QR-Zahlungswert von 3,2 Mrd. BOB 2021 auf 157 Mrd. BOB 2024.

  4. Argentinien: 841 Millionen QR-Überweisungen

    Zahlungen per Überweisung (PCT, überwiegend QR) erreichen 841 Millionen Vorgänge, +40,7 % im Jahr, plus knapp 80 Millionen QR-Fahrten im Nahverkehr.

Warum Localpayment

Warum QR mit Localpayment nutzen

  • Eine API für Pay-ins und Auszahlungen

    QR läuft über dieselbe API wie jede andere Methode: POST /api/payin/ zum Einziehen, POST /api/payout/ zum Auszahlen, neue Märkte per Konfiguration.

  • Webhook-Status für jede Transaktion

    Jede Statusänderung wird mit HMAC-SHA256 signiert an Ihren Endpunkt gesendet, damit Sie prüfen und automatisieren können.

  • Abgleich im Business Portal

    Gleichen Sie jede Transaktion über Ihre externalId und unsere internalId ab, mit Business-Portal-Berichten und Saldo-APIs.

Weiterlesen

FAQ

QR: häufige Fragen

Wo ist QR verfügbar?

In Argentinien (Code 1050), Bolivien (1150), Peru (6080) und Guatemala, wo es QR Fri bzw. SoyFri heißt (1870).

Wie wird die Zahlung bestätigt?

QR ist asynchron. Der Zahler gibt in seiner Bank- oder Wallet-App frei und der Endstatus erreicht Sie per signiertem Webhook; richten Sie Ihren Bestellablauf an dieser Benachrichtigung aus.

Welche Limits gelten?

Bolivien: BOB 1 bis 1.000.000. Peru: PEN 1 bis 500. Guatemala: GTQ 1 bis 10.000. Argentinien: ARS 1 bis 10.000.000. Stimmen Sie Ihre Limits mit Ihrem Account Manager ab.

Brauche ich das Bankkonto des Zahlers, um einen QR zu erzeugen?

Nein. Für Argentinien ist die Dokumentation eindeutig: Sie senden das Konto des Zahlers nicht; der Kunde wählt es beim Scannen. Dasselbe gilt für die QR-Abläufe in Bolivien und Peru.

Wie groß sollte der QR sein?

Mindestens 250×250 Pixel (wie für Bolivien dokumentiert) mit ausreichendem Kontrast; zeigen Sie den Betrag daneben, damit der Zahler ihn vor der Bestätigung prüfen kann.

Wie laufen QR-Erstattungen?

Nur in voller Höhe, mit PATCH /api/payin/{externalId}/refund für einen abgeschlossenen Pay-in. In Argentinien enthält die Erstattungsanfrage die Bankdaten des Zahlers, damit das Geld über das lokale Netz zurückgeht.

Welche Apps können in Guatemala einen QR Fri bezahlen?

Die Dokumentation nennt die Fri-Wallet sowie die Apps teilnehmender Banken und Micoope-Genossenschaften; zwei große Banken sind ausgenommen. Prüfen Sie vor dem Start die aktuelle Liste in der Dokumentation.

QR in Ihre Zahlungen aufnehmen

Nennen Sie uns Ihre Märkte und Volumina. Sie starten mit Stage-Zugangsdaten (Sandbox), wir begleiten Sie bis zum Go-live.

Vertrieb kontaktierenZur Dokumentation

Wie können wir helfen?

Ihr Exemplar herunterladen

Hinterlassen Sie Ihre Daten und erhalten Sie sofort die vollständige Ausgabe.