Mercado Pago website screenshot

Mercado Pago

Mercado Pago is the payments and financial-services arm of Mercado Libre, Latin America's largest e-commerce and fintech platform. Founded in 2003, it processes a substantial share of LatAm digital payments across Brazil (PIX, Boleto, cards), Argentina, Mexico (SPEI, OXXO), Chile, Colombia, Peru, and Uruguay, with consumer wallet, merchant acquiring, card issuing, lending, and crypto products layered on top. The developer portal at developers.mercadopago.com exposes a deep payments stack — Checkout Pro (hosted), Checkout Bricks (composable web components), Checkout API (full server-side control), Orders API (next-gen checkout), Subscriptions, Payment Links, Point (in-person card readers), and QR payments — backed by REST APIs and official SDKs in Node.js / TypeScript, Python, PHP, Ruby, Java, .NET, Go, iOS, and Android, plus a CLI, an MCP server for AI agents, e-commerce plugins (WooCommerce, VTEX, Tiendanube, Shopify), and an n8n integration. Regional developer portals (.com.ar, .com.br, .com.mx, .com.cl, .com.co, .com.pe, .com.uy) localise docs and pricing per LATAM market.

29 APIs 0 Features
PaymentsCheckoutSubscriptionsPOSQRPIXSDKsWalletAcquiringLendingIssuingLatin AmericaBrazilArgentinaMexicoChileColombiaPeruUruguayFintech

APIs

Mercado Pago Payments API

Core REST API for creating and managing payments across cards, account money, bank transfer (PIX in Brazil, SPEI in Mexico, PSE in Colombia), boleto, OXXO cash, and other LATAM ...

Mercado Pago Checkout Pro

Hosted, pre-configured checkout experience. Merchants create a preference via API, then redirect the buyer to a Mercado Pago hosted page that handles UI, payment-method selectio...

Mercado Pago Checkout Bricks

Composable web components ("bricks") merchants embed in their own UI — card form, wallet, payment-method picker, status screen, security code. Lets merchants assemble a branded ...

Mercado Pago Checkout API

Full server-side checkout control. Tokenise cards client-side, create a payment server-side, manage 3DS challenges, handle capture, refund, and installments — all without redire...

Mercado Pago Orders API

Next-generation unified Orders API consolidating payments, captures, refunds, and transactions under a single resource. Supports multi-method orders, partial captures, partial r...

Mercado Pago Subscriptions API

