QR (Guatemala)

This payment solution is only available in Guatemala

What is Fri?

Fri (previously known as Soyfri) is a digital wallet and payment platform in Guatemala that facilitates quick and secure transactions, including payments via QR codes. It allows users to link their bank accounts or cooperatives to perform various financial operations directly from their mobile devices.

QR payments in Guatemala offer a fast, secure, and efficient way for customers using the Fri wallet to pay directly from their linked bank accounts. Merchants can generate dynamic QR codes via API and share them with customers, who scan the code using the Fri app to complete the transaction. Fri acts as a payment intermediary, enabling real-time processing of payments through the user's associated bank.

Note: A unique dynamic QR code is generated for each request. This means that every time you create a new payment request, a different QR code will be issued, ensuring secure and traceable transactions.

Who Can Pay

  • Wallets that support QR payment: Fri and Micoope

  • Eligible users:

    • Individuals (personas físicas)

    • Legal entities (personas jurídicas)

    • Foreign users and companies with a Guatemalan phone number

  • Banks supported via Fri:

    • GyT

    • Banrural

    • Promerica

    • Interbanco

    • Bibanco

    • Micoope (cooperativa local)

For more information on the complete list, please consult Fri's official website.

  • Institutions that cannot currently pay via QR:

    • Banco Industrial

    • BAC

QR Code Validity

Each QR code is valid for 24 hours from the time of creation.

Note: Once a payment is completed, the QR code does not expire immediately. This means multiple payments can be made using the same code until it expires after 24 hours. An update is currently in development to automatically expire the QR code after a successful payment.

Amount Limits

To ensure security and regulatory compliance, Fri imposes the following transaction limits:

  • Minimum Amount per Transaction: 1 GTQ

  • Maximum Daily Limit per User: 10,000 GTQ

⚠️ Please note: The maximum limit applies on a per-user basis and resets every 24 hours. If a user attempts to exceed this limit, the transaction will be declined.

These limits are enforced directly by Fri and cannot be overridden at the API level. Merchants should validate the payment amount before generating the QR to avoid user-facing errors.

Payment Notification

Once a payment is completed using the Fri QR, a real-time webhook is sent to the merchant's configured endpoint. This webhook serves as the primary method to confirm successful transactions and should be used to update your internal systems accordingly.

Key characteristics:

  • Instant delivery: Webhook is triggered immediately after the transaction is completed.

  • Includes full transaction data: Amount, status, payment method, timestamps, and other relevant metadata.

  • Secure and reliable: Use the webhook payload to verify the authenticity of the payment.

  • No sensitive payer info: For security reasons, only the payer's phone number is included. Name, ID, or account number are not shared.

Generate a QR

POST https://api.stage.localpayment.com/api/payin

Headers

Name
Type
Description

Authorization*

string

Mandatory. JWT token in format Bearer eyJ0... . For more information about authentication, please refer to Authentication

Request Body

Name
Type
Description

paymentMethod*

OBJECT

Mandatory. Payment method details

paymentMethod.type*

string

Mandatory.wallet

paymentMethod.code*

string

Mandatory. Select among the codes available in each country here NOTE: payment method code might affect the collection currency in bimonetary countries. For more info, see the side note on currency field.

paymentMethod.flow*

string

Mandatory. The payment Method data is collected through an additional form or plugin (REDIRECT). Currently, only REDIRECT flow is allowed.

externalId*

string

Mandatory. An ID that is meaningful to you and your system. It must be unique and alphanumeric, no characters allowed.

country*

string

Mandatory. "GTM" Guatemala in ISOCode3 format

amount*

number

Mandatory. Amount to charge to your end user. For GTQ, use 2 decimal places separated by a dot.

currency*

string

Mandatory. The currency in which the amount is expressed. It could be A) the local currency of the selected country or B) the account's currency. If A), the amount will be charged to the customer's cash payment method. If B) and it differs from the local currency, the amount specified will be credited to your account and Localpayment will perform a Foreign Exchange operation to collect the amount expressed in local currency. In bimonetary countries, paymentMethod.code resolves possible ambiguity: the payment will be executed in the currency of that specific payment method network. e.i.: SPID (USD); SPEI (MXN)

accountNumber*

string

Mandatory. Your Localpayment account number in which the amount will be credited.

conceptCode*

string

Mandatory. Choose the suitable concept code from our Concept Code List. Based on our experience, the most usual are 0039 (remittances) and 0040 (corporate payments).

comment

string

Optional. A comment related to the transaction. It should be something meaningful to your business.

merchant*

OBJECT

Mandatory. Party Object.

type*

string

Mandatory. Possible values: COMPANY

merchant.name*

string

merchant.name

payer*

OBJECT

Mandatory. Party Object. Information related to the payer.

type*

string

Mandatory. Possible values: COMPANY, INDIVIDUAL

name*

string

Mandatory. Individual first name / company name

lastName

string

Mandatory for individuals / Ignored for companies.

document*

OBJECT

Mandatory.Party Object. Valid identity document.

document.type*

string

Mandatory. Document types: CUI / NIT

document.id*

string

Mandatory. Identity document Id. Usually numbers or combination of numbers and letters.

userReference

string

Optional. Username or id in your platform.

email

string

Mandatory

phone

OBJECT

Optional. Party Object. Contact phone number

phone.countryCode

string

Optional. Possible values: gt

phone.areaCode

string

Optional. Country Area Code

phone.number

string

Optional. Phone number

birthdate

string

