MercadoPago API

Finance / API Key Intermediate HTTPS

Varies by plan (check documentation)

72 B

Metadata Score Metadata estimate · not endpoint-tested

Visit Official Site Compare Alternatives

Overview

MercadoPago is a leading payment platform in Latin America, and its API lets you integrate payment processing, refunds, and subscription billing into your app. You can accept credit cards, bank transfers, and local payment methods across Argentina, Brazil, Mexico, and more. It is widely used by e-commerce developers who need to handle payments for Spanish and Portuguese-speaking markets.

Beginner Tip

Use the sandbox credentials provided in your MercadoPago developer account to test payments without real money; switch to production credentials only when you are ready to go live.

Available Data

MercadoPago data via REST API

Example Response

JSON Response

{
  "status": "success",
  "data": {
    "result": "Data from MercadoPago",
    "description": "Mercado Pago API reference - all the information you need to develop your integrations",
    "timestamp": "2025-01-15T10:00:00Z"
  }
}

Field Reference

id Unique identifier for the created payment transaction.

status Current payment status: approved, pending, rejected, or in_process.

status_detail More specific reason for the current status, useful for debugging rejected payments.

transaction_amount The amount that was charged in the currency of the transaction.

currency_id ISO 4217 currency code for the transaction (e.g., BRL, ARS, MXN).

Implementation Example

Request

// ⚠️ Note: This URL may be a documentation page. Check official docs for actual API endpoint.
const url = "https://www.mercadopago.com.br/developers/es/reference";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "X-API-Key": "YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

401 Unauthorized Access token is missing, expired, or from the wrong environment

✓ Include your access token as a Bearer token in the Authorization header and confirm you are using the right environment credentials.

400 Bad Request with invalid_param Required payment fields are missing or have incorrect values

✓ Review the MercadoPago API reference for the required fields and ensure amounts are provided as numbers in the correct currency.

503 Service Unavailable Temporary service disruption on MercadoPago servers

✓ Implement retry logic with exponential backoff; check the MercadoPago status page for ongoing incidents.

Metadata Score Breakdown

Estimated from metadata — endpoint not independently tested

This score is estimated from observable metadata — HTTPS support, authentication model, declared CORS, and documentation reachability — because the API requires authentication or exposes no publicly testable endpoint. The five-signal breakdown is only shown for live-tested APIs.

Metadata estimate · endpoint not independently tested

How is this scored? →