Saltar al contenido

Guatemala · Pay-ins y payouts

Pagos con QR y billetera en Guatemala

Cobra en quetzales con QR Fri, Wallet Fri y pagos referenciados Akisi, y paga a cuentas bancarias guatemaltecas por IFT y ACH.

Contactar a ventasDocumentación de Guatemala
  • QR Fri · Wallet Fri · IFT
  • Moneda: GTQ
  • Registrado
Pay-ins
QR Fri
Pay-ins
Wallet Fri
Payouts
GTQ
Registrado ante
SAT

Panorama del mercado

Guatemala en cifras

Cifras públicas y fechadas de fuentes oficiales. Cada número enlaza a su fuente.

Panorama del mercado

QR y billeteras en quetzales

En Guatemala, Localpayment cobra en quetzales (GTQ) con el ecosistema de QR y billetera Fri y pagos referenciados Akisi, y paga a cuentas bancarias por IFT y ACH. Localpayment está registrada para pay-in y pay-out ante la Superintendencia de Administración Tributaria (SAT).

  • QR Fri y Wallet Fri de GTQ 1 a 10.000
  • Pagos referenciados Akisi de GTQ 20 a 7.500
  • Payouts IFT de hasta GTQ 20.000, T+1
  • Payouts ACH por encima de GTQ 20.000, T+1
Compara todos los métodos de pago

Experiencia de checkout

Cómo pagan los clientes en Guatemala

Elige un método de pago para ver el checkout paso a paso. Pantallas y montos ilustrativos.

QR Fri (SoyFri)

  1. 1Comercio EjemploEl cliente elige QR Fri (SoyFri) para pagar 2000 GTQ.
  2. 2QR Fri (SoyFri)Se muestra al pagador un código QR (o un código para copiar y pegar).
  3. 3Banco EjemploEl pagador revisa 2000 GTQ y aprueba en la app de su banco o billetera.
  4. 4Pago confirmadoTu sistema recibe el webhook firmado y libera la orden.

Pay-ins

Métodos de pay-in en Guatemala

Cada método documentado, con su código de API, sus límites y cómo se confirma cada pago.

  • QR Fri (SoyFri)

    Tipo
    QR
    Código
    1870
    Límites
    GTQ 1 – 10.000
    Confirmación
    Asíncrono, confirmado por webhook
    Notas
    El pagador aprueba el pago en la app de su banco o billetera

  • Wallet Fri

    Tipo
    Billetera
    Código
    1880
    Límites
    GTQ 1 – 10.000
    Confirmación
    Asíncrono, confirmado por webhook
    Notas
    —

  • Pagos referenciados Akisi

    Tipo
    Pago referenciado
    Código
    1811
    Límites
    GTQ 20 – 7.500
    Confirmación
    Asíncrono, confirmado por webhook
    Notas
    Pago en línea con número de referencia

Los códigos son los valores de paymentMethod.code en la API. Límites según docs.localpayment.com; la disponibilidad final depende de tu acuerdo.

Payouts

Rieles de payout en Guatemala

Cada riel documentado, con su velocidad, horario de corte y límites.

  • Transferencia bancaria (IFT)

    Tipo
    Transferencia bancaria
    Código
    0110
    Velocidad / corte
    T+1 (siguiente día hábil), corte 12:00 hora local
    Límites
    GTQ 1 – 20.000
    Notas
    —

  • Transferencia bancaria (ACH)

    Tipo
    Transferencia bancaria
    Código
    0110
    Velocidad / corte
    T+1 (siguiente día hábil), corte 12:00 hora local
    Límites
    Más de GTQ 20.000
    Notas
    —

Los códigos son los valores de paymentMethod.code en la API. Límites según docs.localpayment.com; la disponibilidad final depende de tu acuerdo.

Licencia y regulación

Guatemala: presencia registrada

Pay-in y Pay-out — Superintendencia de Administración Tributaria (SAT). Antes de salir a producción, cada comercio completa una revisión de compliance (debida diligencia o debida diligencia reforzada) y la verificación de la empresa (KYB).

  • Estado: Registrado
  • Credenciales de producción tras las pruebas en Stage, una revisión de seguridad y el KYB
  • Documentos aceptados: NIT, CUI
  • TLS 1.2+, cifrado AES-256 en reposo, MFA y webhooks firmados con HMAC
Ver todas las licencias

Para desarrolladores

Envía tu primer payout en Guatemala

Obtén un token de acceso con POST /api/token/ y llama a POST /api/payout/ con el código del riel y el código de país ISO-3. Pruébalo primero en Stage: no se mueve dinero real.

  • País GTM · moneda GTQ
  • Riel: Transferencia bancaria (IFT) · código 0110
  • Estado final por webhook firmado con HMAC
Guía de Guatemala en la documentación
# Solicitud ilustrativa con campos simplificados — consulta la página de Guatemala en docs.localpayment.com
# ACCESS_TOKEN se obtiene con POST /api/token/ y vale 5 minutos
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>" }
      }
    }
  }'

Mercados cercanos

Sigue expandiéndote en la región

La misma API y el mismo Business Portal: un nuevo mercado es una configuración, no una nueva integración.

Preguntas frecuentes

¿Qué métodos están disponibles en Guatemala?

Pay-ins: QR Fri (SoyFri), Wallet Fri y Pagos referenciados Akisi. Payouts: Transferencia bancaria (IFT) y Transferencia bancaria (ACH). Las tablas de arriba muestran códigos, límites y velocidades.

¿Qué métodos de cobro hay en Guatemala?

QR Fri, Wallet Fri y pagos en línea referenciados Akisi, todos confirmados por webhook.

¿Cómo funcionan los payouts en Guatemala?

Las transferencias de hasta GTQ 20.000 van por IFT y los montos mayores por ACH; ambas se acreditan en T+1.

¿Qué documentos acepta la API?

NIT y CUI.

¿Cómo salgo a producción en Guatemala?

Habla con ventas sobre tus flujos. Tras el acuerdo y una revisión de compliance (debida diligencia o debida diligencia reforzada), recibes credenciales de Stage (sandbox) para integrar sin mover dinero real. Las credenciales de producción llegan después de las pruebas en Stage, una revisión de seguridad y la verificación de la empresa (KYB), así que puedes salir a producción en semanas.

Productos relacionados

Empieza a operar en Guatemala

Recibe credenciales de Stage (sandbox) al iniciar la alianza y sal a producción en semanas. Sumar países después es una configuración, no una reintegración.

Contactar a ventasIr a la documentación

¿Cómo podemos ayudarte?

Descarga tu ejemplar

Déjanos tus datos y obtén la edición completa al instante.