# Checkout.com MCP for AI Agents AI Agent Connect

> Checkout.com MCP lets you manage global payments through your AI agent. It handles transaction tracking, refunds, and account health monitoring across 150+ currencies. Use it to capture payments, void authorizations, and audit lifecycle actions without leaving your workspace.

## Overview
- **Category:** money-moves
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_P2FKAMdOfRiRoGQiYF0jhCi2zDyjY2U2VVETlo6p/ai-agent-connect
- **Tags:** global-payments, transaction-processing, refunds, payment-gateway, currency-management

## Description

Imagine you're dealing with a mountain of global payment data. Usually, this means jumping between tabs, hunting for transaction IDs, and manually triggering refunds in a complex dashboard. With this Connector, you just tell your AI agent what needs to happen. It pulls the data you need and takes action across your Checkout.com account instantly. Whether you're checking if a specific payment went through or need to process a refund for a frustrated customer, the agent handles the heavy lifting. You can see the full history of any payment action or check your webhook configurations to make sure your systems are talking to each other correctly. It's about moving from searching for data to getting things done. By adding this to your toolkit via the Vinkius Marketplace, you turn a manual administrative chore into a conversation. You get high-accuracy handling for minor units, so the math always adds up, and you can keep your focus on the actual business instead of the plumbing of payment processing.

## Tools

### capture_checkout_payment
Capture an authorized payment to finalize a transaction. It's useful for completing sales once a customer confirms.

### list_checkout_webhooks
List configured webhooks. Use this to ensure your external systems are receiving real-time payment updates.

### get_checkout_account_info
Retrieve core account and user information. Use this to quickly check your global settings.

### list_payment_actions
List all lifecycle actions for a specific payment. This helps you see exactly what happened to a transaction over time.

### get_payment_details
Get detailed information for a specific payment. This is perfect for deep-diving into a single transaction's data.

### list_checkout_payments
List recent payments. Use this to get a quick overview of your latest successful and pending transactions.

### refund_checkout_payment
Refund a captured payment. This lets you return money to customers through a simple chat command.

### void_checkout_payment
Void an authorized payment. Use this to cancel a pending charge before it's actually captured.

## Prompt Examples

**Prompt:** 
```
Find the last 3 payments I made and tell me if they were captured.
```

**Response:** 
```
### Recent Payments
| Order ID | Amount | Status |
| :--- | :--- | :--- |
| #ABC123 | $120.00 | **Captured** |
| #DEF456 | $45.50 | **Authorized** |
| #GHI789 | $12.00 | **Captured** |

I found 3 recent payments. Two are captured, and one is still authorized.
```

**Prompt:** 
```
I need to refund payment pay_998877. Can you do that?
```

**Response:** 
```
I've initiated a refund for payment **pay_998877**. The request was successful, and the status will update in your dashboard shortly.
```

**Prompt:** 
```
Are my webhooks set up correctly?
```

**Response:** 
```
I checked your webhooks. You have **3 active webhooks** configured for payments and disputes. All appear to be active and ready to send data.
```

## Capabilities

### Capture authorized payments
Turn a pending authorization into a completed transaction instantly.

### Refund captured payments
Send money back to customers through simple voice or text commands.

### Void authorizations
Cancel a pending payment before it's captured to keep your records clean.

### Audit payment histories
See every lifecycle change for a specific transaction in one view.

### Monitor webhook health
Check your integration's connectivity to ensure real-time updates are working.

### Retrieve account metadata
Get your core account settings and user info without logging into the portal.

## Use Cases

### Refund a specific order
A customer says they were overcharged. You ask the agent to find the payment and use refund_checkout_payment to fix it.

### Verify webhook status
You're building a new integration and need to know if the data is flowing. You use list_checkout_webhooks to check the status.

### Audit a failed transaction
A high-value sale is stuck. You use list_payment_actions to see the exact lifecycle history and identify the bottleneck.

### Capture a pending sale
A customer authorizes a payment but hasn't shipped yet. You use capture_checkout_payment once the item leaves the warehouse.

## Benefits

- Stop jumping between tabs to find transaction IDs with list_checkout_payments. You get a live view of your recent sales right in your chat.
- Handle customer complaints faster by using refund_checkout_payment to send money back to customers in seconds.
- Prevent double-charging or errors by quickly canceling pending orders with void_checkout_payment.
- Audit every step of a transaction's life using list_payment_actions to see exactly when a payment was authorized or captured.
- Keep your technical stack healthy by using list_checkout_webhooks to verify that your system is receiving all the data it needs.
- Access your core account settings instantly with get_checkout_account_info instead of hunting through a complex dashboard.

## How It Works

The bottom line is you get a direct command line for your global payment operations inside your existing AI workspace.

1. Subscribe to the Connector and provide your Checkout.com Secret Key and API Prefix.
2. Connect the Connector to your preferred client like Claude or Cursor.
3. Ask your agent to list payments, process refunds, or check webhook statuses.

## Frequently Asked Questions

**Can I use the Checkout.com MCP to process refunds?**
Yes, you can use the Connector to request refunds for captured payments through your AI agent. It handles the communication with the gateway so you don't have to log into the dashboard.

**How many currencies can the Checkout.com MCP handle?**
It supports transactions across 150+ currencies. Your agent will handle the minor unit math to ensure your financial data stays accurate.

**Can I check my webhook status with the Checkout.com MCP?**
Yes, you can list and review your configured webhooks. This is great for making sure your external apps are receiving the real-time data they need.

**Is the Checkout.com MCP safe for handling payments?**
This Connector uses your existing Checkout.com Secret Key and API Prefix. It follows the same security protocols as the official Unified API to manage your transactions.

**What happens when I ask my agent to void a payment?**
The Connector will call the void function to cancel an authorized but uncaptured payment. This clears the hold on your customer's funds immediately.

**Can I see the history of a specific transaction?**
Yes, you can ask the agent to list all lifecycle actions for a specific payment ID. It will return a chronological list of every action taken on that payment.

**Can I process a refund for a payment ID through the agent?**
Yes! Use the `refund_checkout_payment` tool with the payment ID. You can also specify an optional amount in minor units for a partial refund. The agent will trigger the refund process in Checkout.com immediately.

**How do I see the full history of actions for a payment?**
Use the `list_payment_actions` tool with the unique payment ID. Your agent will fetch all lifecycle events, such as Authorization, Capture, and Refund, along with their timestamps.

**Where do I find my API Prefix?**
The API Prefix is the first 8 characters of your client_id (excluding the cli_ prefix). You can also find it in your Checkout.com Hub under Developers -> API Keys.