QR Fri (Guatemala)

Localpayment enables merchants to process instant payments through Guatemala's QR Fri payment system, the country's standardized interoperable QR payment platform regulated by the Bank of Guatemala. Fri (previously known as Soyfri) is a digital wallet and payment platform that facilitates quick and secure transactions, allowing users to link their bank accounts or cooperatives to perform financial operations directly from their mobile devices.

This guide outlines the process for initiating QR Fri payments through Localpayment's API, detailing required parameters, handling responses, and interpreting status codes for seamless integration with Guatemala's unified payment network. QR Fri enables merchants to generate dynamic QR codes via API that customers scan using the Fri app, facilitating real-time payments directly from their linked bank accounts through Fri's payment intermediary infrastructure.

QR Fri payments in Guatemala are available through Fri and Micoope wallets for individuals, legal entities, and foreign users with Guatemalan phone numbers. Supported banks include GyT, Banrural, Promerica, and cooperatives like Micoope, while Banco Industrial and BAC are currently excluded. Refer to Fri's official website for the complete list of supported institutions.

Before You Begin

Ensure you have:

Valid API credentials(access token).

Step 1. Create QR Payment

To generate a QR code for payment collection, send a POST request to the Create Payin endpoint with QR-specific parameters.

Key Request Parameters

The request requires several key objects specific to QR payments:

Object	Description	Required
`paymentMethod.type`	Must be `BankTransfer`.	✅
`paymentMethod.code`	Use `1870` for Guatemala QR.	✅
`sender`	Sender information for compliance.	✅
`merchant`	Merchant/business details.	✅
`paymentMethod`	Payment method configuration.	✅
`amount`	Transaction amount.	✅
`currency`	Transaction currency code.	✅
`country`	Must be `GTM`.	✅

See all available parameters in the request.

Example Request

Below is an example using curl:

curl --request POST \
     --url https://api.stage.localpayment.com/api/payin/ \
     --header 'accept: application/json' \
     --header 'Authorization: Bearer <your_access_token>' \
     --header 'content-type: application/json' \
     --data '
{
  "paymentMethod": {
    "type": "BankTransfer",
    "code": "1870",
    "flow": "REDIRECT"
  },
  "currency": "GTQ",
  "merchant": {
    "type": "COMPANY",
    "name": "Company"
  },
  "payer": {
    "type": "INDIVIDUAL",
    "document": {
      "type": "CUI",
      "id": "3463426000101"
    },
    "phone": {
      "countryCode": "",
      "areaCode": "",
      "number": ""
    },
    "address": {
      "street": "",
      "city": "",
      "state": "",
      "country": "",
      "comment": ""
    },
    "bank": {
      "account": {
        "type": "C"
      }
    },
    "name": "John",
    "lastName": "Doe",
    "email": "[email protected]"
  },
  "commercialData": {
    "items": [
      {
        "id": "1444",
        "title": "test",
        "description": "prueba",
        "quantity": "1",
        "unitPrice": 10
      }
    ]
  },
  "externalId": "a53c788a-c379-457d-9b5f-98ffc33feed0",
  "country": "GTM",
  "amount": 10,
  "accountNumber": "{{YourAccountNumber}}",
  "conceptCode": "0001",
  "comment": "Test"
}
'

Step 2. Handle the Response

Successful Response

A successful QR payment creation includes the QR code data and payment details:

