跳转到主要内容
让客户可以将购买金额拆分为按月付款,从而吸引更多客户。了解如何轻松实施和管理分期付款计划,以提高转化率和平均订单价值。 Localpayment 使商户能够提供分期付款计划,让客户将购买金额拆分为多笔按月付款。本指南概述了通过 Localpayment API 创建分期付款计划的流程,详细说明所需参数、响应处理以及完整分期付款生命周期的管理。

开始之前

请确保您已备好:

API凭证

用于身份验证的有效 API 凭据和访问令牌。

账户设置

为您的目标国家/地区正确设置账户并进行业务验证。

IP白名单

将服务器 IP 地址加入 API 访问白名单。

Webhook endpoint

设置 webhook URL 以接收付款通知。

步骤 1:创建分期付款计划报价

在处理分期付款之前,您需要生成分期付款计划报价,以便向客户展示付款选项。 要获取分期付款计划报价,您需要向生成分期付款计划报价endpoint 发送 POST 请求。

关键请求参数

分期付款仅适用于本地货币。在秘鲁,您可以对 PEN 付款提供分期付款,但不能对 USD 付款提供分期付款。

示例请求

以下是使用 curl 的示例:
curl
查看请求中所有可用的参数。

步骤 2:处理报价响应

成功响应

成功的分期付款报价包含详细的付款计划信息:

关键响应字段

错误响应

分期付款报价生成失败时:

分期付款展示最佳实践

  • 清晰显示所有费用(融资费用、总金额)
  • 突出显示每月付款金额
  • 包含不同分期付款选项之间的比较
  • 说明后续分期付款的自动付款流程
  • 提供客户支持信息
  • 妥善处理令牌过期(10 分钟有效期)

步骤 3:处理分期付款

客户选择分期付款计划后,使用分期付款令牌处理付款。

示例请求

curl

步骤 4:跟踪分期付款状态

您可以通过以下方式监控分期付款计划的进度:

Webhooks(推荐)

实时接收每笔分期付款及计划状态变更的通知。

状态 API endpoint

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

Business Portal 视图

用于监控分期付款计划和付款表现的可视化界面。

常用状态码

Localpayment API 为分期付款计划和付款提供多种状态码。
APPROVED 不是最终状态。 它表示银行卡付款已确认,但资金尚未计入您的余额。您可以看到该付款,但在状态变为 Completed 之前无法提取资金。这通常需要 1 到 2 天,具体取决于服务商。
完整参考请查看我们的交易状态文档,了解所有状态代码。

步骤 5:管理分期付款生命周期

分期付款流程


测试您的集成

测试场景

请确认您的集成方案能够处理以下场景:
  1. 分期付款成功:完成分期付款流程
  2. 多种计划选项:展示不同的分期期限(2、3、6 个月)
  3. 令牌过期:处理已过期的 installmentsToken(10 分钟有效期)
  4. 状态更新:Webhook 处理和状态轮询。

后续步骤

实施分期付款后,请考虑以下附加功能:

退款

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

查看交易详情

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

最后修改于 2026年11月20日