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

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.

Request Example

{
	"country": "GTM",
	"amount": 1000,
	"currency": "GTQ",
	"orderId": "R123456",
	"description": "FreeTextFreeTextFreeTextFreeText",
	"beneficiary": {
		"name": "Sergio",
		"lastName": "test",
		"email": "[email protected]",
		"document": {
			"type": 1,
			"number": "1234567891123"
		}
	},
	"destination": {
		"bankAccount": {
			"bankCode": "3901",
			"accountType": "1",
			"accountNumber": "12345678121"
		}
	}
}

Time Outs

In the case of receiving a Time Out as a response from this API we recommend resending the payout again after 30 seconds using the same orderId.

This way we will check if the payout was processed and avoid double payments.

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
3901	BANCO FICOHSA GT
0101	BANCO DE GUATEMALA
1501	BANCO INDUSTRIAL
4201	BANCO DE AMERICA CENTRAL S.A.
4401	BANCO AGROMERCANTIL S.A.
3001	CITIBANK N.A.
1901	BANCO INTERNACIONAL
1601	BANCO BANRURAL
1201	BANCO DE LOS TRABAJADORES
1301	BANCO INMOBILIARIO
4501	BANCO G&T CONTINENTAL
0401	CREDITO HIPOTECARIO NACIONAL
3601	BANCO VIVIBANCO
4801	BANCO INV S.A.
4901	CREDICORP S.A.
4101	BANCO DE ANTIGUA
4001	BANCO PROMERICA S.A.
4701	BANCO AZTECA