> ## 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（危地马拉）

Localpayment 使商家能够通过危地马拉的 QR Fri 支付系统处理即时付款，该系统是危地马拉银行监管的该国标准化的可互操作二维码支付平台。

Fri（以前称为 Soyfri）是一个数字钱包和支付平台，可促进快速安全的交易，允许用户将他们的银行账户或合作社账户关联起来，直接通过移动设备进行金融操作。

本指南概述了通过 Localpayment 的 API 发起 QR Fri 支付的流程，详细说明了所需的参数、响应处理以及状态码解读，以实现与危地马拉统一支付网络的无缝集成。QR Fri 使商家能够通过 API 生成动态二维码，客户可以使用 Fri 应用扫描该二维码，从而通过 Fri 的支付中介基础设施，直接从其关联的银行账户进行实时支付。

> [!NOTE]
>
> 在危地马拉，个人、法人实体以及拥有危地马拉手机号码的外国用户均可通过 Fri 和 Micoope 钱包使用二维码支付。支持的银行包括 GyT、Banrural、Promerica 以及 Micoope 等合作社，而 Banco Industrial 和 BAC 目前暂不支持。请访问 [Fri 官方网站](https://soyfri.com/#bancos) 查看完整的支持机构列表。

## 开始之前

请确保您已备好：

* 有效的 [API 凭证](https://docs.localpayment.com/zh/docs/api-keys-and-environments.md)（访问令牌）。

***

## 第一步：创建二维码支付

要生成用于收款的二维码，请向 [创建付款](https://docs.localpayment.com/zh/reference/payins.md) endpoint 发送 `POST` 请求，并附带特定二维码参数。

### 关键请求参数

该请求需要几个与二维码支付相关的关键对象：

| 对象 | 描述 | 必需的 |
| - | - | - |
| `paymentMethod.type` | 必须是 `BankTransfer`。 | ✅ |
| `paymentMethod.code` | 使用 `1870` 危地马拉二维码。 | ✅ |
| `sender` | 发件人信息，用于合规性审查。 | ✅ |
| `merchant` | 商家/企业详情。 | ✅ |
| `paymentMethod` | 支付方式配置。 | ✅ |
| `amount` | 交易金额。 | ✅ |
| `currency` | 交易货币代码。 | ✅ |
| `country` | 必须是 `GTM`。 | ✅ |

查看请求中所有[可用的参数](https://docs.localpayment.com/zh/reference/payins.md)。

### 示例请求

以下是使用 `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"
}
'
```

***

## 步骤 2：处理响应

### 成功响应

成功的二维码支付创建包括二维码数据和支付详情：

```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": []
}
```

### 关键响应字段

| 参数 | 描述 | 用例 |
| - | - | - |
| `qr.image` | 标准化格式的原始二维码有效载荷。 | 使用任何二维码生成库生成可扫描的二维码。 |
| `qr.expirationDate` | ISO 时间戳显示二维码失效时间。二维码生成后 **5 分钟** 失效。 | 显示倒计时计时器，并在二维码过期时提示顾客索取新的二维码。 |
| `externalId` | 您的原始参考编号。 | 内部核对和订单匹配。 |
| `status.code` | 当前交易状态（`100` = `INPROGRESS`）。 | 确定付款流程的后续步骤。 |
| `date.creationDate` | 交易创建时。 | 分析和绩效跟踪。 |

#### 错误响应

二维码生成失败时，您将收到详细的错误信息：

```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"
    }
  ]
}
```

***

## 步骤三：显示二维码并处理付款

1. **二维码展示**：通过选定的渠道向客户展示二维码。
2. **银行App扫描**：客户使用银行手机App扫描二维码。
3. **付款授权**：客户在其银行系统中确认付款。
4. **实时确认**：Localpayment 可立即收到付款通知。
5. **状态更新**：您的系统已收到包含付款确认信息的 webhook。

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

### 二维码展示的最佳实践

> [!WARNING]
>
> QR Fri 二维码自生成之日起 **5 分钟** 内有效。如果二维码在客户扫描前过期，您必须创建新的付款请求以生成新的二维码。

* 移动扫描的最小显示尺寸：250x250像素。
* 保持 1:1 宽高比，不失真。
* 确保高对比度（浅色背景上使用深色）。
* 在二维码周围添加静默区（白色边框）。
* 添加替代文字（例如“二维码支付”）。
* 请提供清晰的付款说明。
* 根据 `qr.expirationDate`（5 分钟窗口期）显示倒计时器，并在二维码过期时通知客户。

***

## 第四步：跟踪交易状态

您可以通过以下方式监控二维码支付进度：

> [card] [Webhooks（推荐）](https://docs.localpayment.com/zh/docs/webhooks.md)
>
> 交易状态变更时接收实时通知。最适用于生产环境。

> [card] [状态 API endpoint](https://docs.localpayment.com/zh/reference/get-transaction-status.md)
>
> 以编程方式查询交易状态。可用于轮询或恢复丢失的 webhook 通知。

> [card] [Business Portal 视图](https://docs.localpayment.com/zh/docs/dashboard-overview.md)
>
> 用于监控交易的可视化界面。非常适合人工监督和详细的交易分析。

### 常用状态码

Localpayment API 提供各种状态代码，以在响应中指示付款的进度和结果。

| 代码 | 状态 | 描述 |
| :- | :- | :- |
| `103` | `APPROVED` | 付款已确认，但尚未到账。 |
| `200` | `Completed` | 付款已完成。 |
| `811` | `Rejected` | 请求金额高于或低于允许的最大/最小值。 |

> [!NOTE]
>
> **完整参考**
>
> 请查看我们的[交易状态文档](https://docs.localpayment.com/zh/reference/transaction-status-error-codes)，了解所有状态代码。

***

## 测试您的集成

### 沙盒环境

使用测试环境：

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

### 测试二维码场景

请确认您的集成方案能够处理以下场景：

1. **支付成功**：完成二维码扫描和支付流程。
2. **二维码过期**：妥善处理过期二维码。
3. **多次支付尝试**：同一个二维码被多次扫描。
4. **状态更新**：Webhook 处理和状态轮询。

***

## 后续步骤

在实施二维码支付之后，请考虑以下附加功能：

> [card] [退款](https://docs.localpayment.com/zh/docs/refund-apm-payment.md)
>
> 如有必要，您可以将款项退还给客户。详情请参阅相关文档。

> [card] [查看交易详情](https://docs.localpayment.com/zh/reference/get-transaction-status.md)
>
> 您可以使用 Localpayment API 获取交易信息，以获得更详细的分析。


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