Гватемала

Гватемала выделяется как стратегический финтех-центр в Центральной Америке. Благодаря надежной банковской сети и растущей экосистеме цифровых финансовых услуг страна предлагает широкий спектр способов оплаты: от традиционных карт и местных банковских переводов до новых кошельков и вариантов на основе наличных.

Компании могут принимать платежи через прямые банковские переводы, популярные сети пополнения наличными и цифровые кошельки.

подсказка

Обратите внимание, что процесс всегда один и тот же: перед обработкой транзакции необходимо создать заказ, вот пример тела заказа для этой страны.

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

Принятые типы документов, удостоверяющих личность

• DPI: Документ, удостоверяющий личность

доход

Транзакция по карте

После успешного создания заказа вы можете перейти к обработке транзакции по карте. Это вернёт URL-адрес страницы оформления платежа (checkout), куда будет перенаправлен клиент для ввода своей контактной информации и данных карты. Эти данные необходимы для завершения транзакции.

подсказка

Все транзакции по картам поддерживают 3DS (3D Secure).
Любая карта, не зарегистрированная в 3DS, не будет обработана.

Тип транзакции	Тип оплаты	Метод оплаты	Поддерживаемые провайдеры	Логотипы
card+	credit	tc	Visa, Mastercard

Завершение транзакции – Тело запроса (Пример)

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

Тестовые карты

Используйте следующие номера тестовых карт для симуляции различных сценариев транзакций в тестовой среде (sandbox). Эти карты работают только в тестовом режиме и не выполняют реальные платежи.

Номер карты	CVV	Срок действия	Результат
4242424242424846	123	12/29	Successful transaction
4242424242424341	123	12/29	Declined transaction
4032037236725541	123	12/29	Card does not allow 3DS validation

Завершение транзакции – Пример ответа

{
    "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?..."
}

---

Банковский перевод

Тип транзакции	Тип оплаты	Способ оплаты	Поддерживаемые поставщики	Логотипы
bankin	bank	bi	Banco Industrial
		bam_transferencia	Bam trasnferencias
		bancorural	Bancorural

Полная транзакция – тело (образец запроса)

{
    "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"
    },
}

Завершение транзакции - тело (пример запроса с методом BI)

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

Обработанная транзакция - ответ (образец ответа с методом 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, которое будет URL-адресом, ведущим на страницу с инструкциями по оплате, где будет указано, как продолжить платеж.

Пользователь должен продолжить процесс в соответствии с указаниями, приведенными в инструкции.

---

Наличные

Тип транзакции	Тип оплаты	Способ оплаты	Поддерживаемые поставщики	Логотипы
cashin	cash	akisi	Akisi
		bam	Bam Efectivo

Полная транзакция – тело (образец запроса)

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

---

платить

Наши возможности по выплатам в Гватемале позволяют вам выплачивать средства через банковские счета, пункты выдачи наличных или переводы на кошельки. Это идеально подходит для денежных переводов, партнерских выплат и расчетов на рынке.

Наличные - вывод денег

Тип транзакции	Тип оплаты	Способ оплаты	Поддерживаемые поставщики	Логотипы
bankin	bank	banco-industrial	Banco Industrial
		super24	Super 24
cashin	cash	akisi	Akisi

Полная транзакция – тело (образец запроса)

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

Банк - выход из банка

Тип транзакции	Тип оплаты	Способ оплаты	Поддерживаемые поставщики	Логотипы
bankout	bank	bi	Banco Industrial
		bancorural	Bancorural

Полная транзакция - тело (Образец запроса)

Конечная точка: /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"
    }
}

Обработанная транзакция - ответ (образец ответа)

202 Принято

{
    "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"
        }
    }
}

---

Кошелек

доход

Тип транзакции	Тип оплаты	Способ оплаты	Поддерживаемые поставщики	Логотипы
walletin	wallet	Soyfri	SoyFri
walletin	wallet	zigi	Zigi

Оплата с помощью ZIGI

ZIGI — это гватемальский электронный кошелек, который позволяет пользователям совершать платежи просто, быстро и безопасно с помощью платежной ссылки.

Поток оплаты

• 🔗 Введите ссылку, сгенерированную API.
• 🔐 Войдите в свою учетную запись ZIGI.
• ✅ Подтвердите платеж одним щелчком мыши.

Готово! Платить с помощью ZIGI так просто.

Полная транзакция – тело (ZIGI образец запроса)

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

Полная транзакция – тело (SOYFRI образец запроса)

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

Выплата

Тип транзакции	Тип оплаты	Способ оплаты	Поддерживаемые поставщики	Логотипы
walletout	wallet	Soyfri	SoyFri

Полная транзакция – тело (образец запроса)

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

---

пределы

💡 Примечание: значения, указанные в разделе «Лимиты», указаны в USD.

Банковский перевод

Минимум	максимум	Мин. Ежедневные транзакции / Макс. Ежедневные транзакции
Без ограничений	Без ограничений	5 ожидающих транзакций на пользователя

Кредитные и дебетовые карты

Минимум	максимум	Мин. Ежедневные транзакции / Макс. Ежедневные транзакции
Неактивный	Неактивный	5 ожидающих транзакций на пользователя

---

💰 Тарифы и ставки

Это применимые сборы за обработку (до НДС) для транзакций в Гватемале, сгруппированные по способу оплаты.

Способ оплаты	Тип	Сбор
💳 Кредитные/дебетовые карты	Mastercard, Visa	7.5% + 0.20USD
🏦 Банковский перевод	BAM, Super24, Bi	4,3% + 0,10 USD
📲 Кошельки (APM)	Пт, Зиги	TBD
💸 Ввод/вывод наличных	Akisi	4,3% + 0,10 USD

💡 Примечание: Все сборы указаны в долларах США и не включают НДС.

📜 Условия и положения

Товар	Подробности
2D / 3DS 2.0	Доступно
Резерв высокого риска	5% – 180 дней
Курс обмена криптовалют	2,0% ФИАТ и КРИПТОВАЛЮТА
Стоимость расчетов (криптовалюта)	30 долларов США
Время расчетов	Еженедельно

💡 Примечание: Время и стоимость расчетов зависят от условий сети и правил обработки.