用途:该技能用于 Mercado Pago 钱包相关集成,涵盖三类产品:Wallet Connect、债务支付(Debt Payment)与批量支付链接(Massive Payment Links)。触发关键词包括 Wallet Connect、cuenta MP、deuda、debt、link de pago、payment_link、massive links、link masivo、billetera。注意:不适用于结账流程,结账应改用 mp-checkout-online。
主要能力与流程:Wallet Connect 通过 OAuth 将用户 MP 钱包绑定到平台,流程为跳转授权、用户登录授权、回调获取授权码、换取用户级 access token、再访问钱包功能(读取余额、创建扣款)。债务支付流程为创建含付款人标识的债务记录、生成支付链接或通知、付款人支付、通过 webhook 接收结果。批量支付链接支持通过 API 或 CSV 上传批量生成,每条链接有唯一 ID 并独立跟踪状态,可通过 webhook 或轮询监控。
限制与注意事项:Wallet Connect 需 OAuth 授权,token 为用户级且需定期刷新,长期 token 需 offline_access scope,用户可随时撤销 token,需优雅处理。债务支付有各国监管要求,实施前需确认合规。批量链接生成有速率限制。国家可用性:Wallet Connect 支持 AR、BR、MX;债务支付仅 AR;批量支付链接支持 AR、BR、MX。
前置条件:Wallet Connect 需经 Mercado Pago 审核的已批准应用;债务支付需特定权限;需有效 MP 账户及凭据(public key + access token)。可通过 MCP 获取 OAuth 授权与 token 交换端点、债务支付创建端点与载荷结构、批量链接 API 与状态端点、token 刷新与撤销端点;文档路径为 {DOMAIN}/developers/{LANG}/docs/wallet-connect/landing。