Aller au contenu

Guatemala · Encaissements et décaissements

Paiements QR et wallet au Guatemala

Encaissez en quetzales via QR Fri, Wallet Fri et les paiements par référence Akisi, et décaissez vers des comptes bancaires guatémaltèques via IFT et ACH.

Contacter l’équipe commercialeDocumentation API : Guatemala
  • QR Fri · Wallet Fri · IFT
  • Devise : GTQ
  • Enregistré
Encaissements
QR Fri
Encaissements
Wallet Fri
Décaissements
GTQ
Enregistré auprès de
SAT

Aperçu du marché

Guatemala en chiffres

Chiffres publics et datés issus de sources officielles. Chaque chiffre renvoie à sa source.

Aperçu du marché

QR et wallets en quetzales

Au Guatemala, Localpayment encaisse en quetzales (GTQ) via l’écosystème QR et wallet Fri et les paiements par référence Akisi, et décaisse vers des comptes bancaires via IFT et ACH. Localpayment est enregistré pour le pay-in et le pay-out auprès de la Surintendance de l’administration fiscale (SAT).

  • QR Fri et Wallet Fri de GTQ 1 à 10 000
  • Paiements par référence Akisi de GTQ 20 à 7 500
  • Décaissements IFT jusqu’à GTQ 20 000, à J+1
  • Décaissements ACH au-delà de GTQ 20 000, à J+1
Comparer tous les moyens de paiement

Expérience de paiement

Comment les clients paient au Guatemala

Choisissez un moyen de paiement pour voir le checkout étape par étape. Écrans et montants illustratifs.

QR Fri (SoyFri)

  1. 1Comercio EjemploLe client choisit QR Fri (SoyFri) pour payer 2 000 GTQ.
  2. 2QR Fri (SoyFri)Un QR code (ou un code à copier-coller) est affiché au payeur.
  3. 3Banco EjemploLe payeur vérifie 2 000 GTQ et valide dans l’app de sa banque ou de son wallet.
  4. 4Paiement confirméVotre système reçoit le webhook signé et libère la commande.

Encaissements

Moyens d’encaissement au Guatemala

Chaque moyen documenté, avec son code API, ses limites et son mode de confirmation.

  • QR Fri (SoyFri)

    Type
    QR
    Code
    1870
    Limites
    GTQ 1 – 10 000
    Confirmation
    Asynchrone, confirmé par webhook
    Remarques
    Le payeur valide le paiement dans l’application de sa banque ou de son wallet

  • Wallet Fri

    Type
    Wallet
    Code
    1880
    Limites
    GTQ 1 – 10 000
    Confirmation
    Asynchrone, confirmé par webhook
    Remarques
    —

  • Paiements par référence Akisi

    Type
    Paiement par référence
    Code
    1811
    Limites
    GTQ 20 – 7 500
    Confirmation
    Asynchrone, confirmé par webhook
    Remarques
    Paiement en ligne avec un numéro de référence

Les codes correspondent aux valeurs paymentMethod.code de l’API. Limites telles que documentées sur docs.localpayment.com ; la disponibilité finale dépend de votre contrat.

Décaissements

Rails de décaissement au Guatemala

Chaque rail documenté, avec son délai, son heure limite et ses limites.

  • Virement bancaire (IFT)

    Type
    Virement bancaire
    Code
    0110
    Délai / heure limite
    J+1 (jour ouvré suivant), heure limite 12:00 (heure locale)
    Limites
    GTQ 1 – 20 000
    Remarques
    —

  • Virement bancaire (ACH)

    Type
    Virement bancaire
    Code
    0110
    Délai / heure limite
    J+1 (jour ouvré suivant), heure limite 12:00 (heure locale)
    Limites
    Plus de GTQ 20 000
    Remarques
    —

Les codes correspondent aux valeurs paymentMethod.code de l’API. Limites telles que documentées sur docs.localpayment.com ; la disponibilité finale dépend de votre contrat.

Licence et réglementation

Guatemala : présence enregistrée

Pay-in et Pay-out — Surintendance de l’administration fiscale (SAT). Avant la mise en production, chaque marchand passe une revue de conformité (due diligence ou due diligence renforcée) et une vérification de l’entreprise (KYB).

  • Statut : Enregistré
  • Identifiants de production après les tests en Stage, une revue de sécurité et le KYB
  • Documents acceptés : NIT, CUI
  • TLS 1.2+, chiffrement AES-256 au repos, MFA et webhooks signés HMAC
Voir toutes les licences

Pour les développeurs

Envoyez votre premier décaissement au Guatemala

Obtenez un jeton d’accès avec POST /api/token/, puis appelez POST /api/payout/ avec le code du rail et le code pays ISO-3. Testez d’abord en Stage : aucun argent réel ne circule.

  • Pays GTM · devise GTQ
  • Rail : Virement bancaire (IFT) · code 0110
  • Statut final par webhook signé HMAC
Guatemala : guide dans la documentation
# Requête d’exemple aux champs simplifiés — voir docs.localpayment.com (Guatemala)
# ACCESS_TOKEN provient de POST /api/token/ et reste valable 5 minutes
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>" }
      }
    }
  }'

Marchés voisins

Poursuivez votre expansion dans la région

Même API, même Business Portal : un nouveau marché est une configuration, pas une nouvelle intégration.

Questions fréquentes

Quels moyens sont disponibles au Guatemala ?

Encaissements : QR Fri (SoyFri), Wallet Fri et Paiements par référence Akisi. Décaissements : Virement bancaire (IFT) et Virement bancaire (ACH). Les tableaux ci-dessus indiquent les codes, limites et délais.

Quels moyens d’encaissement sont disponibles au Guatemala ?

QR Fri, Wallet Fri et les paiements en ligne par référence Akisi, tous confirmés par webhook.

Comment fonctionnent les décaissements au Guatemala ?

Les virements jusqu’à GTQ 20 000 passent par IFT et les montants supérieurs par ACH ; les deux sont réglés à J+1.

Quels documents l’API accepte-t-elle ?

NIT et CUI.

Comment passer en production au Guatemala ?

Parlez de vos flux à notre équipe commerciale. Après la signature du contrat et une revue de conformité (due diligence ou due diligence renforcée), vous recevez des identifiants Stage (sandbox) pour intégrer sans faire circuler d’argent réel. Les identifiants de production suivent les tests en Stage, une revue de sécurité et la vérification de l’entreprise (KYB) : vous pouvez passer en production en quelques semaines.

Produits associés

Lancez-vous au Guatemala

Recevez vos identifiants Stage (sandbox) dès le début du partenariat et passez en production en quelques semaines. Ajouter des pays ensuite relève de la configuration, pas d’une réintégration.

Contacter les ventesVoir la documentation

Comment pouvons-nous vous aider ?

Téléchargez votre exemplaire

Laissez vos coordonnées et recevez l’édition complète immédiatement.