Zum Inhalt springen

Guatemala · Pay-ins & Auszahlungen

QR- und Wallet-Zahlungen in Guatemala

Nehmen Sie Zahlungen in Quetzales per QR Fri, Wallet Fri und Akisi-Zahlungen mit Referenz an, und zahlen Sie über IFT und ACH auf guatemaltekische Bankkonten aus.

Vertrieb kontaktierenAPI-Dokumentation: Guatemala
  • QR Fri · Wallet Fri · IFT
  • Währung: GTQ
  • Registriert
Pay-ins
QR Fri
Pay-ins
Wallet Fri
Auszahlungen
GTQ
Registriert bei
SAT

Markt im Überblick

Guatemala in Zahlen

Öffentliche, datierte Zahlen aus offiziellen Quellen. Jede Zahl verlinkt auf ihre Quelle.

Marktüberblick

QR und Wallets in Quetzales

In Guatemala nimmt Localpayment Zahlungen in Quetzales (GTQ) über das Fri-Ökosystem aus QR und Wallet sowie über Akisi-Zahlungen mit Referenz an und zahlt über IFT und ACH auf Bankkonten aus. Localpayment ist für Pay-in und Pay-out bei der Steuerverwaltungsbehörde (SAT) registriert.

  • QR Fri und Wallet Fri von GTQ 1 bis 10.000
  • Akisi-Zahlungen mit Referenz von GTQ 20 bis 7.500
  • IFT-Auszahlungen bis GTQ 20.000, T+1
  • ACH-Auszahlungen über GTQ 20.000, T+1
Alle Zahlungsmethoden vergleichen

Checkout-Erlebnis

So zahlen Kunden in Guatemala

Wählen Sie eine Zahlungsmethode, um den Checkout Schritt für Schritt zu sehen. Screens und Beträge sind beispielhaft.

QR Fri (SoyFri)

  1. 1Comercio EjemploDer Kunde wählt QR Fri (SoyFri), um 2.000 GTQ zu bezahlen.
  2. 2QR Fri (SoyFri)Dem Zahler wird ein QR-Code (oder ein Kopiercode) angezeigt.
  3. 3Banco EjemploDer Zahler prüft 2.000 GTQ und gibt in seiner Bank- oder Wallet-App frei.
  4. 4Zahlung bestätigtIhr System empfängt den signierten Webhook und gibt den Auftrag frei.

Pay-ins

Pay-in-Methoden in Guatemala

Jede dokumentierte Methode mit API-Code, Limits und der Art, wie jede Zahlung bestätigt wird.

  • QR Fri (SoyFri)

    Typ
    QR
    Code
    1870
    Limits
    GTQ 1 – 10.000
    Bestätigung
    Asynchron, Bestätigung per Webhook
    Hinweise
    Der Zahler autorisiert die Zahlung in seiner Banking- oder Wallet-App

  • Wallet Fri

    Typ
    Wallet
    Code
    1880
    Limits
    GTQ 1 – 10.000
    Bestätigung
    Asynchron, Bestätigung per Webhook
    Hinweise
    —

  • Akisi-Zahlungen mit Referenz

    Typ
    Zahlung mit Referenz
    Code
    1811
    Limits
    GTQ 20 – 7.500
    Bestätigung
    Asynchron, Bestätigung per Webhook
    Hinweise
    Online-Zahlung mit Referenznummer

Die Codes sind die paymentMethod.code-Werte der API. Limits gemäß docs.localpayment.com; die endgültige Verfügbarkeit hängt von Ihrem Vertrag ab.

Auszahlungen

Auszahlungswege in Guatemala

Jedes dokumentierte Zahlungsnetz mit Laufzeit, Annahmeschluss und Limits.

  • Banküberweisung (IFT)

    Typ
    Banküberweisung
    Code
    0110
    Laufzeit / Annahmeschluss
    T+1 (nächster Geschäftstag), Annahmeschluss 12:00 Uhr (Ortszeit)
    Limits
    GTQ 1 – 20.000
    Hinweise
    —

  • Banküberweisung (ACH)

    Typ
    Banküberweisung
    Code
    0110
    Laufzeit / Annahmeschluss
    T+1 (nächster Geschäftstag), Annahmeschluss 12:00 Uhr (Ortszeit)
    Limits
    Über GTQ 20.000
    Hinweise
    —

