Guatemala

Guatemala se destaca como un centro estratégico de tecnología financiera en Centroamérica. Con una sólida red bancaria y un creciente ecosistema de servicios financieros digitales, el país ofrece una amplia gama de métodos de pago, desde tarjetas tradicionales y transferencias bancarias locales hasta billeteras emergentes y opciones basadas en efectivo.

Los negocios pueden aceptar pagos mediante transferencias bancarias directas, redes populares de depósito de efectivo y billeteras digitales.

tip

Tenga en cuenta que el proceso es siempre el mismo, antes de procesar la transacción debe crear la orden, aquí hay un ejemplo del cuerpo de la orden para este país.

{
    "country": "GTM",
    "origin": "api",
    "amount": "10",
    "email": "test@gmail.com"
}

Tipos de documentos de identificación aceptados

• DPI: Documento Personal de Identificación

Pay In

Guatemala ofrece una variedad de métodos de pago adecuados tanto para usuarios locales como internacionales. Los negocios pueden aceptar pagos mediante tarjetas de crédito/débito, transferencias bancarias directas, redes populares de depósito de efectivo y billeteras digitales.

Transacción con Tarjeta

Una vez que la orden haya sido creada exitosamente, puedes proceder a procesar la transacción con tarjeta. Esto devolverá una URL de checkout a la cual será redirigido el cliente para diligenciar su información de contacto y los datos de la tarjeta. Estos datos son requeridos para completar la transacción.

aviso

Todas las transacciones con tarjeta están habilitadas con 3DS (3D Secure).
Cualquier tarjeta que no esté enrolada en 3DS no será procesada.

Tipo Transacción	Tipo Pago	Método de pago	Proveedores admitidos	Logotipos
card+	credit	tc	Visa, Mastercard

Completar transacción - Cuerpo (Solicitud de ejemplo)

{
    "hash": "U2FsdGVkX19LCMkFlp2...",
    "paymentMethod": "tc",
    "typePayment": "credit",
    "typeTransaction": "card+",
    "merchantId": "123sas-46564s-45454-123",
    "urlReturn": "https://google.com"
}

Tarjetas de Prueba

Utiliza los siguientes números de tarjeta de prueba para simular diferentes escenarios de transacción con tarjeta en el entorno sandbox. Estas tarjetas funcionan únicamente en modo de prueba y no generan pagos reales.

Número de Tarjeta	CVV	Fecha de Expiración	Resultado
4242424242424846	123	12/29	Transacción exitosa
4242424242424341	123	12/29	Transacción rechazada
4032037236725541	123	12/29	Tarjeta no permite validación 3DS

Completar transacción - Respuesta de ejemplo

{
    "status": {
        "code": 202,
        "message": "success",
        "kind": "unknown"
    },
    "data": {
        "typePayment": "card+",
        "country": "GTM",
        "amount": "100",
        "merchantId": "123sas-xxxxxxx-xxxxxxx-123",
        "urlReturn": "https://google.com",
        "payment": {
            "id": 3451,
            "uuid": "f104696e-xxxx-xxxx-xxxx-a3910af5dd97",
            "merchant": "xxxxxxx@gmail.com",
            "merchantUuid": "eb8da979-xxxx-xxxx-xxxx-719c501cb757",
            "country": "GTM",
            "origin": "api",
            "status": "processing",
            "createdAt": "2025-06-12T14:02:32.000Z",
            "type": "cashin",
            "amount": 100,
            "rate": null,
            "rateAmount": null,
            "total": null,
            "rejectionReason": null,
            "rateProviderAmount": null,
            "sandbox": 1,
            "currency": "",
            "paymentMethod": "tc",
            "typeMethod": "credit"
        }
    },
    "urlCheckout": "https://checkout-transactions-latam.88pay.io/es?..."
}

---

Transferencia bancaria

Tipo Transacción	Tipo Pago	Método de pago	Proveedores admitidos	Logotipos
bankin	bank	bi	Banco Industrial
		bam_transferencia	Bam transferencias
		bancorural	Bancorural

Completar transacción - Cuerpo (Solicitud de ejemplo)

{
    "hash": "U2FsdGVkX19oU6%....",
    "paymentMethod" : "bam_transferencia",
    "typePayment" : "bank",
    "typeTransaction":"bankin",
    "description" : "Test order",
    "customer": {
        "typeDocument":"DNI",
        "document" : "1234567890",
        "name": "Juan",
        "lastName":"Pérez",
        "phoneNumber":"3133133131"
    },
    "address": {
        "line1": "123 First Street",
        "line2": "",
        "countryCode": "US",
        "stateProvince": "FL",
        "city": "Orlando",
        "postalCode": "32830"
    },
}

Completar transacción - Cuerpo (Solicitud de ejemplo con el metodo BI)