Optional. Individual birthdate / company incorporation date. ISO 8601 format (YYYY-MM-DD)

nationality

string

Optional

address

OBJECT

Optional. Party Object. Contact address

address.street

string

Optional

address.number

string

Optional

address.city

string

Optional

address.state

string

Optional

address.country

string

Optional

address.comment

string

Optional. Additional info, such as floor or apartment number.

intermediaries

array

Optional. Array of Party objects. It represents others parties in the payment chain because of the end user is not your direct customer. Take into account the array sequence: your client should be the first element, the client of your client should be the second and so on, until there are no more intermediaries.

commercialData

OBJECT

Mandatory. Party Object. Extra information related to the goods or services traded.

item.id

string

Mandatory. Item ID

items.quantity

number

Mandatory. Item quantity

items.description

string

Mandatory. Item description

item.title

string

Mandatory. Item title

item.unitPrice

number

Mandatory.Unit price

Request Example

{
      "externalId": "a0c13c63-0fc6-40bd-83ba-4ed3a1c57e8b",
      "paymentMethod": {
        "type": "BankTransfer",
        "code": "1870",
        "flow": "REDIRECT"
      },
      "country": "GTM",
      "currency": "GTQ",
      "amount": 1000,
      "accountNumber": "{{YourAccountNumber}}",
      "conceptCode": "0001",
      "comment": "Test QR",
      "merchant": {
        "type": "COMPANY",
        "name": "My company"
      },
      "payer": {
        "type": "INDIVIDUAL",
        "name": "John",
        "lastName": "Doe",
        "document": {
          "type": "CUI",
          "id": "01234567890000"
        },
        "email": "[email protected]",
        "phone": {
          "countryCode": "502",
          "areaCode": "5123",
          "number": "4567"
        },
        "address": {
          "street": "9A calle A",
          "city": "Guatemala",
          "state": "Guatemala",
          "country": "Guatemala",
          "comment": "Office"
        }
      },
      "intermediaries": [],
      "commercialData": {
        "items": [
          {
            "id": "1444",
            "title": "test",
            "description": "prueba",
            "quantity": "1",
            "unitPrice": 10
          }
        ]
      }
    }

Response Example

{
    "transactionType": "PayIn",
    "externalId": "a0c13c63-0fc6-40bd-83ba-4ed3a1c57e8b",
    "internalId": "1fbc6aa2-b489-25ea-9a0a-4c7b071feb24",
    "paymentMethod": {
        "type": "BankTransfer",
        "code": "1870",
        "flow": "REDIRECT"
    },
    "country": "GTM",
    "currency": "GTQ",
    "amount": 1000,
    "accountNumber": "{{YourAccountNumber}}",
    "confirmed": {
        "currency": "GTQ",
        "amount": 1000,
        "fxQuote": 1
    },
    "payment": {
        "currency": "GTQ",
        "fxQuote": 1,
        "financingFee": 0,
        "amount": 1000
    },
    "localTaxes": [],
    "withHoldings": [],
    "fees": {
        "description": "Fee",
        "currency": "GTQ",
        "fxSource": 7.67356901,
        "fxQuote": 1,
        "amount": 0,
        "account": "{{YourAccountNumber}}"
    },
    "status": {
        "code": "100",
        "description": "INPROGRESS",
        "detail": "The payin is pending the confirmation"
    },
    "qr": {
        "image": "data:image/png;base64,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",
        "expirationDate": "2025-07-23T18:57:47.9964412",
        "paymentInstructions": "<ul><li><b><i><u>From the Fri application, scan the QR code and complete the payment process.</u></i></b></li></ul>"
    },
    "merchant": {
        "type": "COMPANY",
        "name": "My company"
    },
    "payer": {
        "type": "INDIVIDUAL",
        "name": "John",
        "lastname": "Doe",
        "document": {
            "type": "CUI",
            "id": "01234567890000"
        },
        "email": "[email protected]",
        "phone": {
            "countryCode": "502",
            "areaCode": "5123",
            "number": "4567"
        },
        "address": {
            "street": "9A calle A",
            "city": "Guatemala",
            "state": "Guatemala",
            "country": "Guatemala",
            "comment": "Office"
        }
    },
    "intermediaries": [],
    "date": {
        "creationDate": "2025-07-22T18:57:46.512+00:00",
        "processedDate": "2025-07-22T18:57:48.0115221",
        "expirationDate": "2025-07-23T18:57:47.9964412"
    },
    "paymentInstructions": "<ul><li><b><i><u>From the Fri application, scan the QR code and complete the payment process.</u></i></b></li></ul>",
    "errors": []
}

To complete the payment you must scan the QR in the Fri application, where you are previously registered as a user.

QR image

When your system successfully requests a QR payment, Localpayment's API will return an object named "qr" within the response. This object contains all the necessary information for you to display the QR code to your customer and guide them through the payment process.

The "qr" object has the following key properties:

  • image: This property holds the QR code image data in Base64 encoded format. The value will typically start with data:image/png;base64, followed by a long string of characters. To display the QR code to your customer, your system will need to decode this Base64 string to render the actual image.

  • expirationDate: This indicates the exact date and time (in UTC) when the generated QR code will expire. As previously noted, QR codes for Fri payments are valid for 24 hours from their creation.

  • paymentInstructions: This property provides clear, user-friendly instructions on how the customer should complete the payment using the QR code. You should display these instructions prominently to guide your customers.

Example: QR response

Check the Payin Status Codes

Payin

Last updated

Was this helpful?