跳转到主要内容
Localpayment 提供强大的订阅计费功能,支持为固定套餐和自定义计费方案设置定期付款。本节全面概述了订阅功能、工作流程以及将定期付款集成到 Localpayment 设置中的关键注意事项。

支持的国家和覆盖范围

我们的订阅服务覆盖拉丁美洲主要市场,支持通过信用卡和借记卡进行定期和按需循环付款。每个支持的国家/地区均提供详细文档,涵盖具体要求、处理时间和可用功能。

用例

流媒体服务

管理数字内容平台的月度或年度循环订阅。 支持具有不同功能集的分层定价。

SaaS产品

处理具有多个套餐级别的软件订阅计费。 非常适合 B2B 和 B2C 软件平台。

会员计划

通过灵活的计费周期, 自动处理健身房会员、俱乐部会费和积分奖励计划的付款。

公用事业服务

为电信、互联网及其他 月度公用事业账单设置定期付款。

按需平台

支持网约车、配送和自由职业者市场等服务的 可变定期付款。

工作原理

Localpayment 使商家能够通过安全、简化的流程自动处理定期信用卡付款并管理订阅计费。订阅工作流程涉及您的客户、您的应用程序和 Localpayment 基础设施之间的协调操作。
  1. 订阅选择:客户选择订阅计划并在结账时输入付款详情。
  2. 订阅请求:您的应用程序向 Localpayment API 发送包含支付数据的订阅创建请求。
  3. 卡片令牌化:Localpayment 安全地对卡片详细信息进行令牌化,并验证用于定期使用的支付方式。
  4. 订阅确认:Localpayment 会将订阅 ID 和确认信息返回到您的应用程序。
  5. 显示订阅确认:商家应用程序向客户显示包含订阅详情和下次账单日期的确认页面。
  6. 支付处理:Localpayment 会根据账单周期自动处理信用卡支付。
  7. 状态通知:Localpayment 会向商家发送 webhook 通知,告知付款成功、失败和订阅变更情况。
卡片 - 工作原理

先决条件

在设置您的第一个订阅之前,请确保您已完成以下基本要求:

账户配置与验证

完成账户设置并验证所有必需的业务和财务信息。我们的《首次测试付款指南》将引导您完成整个流程。

实施指南

Localpayment 通过全面的 API 接口,帮助您管理定期付款,涵盖完整的订阅生命周期。以下是管理订阅和套餐的关键操作。

创建订阅

您可以根据预设方案或自定义参数创建新的订阅。支持定期计费和按需计费两种模式。

更新订阅

修改现有订阅详情,包括账单金额、频率或客户信息。无缝处理升级和降级。

取消订阅

终止有效订阅,同时保留交易记录。支持立即取消或在账单周期结束时取消。

创建订阅计划

设定固定的计费方案,包含预设金额和周期。非常适合标准化的价格层级和会员级别。

更新订阅计划

在保持与有效订阅关联的前提下,修改现有计划详情。更新所有客户的价格或功能。

获取订阅计划

获取有关特定订阅计划的详细信息,包括定价、计费周期和相关订阅。

失败的收费和重试逻辑

当订阅费用支付失败时,Localpayment 提供自动恢复机制和实时监控,以确保您的业务和客户的业务连续性。

单笔扣款监控

订阅中的每一次单独支付尝试都被视为标准的 Payin 交易。如果扣款失败(由于资金不足、卡片过期或其他原因),Localpayment 会发出带有具体错误代码(例如 300 - Rejected)的 PayIn Webhook 通知。监控这些 Webhook 是跟踪实时支付健康状况的主要方式。

自动重试机制(Dunning 催款)

为了追回失败的扣款,您可以在创建订阅或计划时配置 retry 对象。这一自动催款流程有助于在无需人工干预的情况下挽回收入:
  • retry.repetitions:系统尝试重新处理失败扣款的次数。
  • retry.intervalValue 和 retry.intervalUnit:定义每次重试尝试之间的延迟(例如,每 1 天或每 12 小时)。

因故障取消订阅

如果所有已配置的重试次数均已用尽,但付款仍然失败,则订阅的生命周期状态将自动更改为:
  • 904 - Cancelled - too many failed attempts:这表示该订阅已达到重试次数上限,现已永久失效。我们将不再尝试为此订阅进行自动扣款。

订阅类型

Localpayment 支持两种主要的订阅模式,以满足不同的业务需求。请选择最符合您计费要求的方案。

固定套餐订阅

非常适合具有标准化定期收费的企业。请先创建订阅计划, 然后将其与客户订阅关联。常见应用场景:
  • 不同级别的健身房会员资格
  • 流媒体服务计划
  • 软件订阅级别
  • 标准化会员费

自定义订阅

非常适合每次付款金额或时间可能不同的浮动计费场景。常见应用场景:
  • 首月优惠,正常价格
  • 基于使用量的计费模式
  • 按需服务与长期合作关系
  • 促销定价方案

订阅运营

订阅创建完成后,即可执行各种操作来管理订阅生命周期。以下概述了在受支持国家/地区可用的操作:
最后修改于 2026年11月10日