Actions26
Overview
This node integrates with the Mercado Pago MCP Server to manage payments, specifically allowing you to create new payments. It supports various payment methods including PIX, credit cards (Visa, Mastercard, American Express, Elo, Hipercard), boleto bancário, online debit, and Mercado Pago account balance.
Typical use cases include:
- Automating payment processing in e-commerce workflows.
- Creating instant payments via PIX or credit card tokens.
- Handling boleto or online debit payments.
- Integrating Mercado Pago payments into custom business processes.
For example, you can create a payment for an order by specifying the amount, description, payer's email, and payment method. If using credit cards, you provide additional details like 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 credit card). |
| Parcelas | Number of installments for credit card payments (mandatory if payment method is a credit card). |
| ID do Emissor | Issuer ID of the card (mandatory if payment method is a credit card). |
Output
The node outputs JSON data containing the result of the payment creation request. The output includes:
type: A string indicating the operation type, here"payment_created".payment: An object with detailed information about the created payment as returned by Mercado Pago API.success: Boolean indicating if the operation was successful (true).timestamp: ISO timestamp of when the operation was performed.
If the payment method is a credit card, the output reflects the processed payment with card details. For other methods, it contains relevant payment confirmation data.
No binary data output is produced by this node.
Dependencies
- Requires an API key credential for Mercado Pago MCP API with appropriate permissions.
- Uses Axios HTTP client internally to communicate with Mercado Pago endpoints.
- Needs network access to Mercado Pago API endpoints (
https://api.mercadopago.com).
Troubleshooting
- Missing Card Token or Issuer ID: When using credit card payment methods, the node requires a valid card token and issuer ID. Omitting these will cause an error: "Card token is required for card payments" or "Issuer ID is required for card payments". Ensure these fields are provided.
- Invalid Payment Method: Selecting a payment method not supported or incorrectly configured may lead to API errors.
- API Authentication Errors: If the API key credential is invalid or expired, requests will fail with authorization errors. Verify the credential configuration.
- Network Issues: Connectivity problems to Mercado Pago API endpoints will cause request failures.
- Idempotency Key Conflicts: The node generates a unique idempotency key per request to avoid duplicate payments; however, if reused improperly, it might cause conflicts.