{
    "hash":"U2FsdGV...",
    "paymentMethod" : "bi",
    "typePayment" : "bank",
    "typeTransaction":"bankin",
    "description" : "test order"
}

Transaccion Procesada - Response (Respuesta de ejemplo con el metodo BI)

{
    "status": {
        "code": 202,
        "message": "success",
        "kind": "unknown"
    },
    "data": {
        "Reference": "xxxxxx",
        "bank": "Banco Industrial",
        "cuid": "33-xxxxxxxxx-9",
        "cuenta_corriente_en_pesos": "xxxxxxxxxxxxx",
        "cbu": "xxxxxxxxxxxxxxxxxxxxx",
        "alias": "xxxxxx.xxxxxx.xxxxxx",
        "isRedirect": false,
        "urlWebhook": "www.88pay.io",
        "emailOrder": "email@gmail.com",
        "payment": {
            "id": 1004,
            "uuid": "30d545a5-xxxx-xxxx-xxxx-fde7e8dcf8db",
            "merchant": "test.88pay@gmail.com",
            "merchantUuid": "d6d29ad2-xxxx-xxxx-xxxx-55d518578434",
            "country": "GTM",
            "origin": "api",
            "status": "processing",
            "createdAt": "2025-06-04T06:33:30.000Z",
            "amount": 50,
            "rate": null,
            "rateAmount": null,
            "total": null,
            "rejectionReason": null,
            "rateProviderAmount": null,
            "sandbox": 1,
            "currency": "",
            "paymentMethod": "bi",
            "typeMethod": "bank"
        },
        "checkout": "https://transactions.88pay.io/?m=d6d29ad2-xxxx-xxxx-xxxx-55d518578434&amount=50&type=bank&reference=XXXXXX&method=hipotecario&currency=ARS&u=&cid=jvadu7cASfqMSvbVS2gwnTmhWGEFfZK7Av2CqYViOY=&l=&inst_id=942c005d-xxxx-xxxx-xxxx-991ddf1b4db4"
    }
}

Checkout

En el cuerpo de respuesta viene una propiedad con el nombre checkout la cual será la URL que llevara a la hoja de instrucciones de pago, en donde se indicara como proceder con el pago

El usuario deberá seguir con el proceso segun las indicaciones dada en la hoja de instrucciones

---

Cash

Tipo Transacción	Tipo Pago	Método de pago	Proveedores admitidos	Logotipos
cashin	cash	akisi	Akisi
		bam	Bam Efectivo

Completar transacción - Cuerpo (Solicitud de ejemplo)

{
    "hash": "U2FsdGV...",
    "paymentMethod" : "akisi",
    "typePayment" : "cash",
    "typeTransaction":"cashin",
    "description" : "Orden de prueba",
    "merchantId":"11223344"
}

---

Pay Out

Nuestras capacidades de pago en Guatemala le permiten desembolsar fondos a través de cuentas bancarias, puntos de retiro de efectivo o transferencias de billetera. Esto es ideal para remesas, pagos de afiliados y liquidaciones en mercados.

Cash - Cash out

Tipo Transacción	Tipo Pago	Método de pago	Proveedores admitidos	Logotipos
bankout	bank	banco-industrial	Banco Industrial
		super24	Super 24
cashout	cash	akisi	Akisi

Completar transacción - Cuerpo (Solicitud de ejemplo)

{
    "hash": "U2FsdGVkX19oU6%....",
    "paymentMethod" : "akisi",
    "typePayment" : "cash",
    "typeTransaction":"cashout",
    "description" : "Test order",
    "customer": {
        "typeDocument":"DPI",
        "document" : "1234567890",
        "name": "Juan",
        "lastName":"Pérez",
        "phoneNumber":"3133133131"
    },
}

Bank - Bank out

Tipo Transacción	Tipo Pago	Método de pago	Proveedores admitidos	Logotipos
bankout	bank	bi	Banco Industrial
		bancorural	Bancorural

Completar transacción - Cuerpo (Solicitud de ejemplo)

End point: /api/payment/processor

{
    "hash": "U2FsdGVkX1%2FYy%2F0....",
    "paymentMethod" : "bi",
    "typePayment" : "bank",
    "typeTransaction":"bankout",
    "description" : "Orden de prueba",
    "customer": {
        "document": "123456789",
        "name": "pablo",
        "email": "email"
    },
    "additionalInformation": {
        "bankAccountNumber": "123456789101112",
        "bankAccountType": "Ahorros"
    }
}

Transacción Procesada - Respuesta (Respuesta de ejemplo)

202 Accepted

