Skip to main content
Once the integration is connected in Marketplace, the Mercado Pago node becomes available in your workspace for use inside your flows. This guide shows you how to add it to the Canvas and how to configure its inputs and outputs.
First time implementing a charge? Follow the Tutorial: Implementing your first charge from WhatsApp guide first, which takes you step by step from zero to production.

​
Add the node to the Canvas

1

Locate the integration in Marketplace

In the left sidebar of Brain Studio, open the Marketplace folder.If the integration is correctly connected, you will see Mercado Pago listed as an available provider.
Mercado Pago visible in the Marketplace folder inside the Brain Studio sidebar
2

Drag the node to the Canvas

Drag Mercado Pago from the sidebar into your flow on the Canvas.When you drop it, the node block will be created with its available outputs.
Mercado Pago node added to the Canvas showing its outputs
3

Open the configuration panel

Select the node on the Canvas to open its configuration panel on the right side.From there you can complete the inputs and review the available outputs.

​
Configure the node in Canvas

​
Save result as
string
Defines the name of the variable where Brain Studio will store the complete JSON response from the node.
Useful if you want to use the response later (logs, validations, traceability, or flow decisions).
​
Payment type
string
default:"payment"
Defines the type of charge.Available values: payment (one-time payment), subscription (subscription)
If nothing is selected, payment will be used.
​
Environment
string
required
Defines the execution environment for the payment.Available values: Test, Production
Must match the Access Token you connected in Marketplace (Test vs Production).
​
Payment button expiration [minutes]
number
Defines how long the payment button is valid from the moment it is sent to the user.Available values: 10, 20, 30, 60
​
Currency
string
required
Currency for the charge.
The available currency depends on the country of the connected Mercado Pago account or credentials.
​
Payment reason
string
required
Descriptive text for the charge (for example, order number or product/service description).
Ideally use it with flow variables so it aligns with the conversation context.
​
Payment metadata
string
Additional information for traceability or internal reference.
You can use it for correlation with your order, reconciliation, or payment audit.
​
Buyer email
string
required
The buyer’s email. It must have been collected previously in the flow and passed here as a variable.
​
Customize payment button text
boolean
default:"false"
If you select Yes, additional fields are enabled to customize the message that accompanies the payment button.Fields enabled when activated:
  • Header (required)
  • Body (required)
  • Footer (required)
When this option is active, you can fully modify the message the user will see before opening the checkout.
Example message with customized texts and Mercado Pago payment button in WhatsApp
​
Header
string
Title of the message that accompanies the payment button.
​
Body
string
Main text of the message that accompanies the payment button.