Actions26
Overview
This node integrates with the Mercado Pago MCP Server to manage payments, specifically allowing you to create new payments among other payment-related operations. The "Payment - Create" operation enables you to initiate a payment transaction using various payment methods such as PIX, credit cards (Visa, Mastercard, American Express, Elo, Hipercard), boleto bancário, online debit, or Mercado Pago account balance.
Common scenarios where this node is beneficial include:
- E-commerce platforms processing customer payments.
- Subscription services charging customers via different payment methods.
- Marketplaces handling instant payments through PIX or credit card transactions.
Practical example: You can use this node to create a payment of R$100.50 for a product purchase, specifying the payment method as Visa credit card, providing the payer's email and the required card token, installments, and issuer ID.
Properties
| Name | Meaning |
|---|---|
| Valor | Payment amount in Brazilian reais (R$). |
| Descrição | Description of the payment (e.g., "Pagamento do produto X"). |
| Método de Pagamento | Payment method to use. Options: PIX, Cartão de Crédito Visa, Mastercard, American Express, Elo, Hipercard, Boleto Bancário, Débito Online Itaú, Saldo Mercado Pago. |
| Email do Pagador | Email address of the payer. |
| Token do Cartão | Card token required for credit/debit card payments (mandatory if payment method is a card). |
| Parcelas | Number of installments for card payments (mandatory if payment method is a card). |
| ID do Emissor | Issuer ID of the card (mandatory if payment method is a card). |
Output
The node outputs a JSON object containing the result of the payment creation request. The main output field is:
payment: An object representing the created payment details returned by Mercado Pago API.type: A string indicating the type of response, here"payment_created".success: Boolean indicating whether the operation was successful.timestamp: ISO timestamp of when the operation was performed.
If an error occurs, the output JSON will contain an error message, success set to false, and metadata about the resource and operation.
The node does not output binary data.
Dependencies
- Requires an API authentication token credential for Mercado Pago MCP API.
- Uses Axios HTTP client internally to make REST API calls to Mercado Pago endpoints.
- Requires proper configuration of the Mercado Pago API credentials within n8n.
Troubleshooting
- Missing Card Token or Issuer ID: For credit card payments, the node requires a valid card token and issuer ID. If these are missing, it throws an error indicating the missing fields.
- Invalid Payment Method: Selecting a payment method incompatible with provided parameters may cause errors.
- API Authentication Errors: Ensure the API key/token credential is correctly configured and has necessary permissions.
- Network or Endpoint Issues: Connectivity problems or incorrect endpoint URLs can cause request failures.
- Idempotency Key Conflicts: The node generates a unique idempotency key per request; repeated identical requests should be handled gracefully by the API.
To resolve errors, verify all required input properties are correctly filled, especially for card payments, and check your Mercado Pago API credentials and network connectivity.