周期性支付
让周期性支付与客户关系紧密相连
创建和管理银行卡订阅，监控订阅状态，并通过可配置的重试挽回失败扣款。现已在哥伦比亚、墨西哥和秘鲁上线；其他市场，我们的团队可与您一起基于本地支付方式设计定期收款流程。
- 按计划或按需扣款
- 重试策略可配置
- 每次续费均可追踪
按计划或按需扣款概览
USD
1,284,560.00
+4.2%
BRL
3,420,118.40
+12.8%
MXN
8,905,332.10
+6.1%
- 收款 · Pixorder_8F2K-1043+ R$ 1,250.00
- 付款 · SPEIseller_0921− MX$ 18,400.00
- 换汇 · BRL → USDfx_3b7q250,000.00 USD
- 收款 · Bre-Border_9A1C-2210+ COP 890,000
- CO · MX · PE
- 现已上线 · 其他市场可按需规划
- 2 种模式
- 按计划扣款和按需扣款
- 重试
- 尝试次数和间隔可配置
- Webhook
- 每笔扣款均有通知
为什么选择 Localpayment
持续续费、轻松对账的周期性收入
按计划扣款、挽回失败扣款并保持系统同步，所需功能一应俱全。
按您的方式计费
基于计划按固定周期扣款，或在用量或事件触发时按需扣款。
挽回失败扣款
设置失败扣款的重试次数和间隔。如果所有重试均失败，订阅会被相应标记，方便您的团队采取下一步行动。
每次续费均可追踪
每次续费都会记录为一笔单独交易，拥有独立的状态、Webhook 和报表数据，订阅的对账方式与一次性支付相同。
随时更换计划
更新金额、频率或付款人信息，更换计划或取消订阅，并通过 Webhook 跟踪每项变更。
联系我们的销售团队
告诉我们您的市场和交易量，我们将与您一起设计集成方案。
覆盖范围
周期性支付覆盖市场
银行卡订阅
- co
- mx
- pe
现已在哥伦比亚、墨西哥和秘鲁上线：使用令牌化银行卡按计划或按需扣款。
其他市场
可按需规划：我们的团队可与您一起基于本地支付方式设计定期收款流程。
co
mx
pe应用场景
为持续计费的业务而生
流媒体与数字内容
月度或年度计划，可按功能设置不同档位。
流媒体与数字内容 —SaaS
面向企业和个人的软件计划，可通过 API 升级或降级。
SaaS —会员与俱乐部
健身房会员、俱乐部会费和忠诚度计划，计费周期灵活。
公用事业与电信
宽带、移动通信等月度服务的周期性付款。
资金流
订阅扣款如何执行
银行卡仅需令牌化一次；每次续费自动扣款，并支持可配置的重试。
- 1
客户您的平台:
使用银行卡订阅
Localpayment 对卡信息仅令牌化一次，供定期扣款使用。
- 2
您的平台Localpayment:
创建订阅
将计划、金额和计费周期绑定到令牌。
- 3
Localpayment本地通道/银行:
每个周期扣款
本地收单，发卡行看到的是境内交易。
- 4
本地通道/银行Localpayment:
通过或拒绝
被拒交易按您配置的计划重试。
- 5
Localpayment您的平台:
每次扣款 webhook
您的平台根据结果延续或暂停服务。
示意流程。银行卡订阅适用于哥伦比亚、墨西哥和秘鲁，详见国家页面。
工作原理
订阅如何运行
- 01
创建
选择固定计划或自定义金额与频率，然后携带卡片令牌调用 POST /api/payin/subscriptions，即可获得订阅 ID。
- 02
续费
每个周期自动扣款，也可按需扣款。失败扣款按您的设置重试，每个结果都会通过 Webhook 通知。
- 03
管理
通过 API 更新金额、频率或付款人信息、更换计划或取消订阅，每次变更都会通过 Webhook 通知。
规格
周期性支付一览
银行卡订阅
- 运作方式
- 支持哥伦比亚、墨西哥和秘鲁
- 详情
- 使用令牌化银行卡按计划或按需扣款
计划
- 运作方式
- 通过 API 创建和管理计划
- 详情
- 设置金额、币种和扣款频率
重试
- 运作方式
- 为失败的付款配置重试规则
- 详情
- 设置重试次数和间隔
订阅管理
- 运作方式
- 通过 API 更新或取消订阅
- 详情
- 管理金额、频率、付款人信息或计划变更
报表
- 运作方式
- 将每次续费作为单独交易进行跟踪
- 详情
- 通过 Webhook 和报表监控状态
限额与定价
- 运作方式
- 按市场和支付方式确定
- 详情
- 联系我们的团队了解详情
银行卡订阅目前支持哥伦比亚、墨西哥和秘鲁。具体功能和商务条款将在入驻过程中确认。
开发者
一次调用创建订阅
发送计划、卡片令牌和重试策略即可。之后由 Localpayment 执行每次扣款，并通过 Webhook 回报结果。
- 固定计划（planId）或自定义金额与频率
- retry.repetitions、retry.intervalValue 和 retry.intervalUnit
- 随时通过 API 更新或取消
# 示意请求：字段已简化，完整规范请见 docs.localpayment.com curl -X POST https://api.stage.localpayment.com/api/payin/subscriptions \ -H "Authorization: Bearer $ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "paymentMethod": { "type": "CreditCard", "code": "1900", "flow": "DIRECT" }, "externalId": "5d7c2a90-0000-4000-8000-000000000031", "country": "COL", "currency": "COP", "planId": "<your-plan-id>", "accountNumber": "<your-account-number>", "conceptCode": "0001", "merchant": { "type": "COMPANY", "name": "Comercio Ejemplo S.A.S." }, "payer": { "type": "INDIVIDUAL", "name": "Andrés", "lastname": "Gómez", "document": { "type": "CC", "id": "1000000000" }, "email": "andres.gomez@example.com" }, "card": { "token": "<card-token>" }, "retry": { "repetitions": 3, "intervalValue": 1, "intervalUnit": "day" } }'
// 示意请求：字段已简化，完整规范请见 docs.localpayment.com const res = await fetch('https://api.stage.localpayment.com/api/payin/subscriptions', { method: 'POST', headers: { Authorization: `Bearer ${accessToken}`, // from POST /api/token/ 'Content-Type': 'application/json', }, body: JSON.stringify({ paymentMethod: { type: 'CreditCard', code: '1900', flow: 'DIRECT' }, // Visa · Colombia externalId: crypto.randomUUID(), country: 'COL', currency: 'COP', planId: process.env.LP_PLAN_ID, // 通过 POST /api/subscriptions/plan 创建 accountNumber: process.env.LP_ACCOUNT_NUMBER, conceptCode: '0001', merchant: { type: 'COMPANY', name: 'Comercio Ejemplo S.A.S.' }, payer: { type: 'INDIVIDUAL', name: 'Andrés', lastname: 'Gómez', document: { type: 'CC', id: '1000000000' }, email: 'andres.gomez@example.com', }, card: { token: storedCardToken }, retry: { repetitions: 3, intervalValue: 1, intervalUnit: 'day' }, }), }); const subscription = await res.json();
常见问题
银行卡订阅在哪些市场可用？
哥伦比亚、墨西哥和秘鲁，支持按计划和按需两种模式。
续费失败会怎样？
我们会按您配置的规则重试。如果所有重试均失败，订阅会被相应标记，且不再尝试自动扣款，方便您的团队采取下一步行动。
订阅开始后可以修改吗？
可以。您可以通过 API 更新金额、频率或付款人信息，更换计划或取消订阅。
续费会出现在报表中吗？
会。每次续费都会记录为一笔单独交易，会像其他付款一样出现在报表和 Webhook 中。
可以用本地支付方式收取订阅费吗？
银行卡订阅在哥伦比亚、墨西哥和秘鲁可用。其他国家，我们的团队可与您一起基于本地支付方式设计定期收款流程。
订阅扣款如何对账？
与一次性支付完全相同：每笔扣款都带有您的 externalId 和我们的 internalId，扣款、失败和变更的 Webhook 均有 HMAC-SHA256 签名，拒付处理同样覆盖订阅扣款，Business Portal 报表支持导出 XLS。