> ## Documentation Index
> Fetch the complete documentation index at: https://docs.localpayment.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 订阅概览

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

## 支持的国家和覆盖范围

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

| 国家 | 订阅类型 |
| - | :-: |
| **[哥伦比亚](https://docs.localpayment.com/zh/docs/colombia.md)** | 定时和按需 |
| **[墨西哥](https://docs.localpayment.com/zh/docs/mexico.md)** | 定时和按需 |
| **[秘鲁](https://docs.localpayment.com/zh/docs/peru.md)** | 定时和按需 |

***

## 用例

> [card] 流媒体服务
>
> 管理数字内容平台的月度或年度循环订阅。
> 支持具有不同功能集的分层定价。

> [card] SaaS产品
>
> 处理具有多个套餐级别的软件订阅计费。
> 非常适合 B2B 和 B2C 软件平台。

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

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

> [card] 按需平台
>
> 支持网约车、配送和自由职业者市场等服务的
> 可变定期付款。

***

## 工作原理

Localpayment 使商家能够通过安全、简化的流程自动处理定期信用卡付款并管理订阅计费。订阅工作流程涉及您的客户、您的应用程序和 Localpayment 基础设施之间的协调操作。

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

![卡片 - 工作原理](https://mintcdn.com/localpayment-1fee3d41/oFZuSE0fcOk5ECyA/images/docs/ccceeef991d549f99b2b2ab4c5f7755248b22f9597af8c1ff7510c37f596fd89-Subscriptions-overview.png?fit=max\&auto=format\&n=oFZuSE0fcOk5ECyA\&q=85\&s=487947a140015f03a722378779a6f068)

***

## 先决条件

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

> [card] [账户配置与验证](https://docs.localpayment.com/docs/make-your-first-test-payment.md)
>
> 完成账户设置并验证所有必需的业务和财务信息。我们的\*\*《首次测试付款指南》\*\*将引导您完成整个流程。

***

## 实施指南

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

> [card] [创建订阅](https://docs.localpayment.com/zh/docs/create-a-subscription.md)
>
> 您可以根据预设方案或自定义参数创建新的订阅。支持定期计费和按需计费两种模式。

> [card] [更新订阅](https://docs.localpayment.com/zh/docs/update-a-subscription.md)
>
> 修改现有订阅详情，包括账单金额、频率或客户信息。无缝处理升级和降级。

> [card] [取消订阅](https://docs.localpayment.com/zh/docs/cancel-a-subscription.md)
>
> 终止有效订阅，同时保留交易记录。支持立即取消或在账单周期结束时取消。

> [card] [创建订阅计划](https://docs.localpayment.com/zh/docs/create-a-subscription-plan.md)
>
> 设定固定的计费方案，包含预设金额和周期。非常适合标准化的价格层级和会员级别。

> [card] [更新订阅计划](https://docs.localpayment.com/zh/docs/update-a-subscription-plan.md)
>
> 在保持与有效订阅关联的前提下，修改现有计划详情。更新所有客户的价格或功能。

> [card] [获取订阅计划](https://docs.localpayment.com/zh/docs/get-subscription-plan.md)
>
> 获取有关特定订阅计划的详细信息，包括定价、计费周期和相关订阅。

***

## 失败的收费和重试逻辑

当订阅费用支付失败时，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 支持两种主要的订阅模式，以满足不同的业务需求。请选择最符合您计费要求的方案。

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

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

***

## 订阅运营

订阅创建完成后，即可执行各种操作来管理订阅生命周期。以下概述了在受支持国家/地区可用的操作：

| 国家 | [计划更新](https://docs.localpayment.com/zh/docs/update-a-subscription-plan.md) | [订阅更新](https://docs.localpayment.com/zh/docs/update-a-subscription.md) | [取消](https://docs.localpayment.com/zh/docs/cancel-a-subscription.md) | [拒付](https://docs.localpayment.com/zh/docs/chargebacks.md) | [Webhook](https://docs.localpayment.com/zh/docs/webhooks.md) |
| - | :-: | :- | :- | :- | :- |
| **[哥伦比亚](https://docs.localpayment.com/zh/docs/colombia.md)** | ✔ | ✔ | ✔ | ✔ | ✔ |
| **[墨西哥](https://docs.localpayment.com/zh/docs/mexico.md)** | ✔ | ✔ | ✔ | ✔ | ✔ |
| **[秘鲁](https://docs.localpayment.com/zh/docs/peru.md)** | ✔ | ✔ | ✔ | ✔ | ✔ |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.