Mercado Pago MCP icon

Mercado Pago MCP

Integração com MCP Server do Mercado Pago

Actions26

Overview

This node integrates with the Mercado Pago MCP Server to manage payments and related resources such as orders, customers, preferences, webhooks, and notifications. Specifically for the Payment - Get operation, it retrieves detailed information about a specific payment by its ID.

Common scenarios where this node is beneficial include:

  • Fetching the status and details of a payment after it has been created.
  • Verifying payment information before processing an order or shipment.
  • Auditing or reporting on individual payment transactions.

Practical example:

  • After a customer completes a payment on your e-commerce site, use this node to get the payment details (status, amount, payer info) to confirm successful payment before fulfilling the order.

Properties

Name Meaning
ID do Pagamento The unique identifier of the payment to retrieve or cancel. Example: "1234567890"

Output

The output JSON contains the retrieved payment information under the payment field. It includes all data returned by the Mercado Pago API for that payment, such as:

  • Payment ID
  • Status (approved, pending, cancelled, etc.)
  • Transaction amount
  • Payment method details
  • Payer information (email, identification)
  • Dates (creation, approval, last update)
  • Additional metadata related to the payment

Additionally, the output includes:

  • type: A string indicating the operation type, here "payment_retrieved".
  • success: Boolean indicating if the operation was successful.
  • timestamp: ISO timestamp of when the operation was performed.

No binary data is output by this operation.

Example output structure (simplified):

{
  "type": "payment_retrieved",
  "payment": {
    "id": "1234567890",
    "status": "approved",
    "transaction_amount": 100.5,
    "payment_method_id": "pix",
    "payer": {
      "email": "usuario@exemplo.com"
    },
    "date_created": "2024-01-01T12:00:00Z",
    ...
  },
  "success": true,
  "timestamp": "2024-06-01T10:00:00Z"
}

Dependencies

  • Requires an API key credential for Mercado Pago MCP with appropriate permissions.
  • Uses the Mercado Pago REST API endpoint (https://api.mercadopago.com) for payment operations.
  • Requires network access to Mercado Pago's API.
  • No additional external dependencies beyond the HTTP client bundled in n8n.

Troubleshooting

  • Common issues:

    • Invalid or missing payment ID will cause the API to return an error.
    • Expired or invalid API credentials will result in authentication errors.
    • Network connectivity problems can cause request failures.

  • Error messages and resolutions:

    • "Card token is required for card payments" — Not applicable for Get operation but relevant for create; ensure token is provided when creating card payments.
    • "Issuer ID is required for card payments" — Same as above.
    • API returns 404 or "not found" — Verify the payment ID exists and is correct.
    • Authentication errors — Check that the API key credential is valid and has not expired.
    • Rate limiting or quota exceeded — Wait and retry later or check account limits.

  • To handle errors gracefully, enable the node’s "Continue On Fail" option to capture error details in the output.

Links and References

Discussion