跳转到主要内容
Localpayment 使商家能够通过危地马拉的 Wallet Fri 系统处理即时数字钱包支付。本指南概述了通过 Localpayment 的 API 发起 Wallet Fri 支付的流程,详细说明了所需的参数、响应处理以及状态代码解读,从而实现与危地马拉流行的数字钱包平台的无缝集成。

开始之前

请确保您已备好:

步骤 1. 创建 Wallet Fri 付款

要生成 Wallet Fri 付款请求,请向 Create Payin endpoint 发送带有 Wallet Fri 特定参数的 POST 请求。

关键请求参数

该请求需要几个 Wallet Fri 支付特有的关键对象: 查看请求中所有可用的参数。

示例请求

以下是一个使用 curl 的示例:
curl

步骤 2:处理响应

成功响应

当您创建 Wallet Fri 付款时,系统会自动向客户的 Wallet Fri 应用发送推送通知。API 响应确认付款请求已成功创建,并正在等待客户授权。

关键响应字段

错误响应

当 Wallet Fri 创建请求失败时,您将收到详细的错误信息:

步骤 3. 客户授权流程

  1. 推送通知:客户直接在 Wallet Fri 应用中收到付款请求。
  2. 应用通知:支付请求会在移动设备上显示为推送通知。
  3. 应用内授权:客户打开 Wallet Fri 应用查看并授权付款。
  4. 安全验证:客户完成PIN码或生物识别认证。
  5. 付款确认:交易将在获得授权后立即处理。
  6. 状态更新:您的系统已收到包含最终付款状态的 webhook。

第四步:跟踪交易状态

您可以通过以下方式监控 Wallet Fri 的付款进度:

Webhooks(推荐)

交易状态变更时接收实时通知。最适用于生产环境。

状态 API endpoint

以编程方式查询事务状态。可用于轮询或恢复丢失的 webhook 通知。

Business Portal 视图

用于监控交易的可视化界面。非常适合人工监督和详细的交易分析。

常用状态码

Localpayment API 提供各种状态代码来指示 Wallet Fri 付款的进度和结果。
完整参考请查看我们的交易状态文档,了解所有状态代码。

测试您的集成

沙盒环境

使用测试环境:

测试 Wallet Fri 场景

请确认您的集成方案能够处理以下场景:
  1. 付款成功:客户收到通知并授权付款。
  2. 授权已过期:客户未在规定时间内做出响应。
  3. 状态更新:Webhook 处理和状态轮询。

演示

以下演示展示了客户如何在应用程序中支付 Wallet Fri 付款请求,从待处理的请求到付款收据。
动画演示客户在 Wallet Fri 应用中支付 Localpayment 请求的过程,从请求待处理到最终收到付款收据

后续步骤

在实施 Wallet Fri 支付功能后,请考虑以下附加功能:

退款

如有必要,您可以将款项退还给客户。详情请参阅相关文档。

查看交易详情

您可以使用 Localpayment API 获取交易信息,以获得更详细的分析。
最后修改于 2026年11月10日