用途:该技能用于在 Mercado Pago 上实现订阅与周期性付款,覆盖订阅计划、预授权(Preapproval)、发票(Invoices)和 Click & Collect。触发关键词包括 subscription、suscripcion、plan、recurrence、recurring、preapproval、invoice、cobro recurrente、pago recurrente。一次性付款不适用,应改用 mp-checkout-online。
主要能力与选择逻辑:固定金额、固定周期用订阅计划(创建计划后由订阅者订阅);按需变动金额用预授权(先授权,再按需扣款);需要灵活周期的循环收款用带手动开票的预授权。订阅计划流程为:创建计划(定义金额、频率、账单日)→ 分享订阅链接或直接创建预授权 → 用户授权 → Mercado Pago 按周期自动扣款 → 通过 webhook 监控订阅状态与发票。预授权流程为:创建预授权并指定授权上限 → 用户授权 → 按需创建发票 → Mercado Pago 处理每张发票。
注意事项:已有订阅者后计划不可修改,需新建计划并迁移订阅者;预授权扣款不得超过创建时设定的授权上限;发票重试遵循 Mercado Pago 标准重试计划,失败发票先进入回收状态再取消;订阅 webhook 使用 plan.、subscription.、invoice.* 主题;免费试用期可选,但必须在创建计划时设置;billing_day 决定月度计划的扣款日期。
前提条件:有效的 Mercado Pago 账户及凭据(public key 与 access token),并配置订阅事件通知 URL。可用国家:AR、BR、MX、CL、CO、PE、UY,具体功能与支付方式因国家而异。
数据获取:通过 MCP 服务器获取计划创建端点与载荷结构、预授权创建与管理端点、发票管理端点(创建、查询、取消)及订阅 webhook 事件结构;文档入口为 {DOMAIN}/developers/{LANG}/docs/subscriptions/landing。