> For the complete documentation index, see [llms.txt](https://docs.monnet.io/OoF1XuWTEpPjI0i2ERRO/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.monnet.io/OoF1XuWTEpPjI0i2ERRO/country-requirements/guatemala.md).
# Guatemala
The necessary information for Guatemala is presented below in order to carry out a correct payout.
## Mandatory parameters
| Field | Description |
| ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| country | String (Required, length = 3)
ISO 3166-1-alpha-3. In the case of Guatemala: GTM
|
| amount | Integer (Required max-lenght = 10)
The amount of the transaction. The 2 last digits will be consider as decimal. Ex:
100000 equals "one thousand"
|
| currency | String (Required, length = 3)
The currency of the payroll. ISO-4217. In the case of Guatemala: GTQ
You can see the explication on /pages/goXlrdQZfDDMNgpat6RV
|
| oderId | String (Required max-lenght = 20 characters)
Merchant transaction code (Purchase Order)
|
| description | String (Optional max-lenght = 50 characters)
For customer use
|
| beneficiary.name | String (Required)
Name of the Beneficiary
|
| beneficiary.lastName | String (Required)
Last name of the Beneficiary
|
| beneficiary.email | String (Required: max-lenght = 50 characters)
Beneficiary's email
|
| beneficiary.document.type | Integer (Required)
Type of Account of the beneficiary to pay. You must enter the numeric code as indicated
|
| beneficiary.document.number | String (Required)
Contains the beneficiary's document number.
|
| destination.bankAccount.bankCode | String (Required)
Codee of the receiving bank or financial institution.
|
| destination.bankAccount.accountType | Integer (Required)
Type of Account of the beneficiary to pay. You must enter the numeric code.
|
| destination.bankAccount.accountNumber | Integer (Required)
Beneficiary's account number.
|
| subMerchantInfo.code | String (Required only for PSP)
Submerchant Identifier
|
| subMerchantInfo.name | String (Required only for PSP)
Submerchant Name
|
| subMerchantInfo.url | String (Required only for PSP)
Submerchant URL
|
{% hint style="success" %}
New Feature
**Email Notification to the Beneficiary**
It is now possible to automatically send emails to the beneficiary with the outcome of the Payout (success or rejected).
**Requirements:**
* Request the activation of **"Email notifications to the user"** through your account manager.
* Include the `beneficiary.email` parameter in each transaction. If this field is missing, the email will not be sent.
{% endhint %}
## Request Example
```json
{
"country": "GTM",
"amount": 1000,
"currency": "GTQ",
"orderId": "R123456",
"description": "FreeTextFreeTextFreeTextFreeText",
"beneficiary": {
"name": "Sergio",
"lastName": "test",
"email": "test@test.com",
"document": {
"type": 1,
"number": "1234567891123"
}
},
"destination": {
"bankAccount": {
"bankCode": "3901",
"accountType": "1",
"accountNumber": "12345678121"
}
}
}
```
{% hint style="danger" %} **Time Outs**
In the case of receiving a **Time Out** as a response from this API we recommend resending the payout again after 60 seconds using the same **orderId**.
This way we will check if the payout was processed and avoid double payments.
{% endhint %}
## Document Validations
| Parameter | ID Type | Length |
|---|
| 1 | DPI | 13 digits |
| 2 | NIT | 9 digits for natural person, 8 or 9 digits for legal person |
## Account Type
| Parameter | Type |
| --------- | ----------------- |
| 1 | Monetaria account |
| 2 | Savings account |
## Bank List
| ID | Bank Name |
| -------- | -------------------------------------- |
| ~~0101~~ | ~~BANCO DE GUATEMALA (Banco Central)~~ |
| 0401 | CREDITO HIPOTECARIO NACIONAL |
| 1201 | BANCO DE LOS TRABAJADORES |
| 1301 | BANCO INMOBILIARIO |
| 1501 | BANCO INDUSTRIAL |
| 1601 | BANCO BANRURAL |
| 1901 | BANCO INTERNACIONAL |
| 3001 | CITIBANK N.A. |
| 3601 | BANCO VIVIBANCO |
| 3901 | BANCO FICOHSA GT |
| 4001 | BANCO PROMERICA S.A. |
| 4101 | BANCO DE ANTIGUA |
| 4201 | BANCO DE AMERICA CENTRAL S.A. |
| 4401 | BANCO AGROMERCANTIL S.A. |
| 4501 | BANCO G\&T CONTINENTAL |
| 4701 | BANCO AZTECA |
| 4801 | BANCO INV S.A. |
| 4901 | CREDICORP S.A. |
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.monnet.io/OoF1XuWTEpPjI0i2ERRO/country-requirements/guatemala.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.