• SUCCESS
  • PARTIAL
  • ERROR
  • HUMAN

How to process customer refunds with your AI

Connect Mercado Pago to your AI client once. After that, you can manage transaction reversals through simple text commands.

Ask AI about this page

Short answer

How can I issue refunds using my AI?

You tell your AI which transaction needs a refund and how much to return. The AI then executes the reversal through Mercado Pago. You'll see the specific outcomes for each request below.

Refund outcomes

Where every refund lands.

What happens after you send the command.

SUCCESS

Transaction reversed

The AI completes the refund via Mercado Pago. You get a confirmation that the money is headed back to the customer.

PARTIAL

Partial amount returned

The AI processes a refund for only a portion of the original charge. This is useful for shipping adjustments or service credits.

ERROR

Request failed

If the transaction ID is wrong or the amount exceeds the original payment, the AI reports the specific error from Mercado Pago.

HUMAN

Manual review needed

If the AI cannot verify the transaction details, it will flag the issue for you to handle in your Mercado Pago dashboard.

The workflow

What your AI does when the request arrives.

The AI handles the heavy lifting of communicating with the payment gateway.

  1. Identify the payment

    Your AI looks up the specific transaction details in Mercado Pago to ensure the ID and amount are valid.

    refund_payment

  2. Calculate the refund

    The AI determines if you are requesting a full reversal or a specific partial amount based on your instructions.

    refund_payment

  3. Execute the reversal

    The AI sends the instruction to the payment gateway to move the funds.

    refund_payment

  4. Confirm status

    The AI checks the result of the operation and tells you if the refund was successful or why it failed.

    refund_payment

Try it

Copy these to start.

Use these prompts to trigger the refund process.

Starting points

Replace the transaction IDs and amounts with your actual data from your sales logs.

Mercado Pago Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_Mx4Sw13BkVSyvhTG9vcHJTm07zdH5PNyBe4399ul/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Mercado Pago capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "mercado-pago-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_Mx4Sw13BkVSyvhTG9vcHJTm07zdH5PNyBe4399ul/mcp"
    }
  }
}
Copy into chat04

  • Refund the full amount for transaction ID 987654321.

  • Issue a partial refund of 15.50 for payment ID 123456789.

  • Can you check if transaction 554433221 is eligible for a refund?

  • Refund the customer for transaction 998877665, but only for half the total.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Mercado Pago once, then ask.

Link your account in one click. Your credentials stay encrypted and secure, and you can start managing payments immediately.

Connect Mercado Pago to your AI

FAQ

How this task behaves

  • 01

    Can the AI refund more than the original transaction amount?

    No. The AI cannot issue a refund that exceeds the original payment amount.

  • 02

    Does the AI have permission to delete transactions?

    No. The AI can only issue refunds through the available tools; it cannot delete or modify transaction history.

  • 03

    Can I do partial refunds?

    Yes. You can instruct the AI to refund a specific amount rather than the full total.

  • 04

    What happens if the transaction ID is invalid?

    The AI will tell you it couldn't find that transaction and won't attempt to process a refund.

  • 05

    Does the AI handle the actual money transfer?

    The AI triggers the instruction through Mercado Pago, which then handles the actual movement of funds.

  • More questions about Mercado Pago? The Connector page answers them. See everything the Mercado Pago Connector can do

Connect Mercado Pago to Claude, Cursor, ChatGPT & more