用途:为开发者提供 Mercado Pago 在线支付接入的集成模式与决策指引。适用于会话涉及 preference、init_point、back_urls、Checkout Pro、Checkout API、payment.create、卡令牌化、3DS、跨境、在线支付等场景;不适用于 QR/Point(用 mp-instore)、订阅(用 mp-subscriptions)与市场分账(用 mp-marketplace)。
主要能力:覆盖 Checkout Pro(基于 preference 的重定向式,最易接入)、Checkout API(服务端直连创建,支持卡令牌化、银行转账、现金/线下与钱包)、3DS(额外持卡人认证,仅适用于 Checkout API 或 Bricks,Checkout Pro 默认已集成)以及 CBP 跨境支付。含支付状态参考表与常见坑点。
流程要点:Checkout Pro 在服务端创建 preference(items[].title、unit_price、quantity 为必填,back_urls、auto_return、notification_url、statement_descriptor、external_reference 建议配置),客户端跳转 init_point,回调后须通过 Payments API 与 webhook 核验状态,不可仅信任重定向参数。Checkout API 卡支付先客户端用 MercadoPago.js(cardForm 或 createCardToken)令牌化,再服务端创建 payment;非卡方式直接以 payment_method_id 与 payer 数据创建并返回二维码/票据链接。
限制与注意:currency_id 须与国别匹配;卡 token 单次使用且 7 天过期;部分卡方式需 issuer_id;可用支付方式随国家而异。3DS 须设 binary_mode: false。CBP 需特定配置与审批,暂无公开文档,需联系 Key Account Manager。测试须用生产凭证 APP_USR-*,不再使用 TEST- 沙箱凭证;测试跳转使用 init_point,sandbox_init_point 已弃用。
依赖:已获批的 Mercado Pago 账户、服务端 Access Token 与客户端 Public Key、对应语言 SDK(如 mercadopago)、HTTPS webhook 端点。可用国家:阿根廷、巴西、墨西哥、智利、哥伦比亚、秘鲁、乌拉圭。动态数据请查询 MCP 服务器或官方文档路径。