支持的国家和覆盖范围
我们的订阅服务覆盖拉丁美洲主要市场,支持通过信用卡和借记卡进行定期和按需循环付款。每个支持的国家/地区均提供详细文档,涵盖具体要求、处理时间和可用功能。用例
流媒体服务
管理数字内容平台的月度或年度循环订阅。
支持具有不同功能集的分层定价。
SaaS产品
处理具有多个套餐级别的软件订阅计费。
非常适合 B2B 和 B2C 软件平台。
会员计划
通过灵活的计费周期,
自动处理健身房会员、俱乐部会费和积分奖励计划的付款。
公用事业服务
为电信、互联网及其他
月度公用事业账单设置定期付款。
按需平台
支持网约车、配送和自由职业者市场等服务的
可变定期付款。
工作原理
Localpayment 使商家能够通过安全、简化的流程自动处理定期信用卡付款并管理订阅计费。订阅工作流程涉及您的客户、您的应用程序和 Localpayment 基础设施之间的协调操作。- 订阅选择:客户选择订阅计划并在结账时输入付款详情。
- 订阅请求:您的应用程序向 Localpayment API 发送包含支付数据的订阅创建请求。
- 卡片令牌化:Localpayment 安全地对卡片详细信息进行令牌化,并验证用于定期使用的支付方式。
- 订阅确认:Localpayment 会将订阅 ID 和确认信息返回到您的应用程序。
- 显示订阅确认:商家应用程序向客户显示包含订阅详情和下次账单日期的确认页面。
- 支付处理:Localpayment 会根据账单周期自动处理信用卡支付。
- 状态通知: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 支持两种主要的订阅模式,以满足不同的业务需求。请选择最符合您计费要求的方案。固定套餐订阅
非常适合具有标准化定期收费的企业。请先创建订阅计划,
然后将其与客户订阅关联。常见应用场景:
- 不同级别的健身房会员资格
- 流媒体服务计划
- 软件订阅级别
- 标准化会员费
自定义订阅
非常适合每次付款金额或时间可能不同的浮动计费场景。常见应用场景:
- 首月优惠,正常价格
- 基于使用量的计费模式
- 按需服务与长期合作关系
- 促销定价方案

