> ## Documentation Index
> Fetch the complete documentation index at: https://docs.localpayment.com/llms.txt
> Use this file to discover all available pages before exploring further.

# QR Fri (Guatemala)

Localpayment permite a los comerciantes procesar pagos instantáneos a través del sistema de pago QR Fri de Guatemala, la plataforma de pago QR interoperable y estandarizada del país, regulada por el Banco de Guatemala.

Fri (anteriormente conocida como Soyfri) es una billetera digital y plataforma de pagos que facilita transacciones rápidas y seguras, permitiendo a los usuarios vincular sus cuentas bancarias o cooperativas para realizar operaciones financieras directamente desde sus dispositivos móviles.

Esta guía describe el proceso para iniciar pagos con QR Fri a través de la API de Localpayment, detallando los parámetros necesarios, el manejo de las respuestas y la interpretación de los códigos de estado para una integración perfecta con la red de pagos unificada de Guatemala. QR Fri permite a los comercios generar códigos QR dinámicos mediante la API, que los clientes escanean con la aplicación Fri, facilitando pagos en tiempo real directamente desde sus cuentas bancarias vinculadas a través de la infraestructura de intermediación de pagos de Fri.

> [!NOTE]
>
> Los pagos con QR Fri en Guatemala están disponibles a través de las billeteras Fri y Micoope para personas físicas, jurídicas y usuarios extranjeros con números de teléfono guatemaltecos. Entre los bancos compatibles se incluyen GyT, Banrural, Promerica y cooperativas como Micoope, mientras que Banco Industrial y BAC están excluidos por el momento. Consulta el [sitio web oficial de Fri](https://soyfri.com/#bancos)  para obtener la lista completa de instituciones compatibles.

## Antes de comenzar

Asegúrate de tener:

* [Credenciales API](https://docs.localpayment.com/es/docs/api-keys-and-environments.md) válidas (token de acceso).

***

## Paso 1. Crear pago con código QR

Para generar un código QR para la recaudación de pagos, envía una solicitud `POST` al endpoint [Crear Payin](https://docs.localpayment.com/es/reference/payins.md) con parámetros específicos para códigos QR.

### Parámetros clave de la solicitud

La solicitud requiere varios objetos clave específicos para los pagos mediante código QR:

| Objeto | Descripción | Requerido |
| - | - | - |
| `paymentMethod.type` | Debe ser `BankTransfer`. | ✅ |
| `paymentMethod.code` | Usar `1870` para Guatemala QR. | ✅ |
| `sender` | Información del remitente para fines de cumplimiento. | ✅ |
| `merchant` | Datos del comerciante/negocio. | ✅ |
| `paymentMethod` | Configuración del método de pago. | ✅ |
| `amount` | Importe de la transacción. | ✅ |
| `currency` | Código de moneda de la transacción. | ✅ |
| `country` | Debe ser `GTM`. | ✅ |

Consulta todos los [parámetros disponibles](https://docs.localpayment.com/es/reference/payins.md) en la solicitud.

### Ejemplo de solicitud

A continuación se muestra un ejemplo que utiliza `curl`:

```bash curl theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
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": "john.doe@example.com"
  },
  "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"
}
'
```

***

## Paso 2. Gestionar la respuesta

### Respuesta exitosa

La creación exitosa de un pago mediante código QR incluye los datos del código QR y los detalles del pago:

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "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": "john.doe@example.com",
    "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": []
}
```

### Campos de respuesta clave

| Parámetro | Descripción | Caso de uso |
| - | - | - |
| `qr.image` | Código QR sin procesar en formato estandarizado. | Genera un código QR escaneable utilizando cualquier biblioteca de generación de códigos QR. |
| `qr.expirationDate` | Marca de tiempo ISO cuando el código QR deja de ser válido. Los códigos QR caducan **5 minutos** después de su generación. | Muestra un temporizador de cuenta regresiva e invita al cliente a solicitar un nuevo código QR si el actual caduca. |
| `externalId` | Tu número de referencia original. | Conciliación interna y cotejo de pedidos. |
| `status.code` | Estado actual de la transacción (`100` = `INPROGRESS`). | Determinar los siguientes pasos en el flujo de pagos. |
| `date.creationDate` | Cuando se creó la transacción. | Análisis y seguimiento del rendimiento. |

#### Respuesta de error

Si falla la generación del código QR, recibirás información detallada sobre el error:

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "externalId": "ce0aaa1a-4532-43b9-930a-26e780aba99b",
  "status": {
    "code": "812",
    "description": "REJECTED"
  },
  "errors": [
    {
      "code": "812",
      "detail": "External Id already used - duplication"
    }
  ]
}
```

***

## Paso 3. Mostrar el código QR y procesar el pago

1. **Visualización de código QR**: Presenta el código QR al cliente a través del canal elegido.
2. **Escaneo mediante la aplicación bancaria**: El cliente escanea el código QR con la aplicación móvil de su banco.
3. **Autorización de pago**: El cliente confirma el pago en su entorno bancario.
4. **Confirmación en tiempo real**: Localpayment recibe una notificación de pago instantánea.
5. **Actualización de estado**: Tu sistema recibe un webhook con la confirmación del pago.

![](https://mintcdn.com/localpayment-1fee3d41/oFZuSE0fcOk5ECyA/images/docs/f47eae28a9ebafd40af64e49974832a8b4e6e54832cbbd87cf4b9202a14e953d-qr-gtm.png?fit=max\&auto=format\&n=oFZuSE0fcOk5ECyA\&q=85\&s=0b7353f9ae21811b5c7a9127400b92bb)

### Mejores prácticas para la visualización de códigos QR

> [!WARNING]
>
> Los códigos QR Fri son válidos durante **5 minutos** a partir de su generación. Si el código QR caduca antes de que el cliente lo escanee, deberás crear una nueva solicitud de pago para generar un nuevo código.

* Tamaño mínimo de pantalla: 250x250 píxeles para escaneo móvil.
* Mantén una relación de aspecto de 1:1 sin distorsión.
* Asegúrate de que haya un alto contraste (fondo oscuro sobre fondo claro).
* Agrega una zona de silencio (borde blanco) alrededor del código QR.
* Incluye texto alternativo (por ejemplo, "Pago mediante código QR").
* Muestra instrucciones de pago claras.
* Mostrar un temporizador de cuenta regresiva basado en `qr.expirationDate` (ventana de 5 minutos) y notificar al cliente si el código QR caduca.

***

## Paso 4. Seguimiento del estado de la transacción

Supervisa el progreso del pago mediante código QR a través de estos métodos:

> [card] [Webhooks (recomendado)](https://docs.localpayment.com/es/docs/webhooks.md)
>
> Recibe notificaciones en tiempo real cuando cambie el estado de la transacción. Más eficiente para entornos de producción.

> [card] [Endpoint de la API de estado](https://docs.localpayment.com/es/reference/get-transaction-status.md)
>
> Consulta el estado de las transacciones mediante programación. Útil para sondear o recuperar notificaciones de webhook perdidas.

> [card] [Vista del Business Portal](https://docs.localpayment.com/es/docs/dashboard-overview.md)
>
> Interfaz visual para el seguimiento de transacciones. Ideal para la supervisión manual y el análisis detallado de las transacciones.

### Códigos de estado comunes

La API de Localpayment proporciona varios códigos de estado para indicar el progreso y el resultado del pago en la respuesta.

| Código | Estado | Descripción |
| :- | :- | :- |
| `103` | `APPROVED` | El payin se confirmó, pero aún no se ha abonado. |
| `200` | `Completed` | El payin se ha completado. |
| `811` | `Rejected` | La cantidad solicitada es mayor o menor que los valores máximos/mínimos permitidos. |

> [!NOTE]
>
> **Referencia completa**
>
> Consulta todos los códigos de estado en nuestra [documentación sobre el estado de las transacciones](https://docs.localpayment.com/es/reference/transaction-status-error-codes).

***

## Probando tu integración

### Entorno de pruebas

Utiliza el entorno de prueba para realizar las pruebas:

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

### Escenarios de prueba de QR

Verifica que tu integración gestione estos escenarios:

1. **Pago exitoso**: Completa el escaneo del código QR y el proceso de pago.
2. **Caducidad de los códigos QR**: Gestiona correctamente los códigos QR caducados.
3. **Múltiples intentos de pago**: Se escaneó el mismo código QR varias veces.
4. **Actualizaciones de estado**: Gestión de webhooks y sondeo de estado.

***

## Próximos pasos

Tras implementar los pagos mediante código QR, ten en cuenta estas funcionalidades adicionales:

> [card] [Reembolsar la transacción](https://docs.localpayment.com/es/docs/refund-apm-payment.md)
>
> Si es necesario, puedes reembolsar el pago al cliente. Consulta la documentación para obtener más detalles.

> [card] [Revisar los detalles de la transacción](https://docs.localpayment.com/es/reference/get-transaction-status.md)
>
> Puedes recuperar información sobre las transacciones utilizando la API de Localpayment para obtener información detallada.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.