{
  "transactionType": "PayIn",
  "externalId": "a53c788a-c379-457d-9b5f-98ffc33feed0",
  "internalId": "b2895d29-266d-4026-bb6d-8a9d4fcdfe86",
  "paymentMethod": {
    "type": "BankTransfer",
    "code": "1870",
    "flow": "REDIRECT"
  },
  "country": "GTM",
  "currency": "GTQ",
  "amount": 10,
  "accountNumber": "{{YourAccountNumber}}",
  "confirmed": {
    "currency": "GTQ",
    "amount": 10,
    "fxQuote": 1
  },
  "payment": {
    "currency": "GTQ",
    "fxQuote": 0,
    "financingFee": 0,
    "amount": 0
  },
  "localTaxes": [],
  "withHoldings": [],
  "fees": {
    "description": "Fee",
    "currency": "GTQ",
    "fxSource": 0,
    "fxQuote": 0,
    "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": "2024-05-24T21:15:19.7102946"
  },
  "merchant": {
    "type": "COMPANY",
    "name": "Company"
  },
  "payer": {
    "type": "INDIVIDUAL",
    "name": "John",
    "lastname": "Doe",
    "document": {
      "type": "CUI",
      "id": "3463426000101"
    },
    "email": "[email protected]",
    "phone": {
      "countryCode": "",
      "areaCode": "",
      "number": ""
    },
    "address": {
      "street": "",
      "city": "",
      "state": "",
      "country": "",
      "comment": ""
    }
  },
  "intermediaries": [],
  "date": {
    "creationDate": "2024-05-23T21:15:18.448+00:00",
    "processedDate": "2024-05-23T21:15:19.7258681",
    "expirationDate": "2024-05-24T21:15:19.7102946"
  },
  "errors": []
}

Key Response Fields

Parameter	Description	Use Case
`qr.image`	Raw QR code payload in standardized format.	Render scannable QR code using any QR generation library.
`qr.expirationDate`	ISO timestamp when QR becomes invalid.	Display countdown timer and handle expiration logic.
`externalId`	Your original reference number.	Internal reconciliation and order matching.
`status.code`	Current transaction state (`100` = `INPROGRESS`).	Determine next steps in payment flow.
`date.creationDate`	When transaction was created.	Analytics and performance tracking.

Error Response

When QR generation fails, you'll receive detailed error information:

{
  "externalId": "ce0aaa1a-4532-43b9-930a-26e780aba99b",
  "status": {
    "code": "812",
    "description": "REJECTED"
  },
  "errors": [
    {
      "code": "812",
      "detail": "External Id already used - duplication"
    }
  ]
}

Step 3. Display QR Code and Handle Payment

QR Display: Present QR code to customer through chosen channel.
Bank App Scan: Customer scans QR with their Argentine bank mobile app.
Payment Authorization: Customer confirms payment in their banking environment.
Real-time Confirmation: Localpayment receives instant payment notification.
Status Update: Your system receives webhook with payment confirmation.

Best Practices for QR Display

Minimum display size: 250x250 pixels for mobile scanning.
Maintain 1:1 aspect ratio without distortion.
Ensure high contrast (dark on light background).
Add quiet zone (white border) around QR code.
Include alt text (e.g. "QR Code Payment").
Show Clear Payment Instructions.
Handle Time-to-Live (TTL) and Expiration.

Step 4. Track Transaction Status

Monitor QR payment progress through these methods:

Webhooks (Recommended)

Receive real-time notifications when transaction status changes. Most efficient for production environments.

Status API Endpoint

Query transaction status programmatically. Useful for polling or recovering lost webhook notifications.

Dashboard View

Visual interface for monitoring transactions. Great for manual oversight and detailed transaction analysis.

Common Status Codes

The Localpayment API provides various status codes to indicate the progress and outcome of the payment in the response.

Code	Status	Description
`103`	`APPROVED`	The payin was confirmed but not credited yet.
`200`	Completed	The payin was completed.
`811`	Rejected	Requested amount is higher or lower than allowed max/min values.

📝
Note: For complete status code reference, see the Transaction Status Documentation.

Testing Your Integration

Sandbox Environment

Use the staging environment for testing:

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

Test QR Scenarios

Verify your integration handles these scenarios:

Successful Payment: Complete QR scan and payment flow.
QR Expiration: Handle expired QR codes gracefully.
Multiple Payment Attempts: Same QR scanned multiple times.
Status Updates: Webhook handling and status polling.

Next Steps

After implementing QR payments, consider these additional capabilities:

Refund the transaction

If necessary, you can refund the payment to the customer. Refer to the documentation for details.

Review transaction details

You can retrieve transaction information using the Localpayment API for detailed insights.