周期性支付
让周期性支付与客户关系紧密相连
创建和管理银行卡订阅，监控订阅状态，并通过可配置的重试挽回失败扣款。现已在哥伦比亚、墨西哥和秘鲁上线；其他市场，我们的团队可与您一起基于本地支付方式设计定期收款流程。
- 按计划或按需扣款
- 重试策略可配置
- 每次续费均可追踪
按计划或按需扣款概览
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
银行卡订阅
可配置重试的订阅
按计划扣款、挽回失败扣款并保持系统同步，所需功能一应俱全。
按计划或按需
基于计划按固定周期扣款，或在用量或事件触发时按需扣款。
可配置的催收重试
设置失败扣款的重试次数和间隔，匹配您的计费模式。
清晰的付款状态
如果所有重试均失败，订阅会被相应标记，方便您的团队采取下一步行动。
每笔扣款都可追溯
每次续费都会记录为一笔单独交易，拥有独立的状态、Webhook 和报表数据。
计划 API
创建、更新和查询预设金额与计费周期的计划。
全面掌控
通过 API 更新金额、频率或付款人信息，更换计划或取消订阅。
资金流
订阅扣款如何执行
银行卡仅需令牌化一次；每次续费自动扣款，并支持可配置的重试。
- 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 和报表监控状态
限额与定价
- 运作方式
- 按市场和支付方式确定
- 详情
- 联系我们的团队了解详情
银行卡订阅目前支持哥伦比亚、墨西哥和秘鲁。具体功能和商务条款将在入驻过程中确认。
运营
财务团队可追溯的续费
每次续费都会记录为一笔单独交易，因此银行卡订阅的对账方式与一次性支付完全相同：相同的标识符、相同的 Webhook、相同的报表。
- 每笔扣款都带有您的 externalId 和我们的 internalId
- 扣款、失败和变更均有 HMAC-SHA256 签名 Webhook
- 支持订阅扣款的拒付处理
- Business Portal 报表支持导出 XLS
- 09:41:02.11409:41:02PayIn100 INPROGRESS20084 ms
- 09:41:05.90209:41:05PayIn200 COMPLETED20091 ms
- 09:42:18.33009:42:18PayOut100 INPROGRESS20077 ms
- 09:42:40.01809:42:40PayOut200 COMPLETED20088 ms
- 09:43:00.55109:43:00VirtualAccount200 COMPLETED20080 ms
POST https://example-merchant.com/webhooks/localpayment
x-Signature: HMAC-SHA256 3f9a1c0e…b47e2b
{ "transactionType": "PayIn", "transactionFlow": "DIRECT",
"data": { "externalId": "order_8F2K-1043",
"status": { "code": "200", "description": "COMPLETED" } } }开发者
一次调用创建订阅
发送计划、卡片令牌和重试策略即可。之后由 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" }
}'应用场景
为持续计费的业务而生
流媒体与数字内容
月度或年度计划，可按功能设置不同档位。
流媒体与数字内容 —SaaS
面向企业和个人的软件计划，可通过 API 升级或降级。
SaaS —会员与俱乐部
健身房会员、俱乐部会费和忠诚度计划，计费周期灵活。
公用事业与电信
宽带、移动通信等月度服务的周期性付款。
常见问题
银行卡订阅在哪些市场可用？
哥伦比亚、墨西哥和秘鲁，支持按计划和按需两种模式。
续费失败会怎样？
我们会按您配置的规则重试。如果所有重试均失败，订阅会被相应标记，且不再尝试自动扣款，方便您的团队采取下一步行动。
订阅开始后可以修改吗？
可以。您可以通过 API 更新金额、频率或付款人信息，更换计划或取消订阅。
续费会出现在报表中吗？
会。每次续费都会记录为一笔单独交易，会像其他付款一样出现在报表和 Webhook 中。
可以用本地支付方式收取订阅费吗？
银行卡订阅在哥伦比亚、墨西哥和秘鲁可用。其他国家，我们的团队可与您一起基于本地支付方式设计定期收款流程。