Market specifications

Do you want to know more information about Guatemala's market? Go to the Tap Into Latin America’s High-Growth Potential article.

Country reference

try` code	`currency` code	`amount` decimals	`beneficiary.document.type` name	`beneficiary.document.id` format
`GT`	`GTQ`	2	CUI	13 digits

Mandatory parameters

Bank transfers

Bank transfer parameters	B2C	B2B	USD accounts	P2P
`external_id`	Yes	Yes	Yes	Yes
`payment_method_id`	Yes	Yes	Yes	Yes
`flow_type`	Yes	Yes	Yes	Yes
`purpose`	Yes	Yes	Yes	Yes
`country`	Yes	Yes	Yes	Yes
`amount`	Yes	Yes	Yes	Yes
`currency`	Yes	Yes	Yes	Yes
`currency_to_pay`	-	-	Yes	-
`beneficiary.first_name`	Yes	-	Yes*	Yes
`beneficiary.last_name`	Yes	-	Yes*	Yes
`beneficiary.business_name`	-	Yes	Yes*	-
`beneficiary.document.type`	Yes	Yes	Yes	Yes
`beneficiary.document.id`	Yes	Yes	Yes	Yes
`beneficiary.bank_account.code`	Yes	Yes	Yes	Yes
`beneficiary.bank_account.account`	Yes	Yes	Yes	Yes
`beneficiary.bank_account.type`	Yes	Yes	Yes	Yes
`remitter.first_name`	-	-	-	Yes
`remitter.last_name`	-	-	-	Yes
`remitter.document.type`	-	-	-	Yes
`remitter.document.id`	-	-	-	Yes
`remitter.address.country`	-	-	-	Yes

* For USD accounts, use beneficiary.first_name/beneficiary.last_name for B2C and beneficiary.business_name for B2B.

Payment methods

Guatemala supports payouts via Bank transfers. This method requires specific parameters and follows validation rules aligned with local compliance and banking standards.

Bank transfers

Bank transfers in Guatemala require detailed account information, including document ID, bank account, account type, bank code, and currency. The format of these fields depends on the receiving bank, and strict validation rules apply.

Refer to the bank codes section for format specifications.

Mandatory parameters

All fields listed below are required for bank transfer payouts. For successful processing, ensure correct formatting and value types.

Mandatory parameter	Description
`external_id`	Unique payout identification at the merchant's end. Maximum 100 characters.
`payment_method_id`	Payment method identifier. For bank transfers, use `BANK_TRANSFER`.
`flow_type`	Payout flow type. Valid values: `B2C` (Business to Consumer), `B2B` (Business to Business), or `P2P` (Person to Person).
`purpose`	Payout purpose code. See purpose codes reference.
`country`	Country code. For Guatemala, use `GT`.
`amount`	Payout amount. Use up to 2 decimal places.
`currency`	Source currency of the FX operation. For Guatemala, use `GTQ` or `USD`.
`currency_to_pay`	Currency to be paid out:`USD`. Mandatory only if the payout needs to be paid in USD. In case this parameter is missing, the payout will be paid in local currency.
`beneficiary.first_name`	Beneficiary's first name. Maximum 50 characters. Required for B2C and P2P.
`beneficiary.last_name`	Beneficiary's last name. Maximum 50 characters. Required for B2C and P2P.
`beneficiary.business_name`	Beneficiary's business name. Maximum 100 characters. Required for B2B.
`beneficiary.document.type`	Beneficiary's document type. Use `CUI` for Código Único de Identificación.
`beneficiary.document.id`	Beneficiary's document number. 13 numeric digits.
`beneficiary.bank_account.code`	Bank code. See bank codes below.
`beneficiary.bank_account.account`	Bank account number. Maximum 20 numeric digits.
`beneficiary.bank_account.type`	Beneficiary's bank account type. Account type: `CHECKING`: Checking accounts `SAVINGS`: Savings accounts
`remitter.first_name`	Remitter's first name. Maximum 50 characters. Mandatory only for remittance (P2P).
`remitter.last_name`	Remitter's last name. Maximum 50 characters. Mandatory only for remittance (P2P).
`remitter.document.type`	Remitter's document type. Use `ID` for national identification number, `PASS` for passport. Mandatory only for remittance (P2P).
`remitter.document.id`	Remitter's document number. Maximum 45 characters. Mandatory only for remittance (P2P).
`remitter.address.country`	Remitter's country code in ISO 3166-1 alpha-2 format. Mandatory only for remittance (P2P).

Example request

{
  "external_id": "abc1234567812345678",
  "payment_method_id": "BANK_TRANSFER",
  "flow_type": "B2C",
  "purpose": "OTHER_SERVICES",
  "country": "GT",
  "amount": 2000.00,
  "currency": "GTQ",
  "beneficiary": {
    "first_name": "JUAN",
    "last_name": "RUIZ",
    "document": {
      "type": "CUI",
      "id": "1234567891234"
    },
    "bank_account": {
      "code": "101",
      "account": "10200009123123450",
      "type": "CHECKING"
    }
  }
}

{
  "external_id": "abc1234567812345679",
  "payment_method_id": "BANK_TRANSFER",
  "flow_type": "B2B",
  "purpose": "OTHER_SERVICES",
  "country": "GT",
  "amount": 5000.00,
  "currency": "GTQ",
  "beneficiary": {
    "business_name": "Comercial Guatemala SA",
    "document": {
      "type": "CUI",
      "id": "9876543210123"
    },
    "bank_account": {
      "code": "42",
      "account": "987654321012",
      "type": "CHECKING"
    }
  }
}

{
  "external_id": "abc1234567812345680",
  "payment_method_id": "BANK_TRANSFER",
  "flow_type": "P2P",
  "purpose": "REMITTANCES",
  "country": "GT",
  "amount": 1500.00,
  "currency": "GTQ",
  "beneficiary": {
    "first_name": "MARIA",
    "last_name": "GARCIA",
    "document": {
      "type": "CUI",
      "id": "4567891230123"
    },
    "bank_account": {
      "code": "115",
      "account": "456789123456",
      "type": "SAVINGS"
    }
  },
  "remitter": {
    "first_name": "John",
    "last_name": "Smith",
    "document": {
      "type": "PASS",
      "id": "AB123456"
    },
    "address": {
      "country": "US"
    }
  }
}

Bank information

Access the reference formats and accepted values required for processing bank payouts in Guatemala.

Bank codes

These are the values the beneficiary.bank_account.code parameter can take in Guatemala.

Bank Name	Bank Code
BAC Guatemala	42
Banco Agromercantil	144
Banco Azteca	147
Banco de Antigua, S.A.	141
Banco de Desarrollo Rural, S.A.	116
Banco de Guatemala	101
Banco de Los Trabajadores	112
Banco Ficohsa Guatemala, S.A.	139
Banco G & T Continental	145
Banco Industrial, S.A.	115
Banco Inmobiliario, S.A.	113
Banco Internacional, S.A.	119
Banco Inv	148
Citibank NA	130
Credicorp	149
Crédito Hipotecario Nacional	104
Nexa	150
Promerica, S.A.	140
Vivibanco, S.A.	136