Recurring payment subscriptions (preapproval) with scheduling, shared plans, free trial, proration, and pause / resume / cancel. Supports both subscription plans (preapproval_pl...

Mercado Pago Payment Links API

No-code / low-code link generation for collecting a one-off or recurring payment via shareable URL or button — SMS, WhatsApp, email, social.

Mercado Pago Customers & Cards API

Manage stored customers and tokenised cards for one-click and recurring payments. CRUD for customers, addresses, and card tokens.

Mercado Pago Merchant Orders API

Aggregate a preference + its payments into a single merchant_order resource for reconciliation, multi-payment handling, and order lifecycle.

Mercado Pago Point API (POS)

Integrates merchant systems with Mercado Pago Point card readers for in-person payments. Push an amount to a paired terminal, manage stores, points-of-sale, and terminals, and r...

Mercado Pago QR API

Static and dynamic QR code APIs for in-person collection, with order-linked status retrieval and webhook callbacks. Underpins the Mercado Pago wallet QR pay flow.

Mercado Pago Chargebacks API

Retrieve and respond to chargebacks, including dispute reason codes and lifecycle states.

Mercado Pago Claims & Disputes API

Post-sale claims, mediations, evidence upload, messages, and notification retrieval for resolving buyer disputes.

Mercado Pago Reports API

Generate, configure, and download release / settlement / account-money reports for reconciliation and accounting.

Mercado Pago OAuth 2.0 API

OAuth 2.0 authorisation-code flow for platform integrations: marketplaces and partners obtain delegated access tokens on behalf of merchants.

Mercado Pago Webhooks / Notifications

Event-driven notifications for payments, refunds, chargebacks, subscriptions, merchant orders, and account changes. Webhooks are signed with an x-signature header so receivers c...

Mercado Pago Node.js SDK

Official Node.js / TypeScript SDK wrapping the Mercado Pago REST APIs for payments, preferences, subscriptions, customers, cards, and merchant orders.

Mercado Pago Python SDK

Official Python SDK wrapping the Mercado Pago REST APIs.

Mercado Pago PHP SDK

Official PHP SDK wrapping the Mercado Pago REST APIs. Used by the WooCommerce plugin and most LATAM PHP merchant stacks.

Mercado Pago Ruby SDK

Official Ruby SDK wrapping the Mercado Pago REST APIs.

Mercado Pago Java SDK

Official Java SDK wrapping the Mercado Pago REST APIs.

Mercado Pago .NET SDK

Official .NET / C# SDK wrapping the Mercado Pago REST APIs.

Mercado Pago Go SDK

Official Go SDK for the Mercado Pago REST APIs.

Mercado Pago iOS SDK

Official iOS / Swift mobile SDK providing card tokenisation, hosted payment screens, and Checkout integration for native iOS apps.

Mercado Pago Android SDK

Official Android / Kotlin mobile SDK for tokenisation, payment screens, and Checkout integration in native Android apps.

Mercado Pago CLI

Command-line interface for managing Mercado Pago integrations: trigger test events, inspect webhook deliveries, scaffold sample apps, and run local listeners. Distributed via a ...

Mercado Pago MCP Server

Model Context Protocol server exposing Mercado Pago APIs as tools for AI agents and IDE assistants. Enables agent-driven payment, preference, and checkout workflows from Anthrop...

Mercado Pago WooCommerce Plugin

Official WooCommerce gateway plugin enabling Mercado Pago Checkout Pro, Bricks, and Checkout API payment methods in WordPress stores.

Mercado Pago n8n Node

Official n8n workflow automation node for orchestrating Mercado Pago operations alongside other SaaS apps.

Collections

Pricing Plans

Rate Limits

Mercado Pago Rate Limits

3 limits

RATE LIMITS

FinOps

Event Specifications

Mercado Pago Webhooks (IPN / Webhooks v2)

Mercado Pago webhook notifications for payments, refunds, chargebacks, merchant orders, subscriptions, and POS events. Webhook payloads include `x-signature` and `x-request-id` ...

ASYNCAPI

Semantic Vocabularies

Mercado Pago Context

33 classes · 0 properties

JSON-LD

API Governance Rules

Mercado Pago API Rules

8 rules · 5 errors 3 warnings

SPECTRAL

JSON Structure

Mercado Pago Payment Structure

14 properties

JSON STRUCTURE

Mercado Pago Preference Structure

10 properties

JSON STRUCTURE

Example Payloads

Resources

🔗
Website
Website
🔗
Developers
Developers
🔗
Documentation
Documentation
🔗
APIReference
APIReference
🚀
GettingStarted
GettingStarted
🟢
Status
Status
🔗
LinkedIn
LinkedIn
👥
GitHubOrganization
GitHubOrganization
🔗
HomebrewTap
HomebrewTap
🔗
Discord
Discord
🔗
Plans
Plans
🔗
RateLimits
RateLimits
🔗
FinOps
FinOps
🔗
Vocabulary
Vocabulary
🔗
JSONLD
JSONLD
🔗
SpectralRuleset
SpectralRuleset

Sources

Raw ↑
opencollection: 1.0.0
info:
  name: Mercado Pago REST API
  version: v1
request:
  auth:
    type: bearer
    token: '{{bearerToken}}'
items:
- info:
    name: Authentication
    type: folder
  items:
  - info:
      name: Create Or Refresh An OAuth Token
      type: http
    http:
      method: POST
      url: https://api.mercadopago.com/oauth/token
      body:
        type: json
        data: '{}'
    docs: Create Or Refresh An OAuth Token
- info:
    name: Payments
    type: folder
  items:
  - info:
      name: Create A Payment
      type: http
    http:
      method: POST
      url: https://api.mercadopago.com/v1/payments
      body:
        type: json
        data: '{}'
    docs: Create A Payment
  - info:
      name: Search Payments
      type: http
    http:
      method: GET
      url: https://api.mercadopago.com/v1/payments/search
      params:
      - name: status
        value: ''
        type: query
      - name: external_reference
        value: ''
        type: query
      - name: range
        value: ''
        type: query
      - name: begin_date
        value: ''
        type: query
      - name: end_date
        value: ''
        type: query
      - name: limit
        value: ''
        type: query
      - name: offset
        value: ''
        type: query
    docs: Search Payments
  - info:
      name: Get A Payment
      type: http
    http:
      method: GET
      url: https://api.mercadopago.com/v1/payments/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Get A Payment
  - info:
      name: Update A Payment
      type: http
    http:
      method: PUT
      url: https://api.mercadopago.com/v1/payments/:id
      params:
      - name: id
        value: ''
        type: path
      body:
        type: json
        data: '{}'
    docs: Capture, cancel, or update payment metadata.
  - info:
      name: Cancel A Payment
      type: http
    http:
      method: PUT
      url: https://api.mercadopago.com/v1/payments/:id/cancel
      params:
      - name: id
        value: ''
        type: path
    docs: Cancel A Payment
- info:
    name: Refunds
    type: folder
  items:
  - info:
      name: List Refunds For A Payment
      type: http
    http:
      method: GET
      url: https://api.mercadopago.com/v1/payments/:id/refunds
      params:
      - name: id
        value: ''
        type: path
    docs: List Refunds For A Payment
  - info:
      name: Refund A Payment
      type: http
    http:
      method: POST
      url: https://api.mercadopago.com/v1/payments/:id/refunds
      params:
      - name: id
        value: ''
        type: path
      body:
        type: json
        data: '{}'
    docs: Refund A Payment
  - info:
      name: Get A Refund
      type: http
    http:
      method: GET
      url: https://api.mercadopago.com/v1/payments/:id/refunds/:refund_id
      params:
      - name: id
        value: ''
        type: path
      - name: refund_id
        value: ''
        type: path
    docs: Get A Refund
- info:
    name: Payment Methods
    type: folder
  items:
  - info:
      name: List Payment Methods
      type: http
    http:
      method: GET
      url: https://api.mercadopago.com/v1/payment_methods
    docs: List Payment Methods
  - info:
      name: List Identification Types
      type: http
    http:
      method: GET
      url: https://api.mercadopago.com/v1/identification_types
    docs: List Identification Types
- info:
    name: Preferences
    type: folder
  items:
  - info:
      name: Create A Checkout Preference
      type: http
    http:
      method: POST
      url: https://api.mercadopago.com/checkout/preferences
      body:
        type: json
        data: '{}'
    docs: Create A Checkout Preference
  - info:
      name: Search Preferences
      type: http
    http:
      method: GET
      url: https://api.mercadopago.com/checkout/preferences/search
    docs: Search Preferences
  - info:
      name: Get A Preference
      type: http
    http:
      method: GET
      url: https://api.mercadopago.com/checkout/preferences/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Get A Preference
  - info:
      name: Update A Preference
      type: http
    http:
      method: PUT
      url: https://api.mercadopago.com/checkout/preferences/:id
      params:
      - name: id
        value: ''
        type: path
      body:
        type: json
        data: '{}'
    docs: Update A Preference
- info:
    name: Orders
    type: folder
  items:
  - info:
      name: Create An Order
      type: http
    http:
      method: POST
      url: https://api.mercadopago.com/v1/orders
      body:
        type: json
        data: '{}'
    docs: Create An Order
  - info:
      name: Get An Order
      type: http
    http:
      method: GET
      url: https://api.mercadopago.com/v1/orders/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Get An Order
  - info:
      name: Capture An Order
      type: http
    http:
      method: POST
      url: https://api.mercadopago.com/v1/orders/:id/capture
      params:
      - name: id
        value: ''
        type: path
    docs: Capture An Order
  - info:
      name: Cancel An Order
      type: http
    http:
      method: POST
      url: https://api.mercadopago.com/v1/orders/:id/cancel
      params:
      - name: id
        value: ''
        type: path
    docs: Cancel An Order
  - info:
      name: Refund An Order
      type: http
    http:
      method: POST
      url: https://api.mercadopago.com/v1/orders/:id/refund
      params:
      - name: id
        value: ''
        type: path
    docs: Refund An Order
  - info:
      name: Add A Transaction To An Order
      type: http
    http:
      method: POST
      url: https://api.mercadopago.com/v1/orders/:id/transactions
      params:
      - name: id
        value: ''
        type: path
    docs: Add A Transaction To An Order
- info:
    name: Subscriptions
    type: folder
  items:
  - info:
      name: Create A Subscription
      type: http
    http:
      method: POST
      url: https://api.mercadopago.com/preapproval
      body:
        type: json
        data: '{}'
    docs: Create A Subscription
  - info:
      name: Search Subscriptions
      type: http
    http:
      method: GET
      url: https://api.mercadopago.com/preapproval/search
    docs: Search Subscriptions
  - info:
      name: Get A Subscription
      type: http
    http:
      method: GET
      url: https://api.mercadopago.com/preapproval/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Get A Subscription
  - info:
      name: Update A Subscription
      type: http
    http:
      method: PUT
      url: https://api.mercadopago.com/preapproval/:id
      params:
      - name: id
        value: ''
        type: path
      body:
        type: json
        data: '{}'
    docs: Update A Subscription
- info:
    name: Plans
    type: folder
  items:
  - info:
      name: Create A Subscription Plan
      type: http
    http:
      method: POST
      url: https://api.mercadopago.com/preapproval_plan
      body:
        type: json
        data: '{}'
    docs: Create A Subscription Plan
  - info:
      name: Search Subscription Plans
      type: http
    http:
      method: GET
      url: https://api.mercadopago.com/preapproval_plan/search
    docs: Search Subscription Plans
  - info:
      name: Get A Subscription Plan
      type: http
    http:
      method: GET
      url: https://api.mercadopago.com/preapproval_plan/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Get A Subscription Plan
  - info:
      name: Update A Subscription Plan
      type: http
    http:
      method: PUT
      url: https://api.mercadopago.com/preapproval_plan/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Update A Subscription Plan
- info:
    name: Customers
    type: folder
  items:
  - info:
      name: Create A Customer
      type: http
    http:
      method: POST
      url: https://api.mercadopago.com/v1/customers
      body:
        type: json
        data: '{}'
    docs: Create A Customer
  - info:
      name: Search Customers
      type: http
    http:
      method: GET
      url: https://api.mercadopago.com/v1/customers/search
    docs: Search Customers
  - info:
      name: Get A Customer
      type: http
    http:
      method: GET
      url: https://api.mercadopago.com/v1/customers/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Get A Customer
  - info:
      name: Update A Customer
      type: http
    http:
      method: PUT
      url: https://api.mercadopago.com/v1/customers/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Update A Customer
- info:
    name: Cards
    type: folder
  items:
  - info:
      name: List Customer Cards
      type: http
    http:
      method: GET
      url: https://api.mercadopago.com/v1/customers/:customer_id/cards
      params:
      - name: customer_id
        value: ''
        type: path
    docs: List Customer Cards
  - info:
      name: Save A Card For A Customer
      type: http
    http:
      method: POST
      url: https://api.mercadopago.com/v1/customers/:customer_id/cards
      params:
      - name: customer_id
        value: ''
        type: path
      body:
        type: json
        data: '{}'
    docs: Save A Card For A Customer
  - info:
      name: Get A Customer Card
      type: http
    http:
      method: GET
      url: https://api.mercadopago.com/v1/customers/:customer_id/cards/:card_id
      params:
      - name: customer_id
        value: ''
        type: path
      - name: card_id
        value: ''
        type: path
    docs: Get A Customer Card
  - info:
      name: Delete A Customer Card
      type: http
    http:
      method: DELETE
      url: https://api.mercadopago.com/v1/customers/:customer_id/cards/:card_id
      params:
      - name: customer_id
        value: ''
        type: path
      - name: card_id
        value: ''
        type: path
    docs: Delete A Customer Card
- info:
    name: Merchant Orders
    type: folder
  items:
  - info:
      name: Create A Merchant Order
      type: http
    http:
      method: POST
      url: https://api.mercadopago.com/merchant_orders
    docs: Create A Merchant Order
  - info:
      name: Search Merchant Orders
      type: http
    http:
      method: GET
      url: https://api.mercadopago.com/merchant_orders/search
    docs: Search Merchant Orders
  - info:
      name: Get A Merchant Order
      type: http
    http:
      method: GET
      url: https://api.mercadopago.com/merchant_orders/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Get A Merchant Order
  - info:
      name: Update A Merchant Order
      type: http
    http:
      method: PUT
      url: https://api.mercadopago.com/merchant_orders/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Update A Merchant Order
- info:
    name: Chargebacks
    type: folder
  items:
  - info:
      name: Get A Chargeback
      type: http
    http:
      method: GET
      url: https://api.mercadopago.com/v1/chargebacks/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Get A Chargeback
- info:
    name: Claims
    type: folder
  items:
  - info:
      name: Get A Claim
      type: http
    http:
      method: GET
      url: https://api.mercadopago.com/v1/claims/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Get A Claim
  - info:
      name: Search Claims
      type: http
    http:
      method: GET
      url: https://api.mercadopago.com/v1/claims/search
    docs: Search Claims
- info:
    name: Reports
    type: folder
  items:
  - info:
      name: List Release Reports
      type: http
    http:
      method: GET
      url: https://api.mercadopago.com/v1/account/release
    docs: List Release Reports
  - info:
      name: Generate A Release Report
      type: http
    http:
      method: POST
      url: https://api.mercadopago.com/v1/account/release
    docs: Generate A Release Report
  - info:
      name: Download A Release Report
      type: http
    http:
      method: GET
      url: https://api.mercadopago.com/v1/account/release/:id/download
      params:
      - name: id
        value: ''
        type: path
    docs: Download A Release Report
- info:
    name: Point
    type: folder
  items:
  - info:
      name: Search Stores
      type: http
    http:
      method: GET
      url: https://api.mercadopago.com/v1/stores
    docs: Search Stores
  - info:
      name: Create A Store
      type: http
    http:
      method: POST
      url: https://api.mercadopago.com/v1/stores
    docs: Create A Store
  - info:
      name: Get A Store
      type: http
    http:
      method: GET
      url: https://api.mercadopago.com/v1/stores/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Get A Store
  - info:
      name: Update A Store
      type: http
    http:
      method: PUT
      url: https://api.mercadopago.com/v1/stores/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Update A Store
  - info:
      name: Delete A Store
      type: http
    http:
      method: DELETE
      url: https://api.mercadopago.com/v1/stores/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Delete A Store
  - info:
      name: Search Points Of Sale
      type: http
    http:
      method: GET
      url: https://api.mercadopago.com/pos
    docs: Search Points Of Sale
  - info:
      name: Create A Point Of Sale
      type: http
    http:
      method: POST
      url: https://api.mercadopago.com/pos
    docs: Create A Point Of Sale
  - info:
      name: Get A Point Of Sale
      type: http
    http:
      method: GET
      url: https://api.mercadopago.com/pos/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Get A Point Of Sale
  - info:
      name: Update A Point Of Sale
      type: http
    http:
      method: PUT
      url: https://api.mercadopago.com/pos/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Update A Point Of Sale
  - info:
      name: Delete A Point Of Sale
      type: http
    http:
      method: DELETE
      url: https://api.mercadopago.com/pos/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Delete A Point Of Sale
  - info:
      name: List Point Terminals
      type: http
    http:
      method: GET
      url: https://api.mercadopago.com/point/integration-api/devices
    docs: List Point Terminals
- info:
    name: QR
    type: folder
  items:
  - info:
      name: Create A QR Order
      type: http
    http:
      method: PUT
      url: https://api.mercadopago.com/instore/qr/seller/collectors/:user_id/pos/:external_pos_id/orders
      params:
      - name: user_id
        value: ''
        type: path
      - name: external_pos_id
        value: ''
        type: path
      body:
        type: json
        data: '{}'
    docs: Create or replace the QR order for an in-person point of sale.
  - info:
      name: Delete A QR Order
      type: http
    http:
      method: DELETE
      url: https://api.mercadopago.com/instore/qr/seller/collectors/:user_id/pos/:external_pos_id/orders
      params:
      - name: user_id
        value: ''
        type: path
      - name: external_pos_id
        value: ''
        type: path
    docs: Delete A QR Order
bundled: true