Skip to main content
In this guide you will implement real payments within a conversational app on WhatsApp using Mercado Pago.
Prerequisites:
  • A flow in Brain Studio ready (for example, an AI Agent handling a sale).
  • A Mercado Pago account with test and production credentials.
We will use a tour tickets app: the user picks a tour, date, quantity, and email; then you charge with Mercado Pago in the same flow. This tutorial has three parts:
  1. Implementation in test mode (Development)
  2. Testing on WhatsApp
  3. Go to production

1. Implementation in test mode (Development)

Video 1: Installation and configuration in Brain Studio

Video 1 – Mercado Pago installation + node setup in test mode

The video may show an older UI. For the current installation flow and node fields, use Connect in Brain Studio and Usage and configuration.

Install the integration and add the node

1

Get test credentials

Copy the Access Token from Test credentials in Mercado Pago.Follow Obtaining credentials if this is your first time.
Mercado Pago dashboard showing Your integrations and Test credentials

Your integrations in Mercado Pago

2

Connect Mercado Pago in Brain Studio

Install the integration with test credentials following Connect in Brain Studio.You can start from Marketplace, Jelou Agent, the Payments node in Canvas, or a template. The shared modal has four steps: environment, API Key, VAT/currency, and confirmation.
Connect Mercado Pago modal with API Key field

Modal step 2: enter your Mercado Pago API Key

3

Add the node to your flow

Add Mercado Pago from the Payments node in Canvas and connect it after the user confirms the purchase.Step-by-step detail in Usage and configuration — Add the node to Canvas.

Configure the node (tours example)

Complete the minimum for the tours case. Full field reference in Usage and configuration.
Mercado Pago node in Canvas with Payment data panel and node outputs visible

Mercado Pago node with Payment data tab and outputs on Canvas

In Development, the node environment reflects test credentials. Currency and VAT must match what you set when installing the integration.

Test emails by country (test mode)

In Development, Mercado Pago only processes payments if Buyer email belongs to a test user from the same country as your credentials.
If payment fails for no clear reason in Development, check the test email first.

Connect the node outputs

The node exposes five outputs. Connect them based on the result you want to handle. Detailed descriptions and a reference prompt for Payment message sent in Usage and configuration — Node outputs.
WhatsApp conversation with Mercado Pago button and support agent answering a question

Post-send payment button support example on WhatsApp

Example: normalize Successful payment

If you used Save response = checkout_response, map the minimum to Context:
normalize-payment.js
In a Text node connected to Successful payment, display:
Successful payment output connected to Code node then Text node

Successful payment → Code → Text flow


2. Testing on WhatsApp

Validate the end-to-end flow from WhatsApp; checkout opens in an embedded WebView.
Testing must be done from WhatsApp, not only from the Canvas preview.

Video 2: Testing from WhatsApp

Video 2 – Mobile test with test cards

1

Open Test in Canvas

In the top-right corner, click Test.
Test project panel with WhatsApp test option

Test project panel

2

Start a test conversation

Enter your number, send the first message, and complete the flow until the payment button.
3

Complete payment in the WebView

Open the payment button, use a test card for the corresponding country, and verify which output the flow continues through.
In some countries, the Mercado Pago app may try to open from the WebView. In Development, close it and return to WhatsApp to use the test card.

Test cards by country

Mercado Pago publishes test cards by country to simulate approval or rejection:
Test at least one approved and one rejected case to validate Successful payment and Failed payment.

3. Go to production

Going to production means production credentials and the buyer’s real data. The WhatsApp experience stays the same.

Video 3: Production setup + real payment

Video 3 – Go to production and real payment

For the current Go to production flow, follow Connect in Brain Studio.
1

Get production Access Token

In Mercado Pago, copy the Access Token from Production credentials.
2

Go to production

Start Go to production from the node’s Advanced tab in Canvas or from Mercado Pago in Marketplace.Enter the production Access Token and confirm VAT and currency.
3

Use real data in the node

Replace the test user in Buyer email with the real email captured in your flow.Verify Currency and VAT percentage remain consistent with the production installation.
4

Run a low-amount real payment test

Complete a real payment and confirm Successful payment, the operation number, and the record in your Mercado Pago dashboard.
Production transactions consume Brain Studio credits per attempt, in addition to provider fees.

Next steps

Usage and configuration

Complete sidepanel and node output reference.

Coverage and pricing

Countries, payment methods, and reference fees.

Other providers

Provider catalog by country.