Mercado Pago · Example Payload

Mercado Pago Create Preference Example

PaymentsCheckoutSubscriptionPoint-of-SaleQRPixSDKWalletsAcquiringLendingIssuingLatin AmericaBrazilArgentinaMexicoChileColombiaPeruUruguayFintech

Mercado Pago Create Preference Example is an example object payload from Mercado Pago, with 2 top-level fields. It illustrates the shape of data this provider's APIs accept or return.

Top-level fields

requestresponse

Example Payload

{
  "request": {
    "method": "POST",
    "url": "https://api.mercadopago.com/checkout/preferences",
    "headers": {
      "Authorization": "Bearer APP_USR-1234567890",
      "Content-Type": "application/json"
    },
    "body": {
      "items": [
        {
          "id": "SKU-001",
          "title": "API Evangelist hoodie",
          "description": "Premium cotton, navy blue",
          "category_id": "fashion",
          "quantity": 1,
          "currency_id": "BRL",
          "unit_price": 199.9
        }
      ],
      "payer": {
        "email": "buyer@example.com",
        "first_name": "Kin",
        "last_name": "Lane"
      },
      "back_urls": {
        "success": "https://merchant.example.com/checkout/success",
        "pending": "https://merchant.example.com/checkout/pending",
        "failure": "https://merchant.example.com/checkout/failure"
      },
      "auto_return": "approved",
      "notification_url": "https://merchant.example.com/webhooks/mercadopago",
      "external_reference": "ORDER-2026-0042"
    }
  },
  "response": {
    "status": 201,
    "body": {
      "id": "1234567890-abc1234d-5678-90ef-ghij-klmnopqrstuv",
      "client_id": "1234567890",
      "collector_id": 987654321,
      "date_created": "2026-05-25T13:30:00.000-03:00",
      "external_reference": "ORDER-2026-0042",
      "init_point": "https://www.mercadopago.com.br/checkout/v1/redirect?pref_id=1234567890-abc1234d",
      "sandbox_init_point": "https://sandbox.mercadopago.com.br/checkout/v1/redirect?pref_id=1234567890-abc1234d",
      "items": [
        {
          "id": "SKU-001",
          "title": "API Evangelist hoodie",
          "quantity": 1,
          "currency_id": "BRL",
          "unit_price": 199.9
        }
      ]
    }
  }
}

Work with this as data

Every example here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for examples

4 MCP tools reach this

find_examplesBrowse and filter every example in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This example

curl "https://apis.io/api/v1/examples/mercado-pago-create-preference-example"

All examples

curl "https://apis.io/api/v1/examples?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.