• SUCCESS
  • PARTIAL
  • MANUAL
  • ERROR

How to issue transaction refunds with your AI

Connect PagBank PagSeguro to your AI client to manage payments. You can locate specific orders and process refunds through a simple chat interface.

Ask AI about this page

Short answer

How do I issue transaction refunds with my AI?

Your AI uses PagBank PagSeguro tools to find the exact transaction you need and then executes the refund command. You can handle both full and partial amounts by simply telling your agent what to do. You'll see the specific outcomes below.

Refund outcomes

Where every refund lands.

Depending on your request, the AI handles the heavy lifting or flags the task for you.

SUCCESS

Refund processed

The AI finds the transaction and executes the refund. You get confirmation that the money is headed back to the customer.

PARTIAL

Partial refund issued

The AI calculates the specific amount you requested and applies it to the original transaction.

MANUAL

Human intervention needed

If the transaction details are missing or the amount is invalid, the AI will stop and ask you for more info.

ERROR

Transaction failed

The AI reports if the PagBank API rejects the refund request due to expired windows or insufficient funds.

The workflow

What your AI does when a refund is requested.

The AI acts as the bridge between your chat window and the PagBank PagSeguro API.

  1. Locate the payment

    The AI searches your PagBank history to find the specific transaction ID or customer details you mentioned.

    get_transaction

  2. Verify details

    It checks the transaction status and original value to ensure a refund is actually possible.

    get_transaction

  3. Execute refund

    Once you confirm, the AI sends the command to PagBank to reverse the charge.

    cancel_transaction

  4. Confirm result

    The AI checks the final status of the request and tells you if the refund succeeded.

    get_transaction

Try it

Copy these to start.

Use these prompts to kick off the process.

Starting points

Swap out the bracketed info with your actual transaction IDs or customer names.

PagBank Connector

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

Connector linkhttps://edge.vinkius.com/vk_preview_ZCq17XG8di75boT0jalqKlUdU9DfTwvfnH4kvetn/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 — PagBank capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "pagbank-pagseguro-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_ZCq17XG8di75boT0jalqKlUdU9DfTwvfnH4kvetn/mcp"
    }
  }
}
Copy into chat04

  • Find the transaction for the customer who bought the blue widget yesterday.

  • Issue a full refund for transaction ID 987654321.

  • I need to do a partial refund of 25.00 for the last order from Maria Silva.

  • Check the status of the refund I just requested for order #12345.

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

Start here

Connect PagBank PagSeguro once, then ask.

Log in once to link your account. Your credentials stay encrypted, and you can immediately start managing payments through your preferred AI client.

Connect PagBank PagSeguro to your AI

FAQ

How this task behaves

  • 01

    Can the AI create new transactions?

    No. The AI can only find existing transactions or issue refunds for them.

  • 02

    Can the AI delete my entire transaction history?

    No. The AI only has permission to interact with specific transactions you request.

  • 03

    Does the AI handle the actual money transfer?

    No. The AI triggers the command through PagBank, which then handles the actual movement of funds.

  • 04

    Can I do partial refunds?

    Yes. You can tell the AI exactly how much to refund from the original total.

  • 05

    What happens if the transaction ID is wrong?

    The AI will tell you it couldn't find a match and ask you to provide the correct ID.

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

Connect PagBank to Claude, Cursor, ChatGPT & more