用途:面向 Mercado Pago 市场(Marketplace)集成,帮助构建多卖家支付场景。覆盖产品包括:Marketplace Checkout(代卖家收款)、Split Payments(在市场与卖家间分配资金)、Seller Onboarding(基于 OAuth 的卖家连接)、平台集成(如 VTEX,将 MP 作为电商平台支付提供方,VTEX 是最常见的集成请求)、Application Fees(每笔支付的市场佣金)。
适用查询关键词:marketplace、split、application_fee、VTEX、sellers、multi-vendor。不适用于单卖家支付,单卖家场景应改用 mp-checkout-online。
决策路径:需要收款并分账时,若由市场处理支付则用 Split Payment,若由卖家处理支付则用 Application Fee;需要卖家入驻时走 OAuth 流程获取卖家 access_token;使用 VTEX 等电商平台时采用平台专用 MP 模块,需查阅 MCP/文档进行配置;需要管理卖家提现时,可结合 mp-money-out skill。
集成流程(市场分账):通过 OAuth 完成卖家入驻;买家经市场结账付款;创建支付时带上 application_fee(市场佣金);MP 分账,卖家获得金额减去费用,市场获得费用;向市场与卖家双方发送 Webhook。
集成流程(卖家入驻):将卖家重定向到带市场 app_id 的 MP OAuth URL;卖家授权;收到 authorization_code;换取卖家的 access_token 与 refresh_token;安全存储令牌。
注意事项:application_fee 不能超过总额的某一百分比(因国家而异);卖家须拥有已获批的 MP 账户;OAuth 令牌会过期,需实现刷新流程;分账百分比按每笔支付定义,而非全局;VTEX 集成有独立配置面板。
前置条件:市场应用已获 MP 批准;OAuth 已配置 redirect_uri;卖家须授权市场。
国家可用性:AR、BR、MX、CL、CO、PE、UY(VTEX 因地区而异)。
需从 MCP/文档获取:OAuth 端点、分账支付创建、application_fee 限额、卖家管理 API。参考路径:{DOMAIN}/developers/{LANG}/docs/checkout-pro/additional-content/security/oauth/creation。
限制:具体端点、参数与配置细节需查阅官方 MCP/文档,本资料未提供完整代码示例与全部配置项。