Die Codes sind die paymentMethod.code-Werte der API. Limits gemäß docs.localpayment.com; die endgültige Verfügbarkeit hängt von Ihrem Vertrag ab.

Lizenz & Regulierung

Guatemala: registrierte Präsenz

Pay-in und Pay-out — Steuerverwaltungsbehörde (SAT). Vor dem Go-live durchläuft jeder Händler eine Compliance-Prüfung (Due Diligence oder Enhanced Due Diligence) und eine Unternehmensverifizierung (KYB).

  • Status: Registriert
  • Produktionszugangsdaten nach Stage-Tests, Security-Review und KYB
  • Akzeptierte Dokumente: NIT, CUI
  • TLS 1.2+, AES-256-Verschlüsselung ruhender Daten, MFA und HMAC-signierte Webhooks
Alle Lizenzen ansehen

Für Entwickler

Senden Sie Ihre erste Auszahlung in Guatemala

Holen Sie sich mit POST /api/token/ ein Zugriffstoken und rufen Sie dann POST /api/payout/ mit dem Code des Zahlungsnetzes und dem ISO-3-Ländercode auf. Testen Sie zuerst in Stage: Dabei fließt kein echtes Geld.

  • Land GTM · Währung GTQ
  • Zahlungsnetz: Banküberweisung (IFT) · Code 0110
  • Finaler Status per HMAC-signiertem Webhook
Guatemala: Leitfaden in der Dokumentation
# Beispielanfrage mit vereinfachten Feldern — Details auf docs.localpayment.com (Guatemala)
# ACCESS_TOKEN stammt aus POST /api/token/ und ist 5 Minuten gültig
curl -X POST https://api.stage.localpayment.com/api/payout/ \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "externalId": "payout-gt-000184",
    "country": "GTM",
    "currency": "GTQ",
    "amount": 2000,
    "paymentMethod": {
      "type": "BankTransfer",
      "code": "0110",
      "flow": "DIRECT"
    },
    "accountNumber": "<your-account-number>",
    "conceptCode": "0001",
    "beneficiary": {
      "type": "INDIVIDUAL",
      "name": "Sofía",
      "lastname": "López",
      "document": { "type": "NIT", "id": "0000000-0" },
      "bank": {
        "account": { "number": "<beneficiary-account-number>" }
      }
    }
  }'

Nachbarmärkte

Expandieren Sie weiter in der Region

Gleiche API, gleiches Business Portal: Ein neuer Markt ist eine Konfiguration, keine neue Integration.

Häufige Fragen

Welche Methoden sind in Guatemala verfügbar?

Pay-ins: QR Fri (SoyFri), Wallet Fri und Akisi-Zahlungen mit Referenz. Auszahlungen: Banküberweisung (IFT) und Banküberweisung (ACH). Die Tabellen oben zeigen Codes, Limits und Laufzeiten.

Welche Pay-in-Methoden sind in Guatemala verfügbar?

QR Fri, Wallet Fri und Akisi-Online-Zahlungen mit Referenz, jeweils bestätigt per Webhook.

Wie funktionieren Auszahlungen in Guatemala?

Überweisungen bis GTQ 20.000 laufen über IFT, höhere Beträge über ACH; beide werden mit T+1 abgewickelt.

Welche Dokumente akzeptiert die API?

NIT und CUI.

Wie gehe ich in Guatemala live?

Sprechen Sie mit dem Vertrieb über Ihre Zahlungsflüsse. Nach Vertragsabschluss und einer Compliance-Prüfung (Due Diligence oder Enhanced Due Diligence) erhalten Sie Stage-Zugangsdaten (Sandbox), um ohne echtes Geld zu integrieren. Die Produktionszugangsdaten folgen nach Stage-Tests, einem Security-Review und der Unternehmensverifizierung (KYB) — so gehen Sie in wenigen Wochen live.

Verwandte Produkte

Starten Sie in Guatemala

Erhalten Sie Stage-Zugangsdaten (Sandbox) zu Beginn der Partnerschaft und gehen Sie in wenigen Wochen live. Weitere Länder kommen später per Konfiguration hinzu, ohne Neuintegration.

Vertrieb kontaktierenZur Dokumentation

Wie können wir helfen?

Ihr Exemplar herunterladen

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