{
    "status": {
        "code": 202,
        "message": "success",
        "kind": "unknown"
    },
    "data": {
        "Reference": "xxxxxx",
        "status": "processing",
        "message": "La operación de retiro está siendo procesada",
        "beneficiary": {
            "document": "123456789",
            "name": "pablo",
            "email": "email"
        },
        "bankAccount": {
            "accountNumber": "123456789101112",
            "accountType": "Ahorros",
            "bank": "bi"
        },
        "transaction": {
            "amount": "1000",
            "isCheckout": true,
            "urlWebhook": "www.88pay.io"
        },
        "payment": {
            "id": 1121,
            "uuid": "e5b237b3-xxxx-xxxx-xxxx-69853f321eb7",
            "merchant": "test.88pay@gmail.com",
            "merchantUuid": "d6d29ad2-xxxx-xxxx-xxxx-55d518578434",
            "country": "GTM",
            "origin": "api",
            "status": "processing",
            "createdAt": "2025-06-27T20:56:13.000Z",
            "amount": 1000,
            "rate": null,
            "rateAmount": null,
            "total": null,
            "rejectionReason": null,
            "rateProviderAmount": null,
            "sandbox": 1,
            "currency": "",
            "paymentMethod": "bi",
            "typeMethod": "bank"
        }
    }
}

---

Wallet

Pay In

Tipo Transacción	Tipo Pago	Método de pago	Proveedores admitidos	Logotipos
walletin	wallet	Soyfri	SoyFri
walletin	wallet	zigi	Zigi

Pago con ZIGI

ZIGI es una billetera electrónica guatemalteca que permite a los usuarios realizar pagos de forma simple, rápida y segura mediante un link de pago.

Flujo de pago

• 🔗 Ingresá al link generado por la API.
• 🔐 Iniciá sesión en tu cuenta ZIGI.
• ✅ Confirmá el pago con un clic.

¡Listo! Así de fácil es pagar con ZIGI.

Completar transacción - Cuerpo (ZIGI Solicitud de ejemplo)

{
    "hash": "U2FsdGV...",
    "paymentMethod" : "zigi",
    "typePayment" : "wallet",
    "typeTransaction":"walletin",
    "description" : "Account deposit 564153131",
    "merchantId":"564153131",
    "urlWebhook": "https://your.url/notification"
}

Completar transacción - Cuerpo (SOYFRI Solicitud de ejemplo)

{
    "hash": "U2FsdGV...",
    "paymentMethod" : "Soyfri",
    "typePayment" : "wallet",
    "typeTransaction":"walletin",
    "description" : "Account deposit 564153131",
    "merchantId":"564153131",
    "urlWebhook": "https://your.url/notification"
}

Pay Out

Tipo Transacción	Tipo Pago	Método de pago	Proveedores admitidos	Logotipos
walletout	wallet	Soyfri	SoyFri

Completar transacción - Cuerpo (Solicitud de ejemplo)

{
    "hash": "U2FsdGV...",
    "paymentMethod" : "Soyfri",
    "typePayment" : "wallet",
    "typeTransaction":"walletout",
    "description" : "Account deposit 564153131",
    "customerName": "Jhon Doe",
    "merchantId":"564153131",
    "urlWebhook": "https://your.url/notification"
}

---

Limites

💡 Nota: Los valores expresados en esta sección de "Límites" están en USD.

Cash

Metodo de Pago	Minimo	Maximo	Min. Transacciones Diarias / Max. Transacciones Diarias
Cash	1 USD / 10 GTQ	300 USD / 2.250 GTQ	No hay límite, pero las transacciones superiores a 2.000 / mes requieren documentación. Más de 5.000 en bancos, s e necesita un descargo de responsabilidad sobre el origen de la divisa.

Wallet (Billeteras)

Metodo de Pago	Minimo	Maximo	Min. Transacciones Diarias / Max. Transacciones Diarias
Zigi / Soy Fri	1 USD / 10 GTQ	500 USD / 4.000 GTQ	Por determinar

---

💰 Tarifas y Tasas

Estas son las comisiones de procesamiento aplicables (antes del IVA) para transacciones en Guatemala, agrupadas por método de pago.

Método de Pago	Tipo	Proveedores	Comisión
💳 Tarjetas Crédito/Débito	Pay In		7.5% + 0.20 USD
🏦 Transferencia Bancaria	Pay In		4.3% + 0.10 USD
📲 Wallets (APMs)	Cash In		4%
💸 Cash In/Out	Cash In/Out		4.3% + 0.10 USD

💡 Nota: Todas las comisiones están expresadas en USD y no incluyen IVA.

📜 Términos y Condiciones

Artículo	Detalles
2D / 3DS 2.0	Disponible
Reserva de Alto Riesgo	5% – 180 días
Tipo de Cambio de Criptomonedas	2.0% FIAT y CRIPTO
Costo de Liquidación (Criptomonedas)	30 USD
Tiempo de Liquidación	Semanal

💡 Nota: Los tiempos y costos de liquidación están sujetos a las condiciones de la red y las regulaciones de procesamiento.