Overview
This node integrates with the Mercado Pago API to manage payment preferences and payments. Specifically, for the Preference - Get operation, it retrieves detailed information about a specific payment preference by its ID. This is useful when you want to fetch the current configuration or status of a checkout preference previously created in Mercado Pago.
Common scenarios include:
- Retrieving details of a saved payment preference to display or verify before processing payments.
- Checking the items, amounts, and settings associated with a checkout preference.
- Using the preference data to update UI elements or trigger further workflows based on the preference state.
Example: You have created a payment preference for a shopping cart checkout and want to retrieve its details later to confirm the items and prices before finalizing the transaction.
Properties
| Name | Meaning |
|---|---|
| Preference ID | The unique identifier of the payment preference to retrieve. It is required to specify which preference to get. |
Output
The output is a JSON object representing the full details of the requested payment preference as returned by the Mercado Pago API. This typically includes:
id: The preference ID.items: An array of items included in the preference, each with properties like title, description, quantity, unit price, currency, etc.- Other metadata related to the checkout preference such as payer info, back URLs, payment methods allowed, expiration, and more depending on the Mercado Pago API response.
No binary data is output by this operation.
Dependencies
- Requires an active Mercado Pago API credential configured in n8n for authentication.
- The node makes HTTP requests to the Mercado Pago API endpoint at
https://api.mercadopago.com. - Proper API permissions are needed to read payment preferences.
Troubleshooting
- Missing Preference ID: If the "Preference ID" property is empty or invalid, the node will throw an error indicating that the Preference ID is required. Ensure you provide a valid ID.
- API Authentication Errors: If the API key or credentials are incorrect or expired, the request will fail. Verify your Mercado Pago API credentials in n8n.
- Network Issues: Connectivity problems can cause request failures. Check network access and Mercado Pago service status.
- Invalid Preference ID: If the provided ID does not exist or is malformed, the API will return an error. Confirm the ID is correct.