> 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. |