Actions26
Overview
The node integrates with the Mercado Pago MCP Server to manage orders and their transactions. Specifically, for the Order - Add Transaction operation, it allows users to add a new payment transaction to an existing order in Mercado Pago. This is useful when you want to record additional payments or partial payments against an order after its creation.
Common scenarios include:
- Adding a supplementary payment to an order that was partially paid.
- Recording multiple payment methods or installments for a single order.
- Managing complex payment flows where transactions are added incrementally.
Example: You have an order with ID 12345678 and want to add a transaction of R$100.50 paid via Visa by the payer with email pagador@exemplo.com. This node operation will create that transaction linked to the specified order.
Properties
| Name | Meaning |
|---|---|
| ID do Pedido | The unique identifier of the order to which the transaction will be added. |
| Valor da Transação | The amount of the transaction in Brazilian Reais (R$). |
| Descrição | Description of the transaction or order payment (e.g., "Pagamento do pedido"). |
| ID do Método de Pagamento | Identifier of the payment method used (e.g., visa, pix, master). |
| Email do Pagador | Email address of the payer making the transaction. |
Output
The output JSON contains details about the newly added transaction within the order context. It includes:
type: A string indicating the operation type, here"transaction_added".order: An object representing the updated order data returned from Mercado Pago API after adding the transaction.success: Boolean indicating if the operation succeeded (true).timestamp: ISO timestamp of when the operation was performed.
No binary data is output by this operation.
Dependencies
- Requires an active connection to Mercado Pago MCP API using an API key credential with appropriate permissions.
- The node uses Axios HTTP client internally to communicate with Mercado Pago endpoints.
- Proper configuration of the API authentication token is necessary in n8n credentials.
Troubleshooting
- Missing or invalid API credentials: The node requires a valid access token to authenticate requests. Ensure the API key credential is correctly configured.
- Invalid order ID: If the provided order ID does not exist or is incorrect, the API will return an error. Verify the order ID before running the node.
- Invalid payment method ID: The payment method must be recognized by Mercado Pago. Use valid IDs such as "visa", "pix", etc.
- Incorrect email format: The payer's email should be a valid email address; otherwise, the API may reject the request.
- Network issues or API downtime: Temporary connectivity problems can cause failures. Retry later or check network status.
Common error messages:
"Card token is required for card payments"— Not applicable here since this operation does not require card tokens.- HTTP 4xx or 5xx errors from Mercado Pago API — Check the error message for details and adjust parameters accordingly.
Links and References
This summary focuses exclusively on the Order - Add Transaction operation as requested.