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, orders, customers, preferences, webhooks, notifications, and documentation searches. Specifically for the Payment - Cancel operation, it allows users to cancel an existing payment by providing its payment ID.

Typical use cases include:

  • Automatically cancelling a payment when an order is voided or refunded.
  • Managing payment lifecycle within automated workflows.
  • Integrating payment cancellation into customer service processes.

For example, if a customer requests a refund before the payment is captured, this node can be used to cancel the payment programmatically.

Properties

Name Meaning
ID do Pagamento The unique identifier of the payment to cancel. This is required to specify which payment should be cancelled.

Output

The output JSON contains the result of the cancellation request. It includes:

  • type: A string indicating the type of response, here "payment_cancelled".
  • payment: An object containing detailed information about the cancelled payment as returned by the Mercado Pago API.
  • success: A boolean indicating whether the operation was successful (true).
  • timestamp: ISO 8601 timestamp of when the operation was performed.

Example output structure (simplified):

{
  "type": "payment_cancelled",
  "payment": {
    "id": "1234567890",
    "status": "cancelled",
    "...": "other payment details"
  },
  "success": true,
  "timestamp": "2024-06-01T12:00:00.000Z"
}

No binary data is output by this operation.

Dependencies

  • Requires an API authentication token credential for Mercado Pago MCP API.
  • Uses the Mercado Pago REST API endpoint https://api.mercadopago.com.
  • Requires proper configuration of the API credentials in n8n with access rights to cancel payments.

Troubleshooting

  • Missing or invalid payment ID: If the payment ID is not provided or incorrect, the API will return an error. Ensure the payment ID is valid and corresponds to an existing payment.
  • Authorization errors: If the API token is invalid or lacks permissions, the request will fail. Verify that the API key credential is correctly configured and has cancellation rights.
  • Network or API downtime: Temporary network issues or Mercado Pago API outages may cause failures. Retry after some time or check Mercado Pago status.
  • Idempotency key collisions: The node generates a unique idempotency key per request; however, if multiple identical requests are sent rapidly, unexpected behavior might occur. Usually, this is handled transparently.

Common error messages:

  • "Card token is required for card payments" — Not relevant for cancel operation but appears in other payment operations.
  • HTTP 401 Unauthorized — Check API credentials.
  • HTTP 404 Not Found — Payment ID does not exist.

Links and References

This summary focuses exclusively on the Payment - Cancel operation of the Mercado Pago MCP node based on static code analysis and provided property definitions.

Discussion