• SUCCESS
  • PARTIAL
  • ERROR
  • HUMAN

How to refund customer transactions with your AI

Connect Braintree to your AI client to manage payments. Once connected, you can find orders and process refunds through chat.

Ask AI about this page

Short answer

How can I refund a Braintree transaction using AI?

Your AI client uses the Braintree MCP to find specific transaction IDs and trigger refunds. You can request a full amount or a specific partial amount. Here is how it works.

Refund outcomes.

Where the money goes.

The AI handles the gateway commands, resulting in one of these four states.

SUCCESS

Full refund complete

The AI processes the full amount in Braintree. You get a confirmation that the transaction was reversed.

PARTIAL

Partial refund issued

The AI applies a specific partial amount to the original payment. You'll see the updated transaction status.

ERROR

Gateway rejection

If Braintree denies the request, the AI reports the error. You'll know exactly why the refund failed.

HUMAN

Manual intervention

If the AI can't find the record or lacks permission, it stops. You'll need to check the gateway manually.

The workflow

What your AI does when the request arrives.

The AI moves from finding the record to executing the refund command.

  1. Find the order

    The AI scans your Braintree history to find the specific transaction you're looking for.

    search_transactions
  2. Verify the amount

    The AI pulls the specific record to confirm the transaction ID and the original payment amount.

    get_transaction
  3. Process the refund

    The AI sends the instruction to Braintree to return the funds to the customer.

    refund_transaction
  4. Check the result

    The AI pulls the updated transaction data to confirm the refund was successful.

    get_transaction

Try it

Copy these to start.

Use these prompts to trigger actions in Braintree.

Starting points

Swap the bracketed details with your actual customer or transaction info.

Braintree Connector

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

Connector linkhttps://edge.vinkius.com/vk_preview_OrZt8at3Cszx0AC8W3EGzjx9G5lNeLsiQeo0EYE6/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 — Braintree capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "braintree-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_OrZt8at3Cszx0AC8W3EGzjx9G5lNeLsiQeo0EYE6/mcp"
    }
  }
}
Copy into chat04
  • Find the transaction for the customer who bought the blue widget yesterday.

  • Refund the full amount for transaction ID 12345.

  • I need to issue a partial refund of $20.00 for the last order from Jane Doe.

  • Show me the details for the transaction made by user_99.

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

Start here

Connect Braintree once, then ask.

Link your Braintree account to Vinkius. Your credentials stay encrypted, and you can start managing payments immediately.

Connect Braintree to your AI

FAQ

How this task behaves.

  • 01

    Can the AI refund a transaction without me seeing it first?

    No. The AI will show you the transaction details it found so you can confirm it's the right one before it issues a refund.

  • 02

    Can the AI delete a transaction from my Braintree history?

    No. The AI can only search for, view, or refund transactions. It cannot delete records.

  • 03

    Does the AI handle the actual money transfer?

    The AI tells Braintree to move the money. The actual movement of funds happens within the Braintree gateway.

  • 04

    Can I refund a transaction if I don't have the ID?

    Yes. If you provide a name or date, the AI can use search tools to find the ID for you.

  • 05

    Will the AI automatically refund every disputed charge?

    No. The AI only performs actions when you explicitly ask it to in the chat.

  • More questions about Braintree? See everything the Braintree Connector can do

Connect Braintree to Claude, Cursor, ChatGPT & more