• SUCCESS
  • ERROR
  • MANUAL
  • LOG

How to refund or void payments with your AI

Connect Checkout.com to your agent to handle transaction reversals. Once connected, you can manage specific payments through simple chat commands.

Ask AI about this page

Short answer

How can I refund or void a payment with my AI?

Tell your agent to refund a transaction ID or void an authorization. The AI executes the request via Checkout.com and gives you the result. You'll see exactly how the transaction status changes.

The outcomes

What happens after you ask

Your agent handles the API calls to change the transaction state.

SUCCESS

Payment reversed

The AI confirms the refund or void was successful. You get a direct confirmation of the new transaction status.

ERROR

Request failed

If the ID is wrong or the funds aren't there, the AI reports the specific error from Checkout.com.

MANUAL

Human intervention

If a transaction is too large or hits a restriction, the AI stops and asks you to finish it in the dashboard.

LOG

Action recorded

The AI provides a summary of the transaction ID and the outcome of the command.

The workflow

What your AI does when the request arrives.

Your agent translates your text into specific payment instructions.

  1. Identify the payment

    The AI parses your message to find the specific transaction ID or payment details you want to change.

    refund_checkout_paymentvoid_checkout_payment

  2. Cancel the hold

    If the funds haven't been captured, the AI cancels the authorization to release the hold.

    void_checkout_payment

  3. Return the funds

    For settled payments, the AI sends the instruction to return the money to the customer.

    refund_checkout_payment

  4. Verify the result

    The AI checks the response from the API to ensure the refund or void went through.

    refund_checkout_paymentvoid_checkout_payment

Try it

Copy these to start.

Use these prompts to trigger actions immediately.

Starting points

Replace the transaction IDs and amounts with your actual data.

Checkout.com Connector

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

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

  • Refund the payment with ID ch_98765.

  • Void the authorization for transaction ch_12345.

  • Can you refund the $45.00 charge for customer_882?

  • Void the most recent authorization on this account.

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

Start here

Connect Checkout.com once, then ask.

One connection lets your agent act on your payments. Your credentials stay encrypted on our side.

Connect Checkout.com to your AI

FAQ

How this task behaves

  • 01

    Can my AI create new payments?

    No. This connector only handles refunds and voids.

  • 02

    Can the AI delete transaction records?

    No. The AI can only change the status of a transaction; it cannot delete any data from Checkout.com.

  • 03

    Does the AI need my login password?

    No. You connect the MCP through Vinkius, which manages the secure connection for your agent.

  • 04

    Can the AI perform partial refunds?

    Yes, if you specify the amount in your prompt, the AI will attempt to refund that specific value.

  • 05

    Will the AI automatically refund every failed payment?

    No. The AI only acts when you explicitly tell it to refund or void a specific transaction.

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

Connect Checkout.com to Claude, Cursor, ChatGPT & more