Vai al contenuto

Guatemala · Incassi e payout

Pagamenti QR e wallet in Guatemala

Incassa in quetzales con QR Fri, Wallet Fri e pagamenti con riferimento Akisi, ed esegui payout verso conti bancari guatemaltechi tramite IFT e ACH.

Parla con il team commercialeDocumentazione API: Guatemala
  • QR Fri · Wallet Fri · IFT
  • Valuta: GTQ
  • Registrato
Incassi
QR Fri
Incassi
Wallet Fri
Payout
GTQ
Registrato presso
SAT

Panoramica del mercato

Guatemala in cifre

Dati pubblici e datati da fonti ufficiali. Ogni numero rimanda alla sua fonte.

Panoramica del mercato

QR e wallet in quetzales

In Guatemala, Localpayment incassa in quetzales (GTQ) tramite l’ecosistema QR e wallet di Fri e i pagamenti con riferimento Akisi, ed esegue payout verso conti bancari tramite IFT e ACH. Localpayment è registrata per pay-in e pay-out presso la Sovrintendenza dell’Amministrazione Tributaria (SAT).

  • QR Fri e Wallet Fri da GTQ 1 a 10.000
  • Pagamenti con riferimento Akisi da GTQ 20 a 7.500
  • Payout IFT fino a GTQ 20.000, T+1
  • Payout ACH oltre GTQ 20.000, T+1
Confronta tutti i metodi di pagamento

Esperienza di checkout

Come pagano i clienti in Guatemala

Scegli un metodo di pagamento per vedere il checkout passo dopo passo. Schermate e importi illustrativi.

QR Fri (SoyFri)

  1. 1Comercio EjemploIl cliente sceglie QR Fri (SoyFri) per pagare 2000 GTQ.
  2. 2QR Fri (SoyFri)Al pagatore viene mostrato un QR code (o un codice da copiare).
  3. 3Banco EjemploIl pagatore verifica 2000 GTQ e approva nell’app della banca o del wallet.
  4. 4Pagamento confermatoIl tuo sistema riceve il webhook firmato e rilascia l’ordine.

Incassi

Metodi di incasso in Guatemala

Ogni metodo documentato, con codice API, limiti e modalità di conferma di ogni pagamento.

  • QR Fri (SoyFri)

    Tipo
    QR
    Codice
    1870
    Limiti
    GTQ 1 – 10.000
    Conferma
    Asincrono, confermato via webhook
    Note
    Il pagatore approva il pagamento nell’app della sua banca o del suo wallet

  • Wallet Fri

    Tipo
    Wallet
    Codice
    1880
    Limiti
    GTQ 1 – 10.000
    Conferma
    Asincrono, confermato via webhook
    Note
    —

  • Pagamenti con riferimento Akisi

    Tipo
    Pagamento con riferimento
    Codice
    1811
    Limiti
    GTQ 20 – 7.500
    Conferma
    Asincrono, confermato via webhook
    Note
    Pagamento online con numero di riferimento

I codici sono i valori paymentMethod.code dell’API. Limiti come documentati su docs.localpayment.com; la disponibilità finale dipende dal tuo accordo.

Payout

Rail di payout in Guatemala

Ogni rail documentato, con tempistiche, cut-off e limiti.

  • Bonifico bancario (IFT)

    Tipo
    Bonifico bancario
    Codice
    0110
    Tempistiche / cut-off
    T+1 (giorno lavorativo successivo), cut-off alle 12:00 (ora locale)
    Limiti
    GTQ 1 – 20.000
    Note
    —

  • Bonifico bancario (ACH)

    Tipo
    Bonifico bancario
    Codice
    0110
    Tempistiche / cut-off
    T+1 (giorno lavorativo successivo), cut-off alle 12:00 (ora locale)
    Limiti
    Oltre GTQ 20.000
    Note
    —

I codici sono i valori paymentMethod.code dell’API. Limiti come documentati su docs.localpayment.com; la disponibilità finale dipende dal tuo accordo.

Licenza e regolamentazione

Guatemala: presenza registrata

Pay-in e Pay-out — Sovrintendenza dell’Amministrazione Tributaria (SAT). Prima del go-live, ogni merchant completa una revisione di compliance (due diligence o due diligence rafforzata) e la verifica dell’azienda (KYB).

  • Stato: Registrato
  • Credenziali di produzione dopo i test in Stage, una revisione di sicurezza e il KYB
  • Documenti accettati: NIT, CUI
  • TLS 1.2+, crittografia AES-256 dei dati a riposo, MFA e webhook firmati HMAC
Vedi tutte le licenze

Per sviluppatori

Invia il tuo primo payout in Guatemala

Ottieni un token di accesso con POST /api/token/, poi chiama POST /api/payout/ con il codice del rail e il codice paese ISO-3. Prova prima in Stage: non si muove denaro reale.

  • Paese GTM · valuta GTQ
  • Rail: Bonifico bancario (IFT) · codice 0110
  • Stato finale tramite webhook firmato HMAC
Guatemala: guida nella documentazione
# Richiesta di esempio con campi semplificati — vedi docs.localpayment.com (Guatemala)
# ACCESS_TOKEN si ottiene con POST /api/token/ ed è valido 5 minuti
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>" }
      }
    }
  }'

Mercati vicini

Continua a espanderti nella regione

Stessa API, stesso Business Portal: un nuovo mercato è una configurazione, non una nuova integrazione.

Domande frequenti

Quali metodi sono disponibili in Guatemala?

Incassi: QR Fri (SoyFri), Wallet Fri e Pagamenti con riferimento Akisi. Payout: Bonifico bancario (IFT) e Bonifico bancario (ACH). Le tabelle qui sopra riportano codici, limiti e tempistiche.

Quali metodi di incasso sono disponibili in Guatemala?

QR Fri, Wallet Fri e pagamenti online con riferimento Akisi, tutti confermati via webhook.

Come funzionano i payout in Guatemala?

I bonifici fino a GTQ 20.000 passano per IFT e gli importi superiori per ACH; entrambi vengono regolati in T+1.

Quali documenti accetta l’API?

NIT e CUI.

Come vado live in Guatemala?

Parla dei tuoi flussi con il team commerciale. Dopo l’accordo e una revisione di compliance (due diligence o due diligence rafforzata), ricevi le credenziali Stage (sandbox) per integrare senza muovere denaro reale. Le credenziali di produzione arrivano dopo i test in Stage, una revisione di sicurezza e la verifica dell’azienda (KYB), così puoi andare live in poche settimane.

Prodotti correlati

Inizia a operare in Guatemala

Ricevi le credenziali Stage (sandbox) all’avvio della partnership e vai live in poche settimane. Aggiungere paesi in seguito è una configurazione, non una reintegrazione.

Contatta le venditeVai alla documentazione

Come possiamo aiutarti?

Scarica la tua copia

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