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

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

Request Example

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

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

13 digits for natural person, 10 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

Last updated