SuperAPI AI 工具集

mp-orders

办公与效率

查看项目

更新于 10-16 00:29

技能介绍

用途:该技能面向 Mercado Pago 的统一订单体系(Orden Unificada),用于实现订单流程、在同一订单中组合在线与线下支付,以及接入 QR 支付。触发关键词包括 Orders API、order de pago、order de pagamento、multi-payment、multiple payment methods on one order。

主要能力:覆盖 Orders API(新统一订单系统,POST /v1/orders),支持多种支付方式、部分支付和 QR 集成,官方建议所有新集成使用;Orders + QR 将订单与 QR 支付流程结合,在 Orders API 框架内实现门店支付;merchant_orders 为旧版 API 的订单实体,若现有代码中出现,建议迁移到 Orders API。

使用方式:通过 POST /v1/orders 创建订单,包含商品、金额与配置;为订单关联一个或多个支付方式;逐个处理支付,每笔支付独立跟踪;按支付事件接收 webhook(order.created、order.updated);通过聚合所有支付的订单实体进行对账。若只需简单单笔支付订单,官方建议改用 mp-checkout-online。

适用场景:需要灵活订单管理的新集成、需要订单内多支付方式或部分支付、需要在门店通过 QR 完成订单支付。

限制与注意:订单可部分支付,未覆盖全额前订单不会关闭;订单状态反映所有支付的聚合状态,而每笔支付有独立的状态生命周期;Orders + QR 的 QR 流程遵循与 mp-instore 相同的规则,只是包裹在订单上下文中;支付开始后可能无法修改订单,更新前需检查当前状态。前置条件为拥有有效 Mercado Pago 账户及凭证(public key 与 access token),并理解订单与单笔支付的关系。国家可用性为 AR、BR、MX,是否扩展到其他国家需查阅 Mercado Pago 文档。可通过 MCP 服务器获取 Orders API 创建端点与载荷结构、订单查询与状态端点、Orders + QR 集成流程细节及支付关联端点;文档入口为 {DOMAIN}/developers/{LANG}/docs/orders/landing。