跳转到主要内容
Localpayment 使商户能够通过 ETPAY 处理安全的银行转账付款。ETPAY 是智利领先的支付网关,支持与智利主要金融机构进行直接银行转账和身份验证。本指南概述了通过 Localpayment 的 API 发起基于 ETPAY 的付款的流程,详细说明了所需参数、响应处理和状态码解读,以便与智利的银行基础设施实现无缝集成。

开始之前

请确保您已备好:
仅支持个人(网上银行用户)付款。此支付方式仅接受来自个人银行账户的付款。如果 payer.type 以 COMPANY 发送,交易将被拒绝。

步骤 1:创建 ETPAY 付款

要在智利发起 ETPAY 付款,请向创建付款endpoint 发送带有 ETPAY 特定参数的 POST 请求。

关键请求参数

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

示例请求

以下是使用 curl 的示例:
curl

步骤 2:处理响应

成功响应

成功的 ETPAY 付款创建过程包括重定向 URL 和交易详情:

关键响应字段

错误响应

当 ETPAY 在智利的付款创建失败时,您将收到具体的错误信息:

步骤 3. 处理 ETPAY 支付流程

  1. 发起支付:将客户重定向到 ETPAY 支付网址。
  2. 银行选择:客户从支持的机构中选择其智利银行。
  3. 银行认证:客户登录其网上银行环境。
  4. 付款授权:客户在其银行界面确认付款。
  5. 实时确认:Localpayment收到付款通知。
  6. 状态更新:您的系统已收到包含付款确认信息的 webhook。

第四步:跟踪交易状态

您可以通过以下方式监控ETPAY付款进度:

Webhooks(推荐)

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

状态 API endpoint

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

Business Portal 视图

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

常用状态码

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

测试您的集成

沙盒环境

使用测试环境:

智利测试场景

请确认您的集成方案能够处理以下场景:
  1. 支付成功:完成 ETPAY 支付流程的银行模拟。
  2. 银行认证:测试不同的银行认证流程。
  3. 支付链接过期:妥善处理支付链接过期问题。
  4. 身份验证失败:测试银行登录失败场景。
  5. 银行拒付:模拟银行拒付。
  6. 状态更新:Webhook 处理和状态轮询。

后续步骤

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

退款

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

查看交易详情

您可以使用 Localpayment API 获取交易信息,以获得更详细的分析。

最后修改于 2026年11月10日