# Checkout.com MCP for AI Agents AI Agent Connect

> Checkout.com MCP lets you manage your payment workflows through an AI agent. You can request and capture payments, handle refunds, and manage saved cards in your vault. It connects your account to any MCP-compatible client so you can handle billing tasks without switching tabs.

## Overview
- **Category:** money-moves
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_S3lDg6SN1hdkNWm91f9wcNYP96cnMkScbk1F3NW4/ai-agent-connect
- **Tags:** payment-vaulting, card-processing, transaction-management, fintech, api-payments

## Description

Connect your Checkout.com account to any AI agent and take full control of your payment workflows through natural conversation. Instead of hunting for a specific transaction in a list of thousands, you can just tell your agent to find a specific payment and issue a refund or void it. It handles the heavy lifting of interacting with the gateway while you stay focused on the actual work. If you're looking for a way to manage your global payments without the headache of constant tab-switching, this is the way to go. You can find this among the 4,000+ integrations in the Vinkius catalog, making it easy to plug into your existing workflow. It works for everything from testing new payment flows in a sandbox environment to auditing complex billing histories for your finance team. You get a direct line to your payment data without the friction of a manual UI.

## Tools

### request_payment
Identifies records inside the headless gateway to start a new request. Use this to initiate a new billing cycle.

### update_instrument
Traces and updates limits for a vault entry. Use this to change holder names or other metadata on a card.

### void_payment
Drops limits before a capture closes to cut out gateway fees. Use this to cancel a transaction before it settles.

### get_payment_actions
Enumerates the rules and states attached to a payment. It helps you see exactly why a transaction succeeded or failed.

### get_instrument
Identifies a specific active array in your vault logic. Use this to see the details of a saved card.

### refund_payment
Moves cash back to the original network. It handles the automated validation for routing clawback logic.

### capture_payment
Converts an authorized transaction into settled limits. It lets you finalize a payment once you're ready to take the money.

### create_instrument
Provisions a new payment method to your vault with a hard customer binding. Use this to save a new card for a returning user.

### delete_instrument
Irreversibly removes a payment method from your vault. This is useful for cleaning up old or compromised card data.

### get_payment_details
Extracts the properties driving an active billing record. It gives you a full look at the data behind a payment.

## Prompt Examples

**Prompt:** 
```
Refund payment pay_123 for $50.00
```

**Response:** 
```
### Refund Request

| Transaction ID | Amount | Status |
| :--- | :--- | :--- |
| pay_123 | $50.00 | **Success** |

**Details:**
* **Action:** Refund initiated
* **Source:** Original Visa Network
* **Status:** Moving back to originating account

The refund of $50.00 (5000 minor units) has been successfully initiated at the gateway.
```

**Prompt:** 
```
Show me why payment pay_456 failed
```

**Response:** 
```
### Payment Analysis: pay_456

**Status:** Declined
**Error Code:** `20059`
**Reason:** Insufficient Funds

**Analysis:**
* The authorization was declined by the issuing bank.
* The bank blocked the capture during the final settlement step.
* **Next Step:** You may want to suggest the customer check their balance or use a different card.
```

**Prompt:** 
```
Vault this instrument ID src_789 and update the holder name to 'John Doe'
```

**Response:** 
```
### Vault Update Successful

**Instrument ID:** `src_789`
**Updated Fields:**
* **Holder Name:** John Doe
* **Vault Status:** Active

This instrument is now updated in the vault. You can use it for future payment requests immediately.
```

## Capabilities

### Capture authorized payments
Converts a pending transaction into settled funds.

### Create payment instruments
Provisions new cards or payment methods to your vault.

### Delete instruments
Removes saved payment methods from your account.

### Track payment actions
Shows the history of what happened to a specific transaction.

### Fetch payment details
Pulls the full properties of an active billing record.

### Issue refunds
Sends money back to the original payment source.

### Request new payments
Identifies and initiates new payment records in the gateway.

### Void pending payments
Cancels a transaction before it settles to save on fees.

### Update vault instruments
Modifies the details of a saved payment method.

### List vault instruments
Shows all the cards and payment methods currently saved.

## Use Cases

### Refund a specific transaction
A support agent asks to refund a $50 charge. The AI uses the refund tool to move the money back to the original card.

### Vault a new card
A developer wants to save a test card. They tell the agent to use the creation tool to bind the card to a customer profile.

### Check why a payment failed
A customer complains about a declined card. The agent uses the actions tool to find the specific 'Insufficient Funds' error code.

### Void a pending order
An order is canceled before shipping. The agent uses the void tool to drop the limits and avoid extra processing fees.

## Benefits

- Stop jumping between tabs to issue refunds. Have your agent handle returns instantly from your primary workspace.
- Reduce manual data entry for new customers by automatically vaulting cards during the onboarding process.
- Cut unnecessary gateway fees by canceling transactions before they settle into finalized limits.
- Debug payment failures faster by pulling specific bank codes and rules that blocked a sale.
- Audit billing history in seconds by pulling full transaction properties without manual searching.

## How It Works

The bottom line is you get a conversational interface for your entire Checkout.com payment lifecycle.

1. Subscribe to the Connector and grab your Secret API Key from the Checkout.com dashboard.
2. Choose your environment (Sandbox or Live) and enter your credentials into your AI client.
3. Start asking your agent to perform actions like refunding a customer or checking a payment status.

## Frequently Asked Questions

**Can I use the Checkout.com MCP to issue refunds?**
Yes. You can ask your agent to issue refunds for specific transactions. It handles the automated validation and moves the money back to the original card or network automatically.

**How does the Checkout.com MCP handle saved cards?**
It connects directly to your vault. Your agent can create new payment instruments, update holder details, or delete old cards to keep your vault clean and secure.

**Can my agent see why a payment was declined?**
Yes. The Connector pulls the full action history for any payment. Your agent can tell you the specific reason for a failure, such as insufficient funds or bank blocks.

**Does the Checkout.com MCP support sandbox testing?**
Yes. You can configure the Connector to use your sandbox environment. This allows you to test payment flows and vaulting logic without processing real money.

**Can I use the Checkout.com MCP to cancel a pending payment?**
Yes. You can tell your agent to void a transaction that hasn't settled yet. This helps you cut out gateway fees for orders that need to be canceled.

**Is the Checkout.com MCP safe for handling customer card data?**
Yes. It interacts with the Checkout.com Vault, which is designed to store card data securely. Your agent manages the instructions, but the data stays in the secure vault.

**Can my agent help me debug why a payment failed?**
Yes. Ask your agent to get payment actions for a specific ID. It returns a detailed trace of everything that happened at the gateway level, identifying exactly why an authorization fell through, from CVV checks to insufficient funds.

**Is it safe to manage card instruments via the AI agent?**
Absolutely. The server uses Checkout.com's native Vault logic. Sensitive PANs are wrapped safely, and your API keys are encrypted at rest. The agent only interacts with tokens or vaulted IDs, maintaining high security standards.

**Can I test this in sandbox before going live?**
Yes. Simply choose the 'Sandbox' environment during setup and use your sandbox secret key (`sk_sbox_...`). This allows you to simulate transactions and vaulting logic without processing real money.