# Adyen MCP for AI Agents AI Agent Connect

> Adyen MCP. Manage global payments, refunds, and merchant accounts through your AI agent. Connect your Adyen account to handle transaction statuses, initiate refunds, and audit merchant configurations without switching tabs.

## Overview
- **Category:** money-moves
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_zScRJhqip75HtmgQig7tUomB26biMaChLQtSMGaJ/ai-agent-connect
- **Tags:** global-payments, transaction-monitoring, refund-management, merchant-accounts, financial-orchestration, payment-gateway

## Description

Connecting your Adyen account to your agent means you can finally stop jumping between your payment gateway dashboard and your communication tools. Instead of hunting for a specific PSP reference or manually checking if a refund hit the right account, you just ask your agent to do it. You can pull up full authorization details, see which regions have specific payment methods enabled, or audit your merchant accounts to make sure everything is configured correctly for a new launch. It handles the heavy lifting of payment orchestration so you can stay focused on the actual business. Since Vinkius hosts this Connector, you can plug it into your existing workflow and get these capabilities instantly. It's about having a direct line to your financial data where you need it most, whether that's checking a failed transaction or verifying a merchant's technical status.

Think about the time spent digging through nested menus to find a single transaction ID. With this Connector, that search is replaced by a single sentence. Your agent can scan your accounts, identify the specific payment you need, and summarize the status for you. This works for managing multi-region merchant profiles too. You can verify that your technical configurations are correct across different jurisdictions without manually checking every single account page. It turns a series of tedious clicks into a conversation, making it much easier to maintain a clean and accurate financial operation.

## Tools

### refund_payment
Initiate a full or partial refund for a captured payment using the original PSP reference.

### get_payment_details
Get full authorization and capture metadata for a specific payment using its 16-digit PSP reference.

### list_merchants
Retrieve all active merchant accounts associated with your Adyen company profile.

### get_merchant_details
Pull the technical configuration and status for a specific merchant account.

## Prompt Examples

**Prompt:** 
```
Check the status of payment with PSP reference '8816123456789012'.
```

**Response:** 
```
I've retrieved the details for PSP reference 8816123456789012. The payment was successfully **Captured** on March 30th for an amount of **$50.00**. 

**Transaction Summary:**
- **Status:** Captured
- **Date:** March 30, 2024
- **Amount:** $50.00
- **Reference:** 8816123456789012

Would you like to see the settlement details?
```

**Prompt:** 
```
Refund $25.00 for PSP reference '8516123456789012'.
```

**Response:** 
```
I've initiated a partial refund of **$25.00** for PSP reference 8516123456789012. 

**Status Update:**
- **Request:** Initiated
- **Amount:** $25.00
- **Current State:** Received

The request has been received by Adyen. You will be notified via webhook once it is processed.
```

**Prompt:** 
```
List all my active merchant accounts.
```

**Response:** 
```
I've retrieved your merchant accounts. You have **3 active accounts**: 

1. **EcomStore_US**
2. **EcomStore_EU**
3. **RetailPOS_UK**

Would you like to check the available payment methods for any of them?
```

## Capabilities

### Retrieve payment metadata
Get full authorization and capture details for any specific payment using its reference ID.

### Process partial and full refunds
Initiate refund requests directly from your chat interface without opening the merchant portal.

### Audit merchant accounts
List all active merchant profiles and check their specific technical configurations.

### Verify regional payment methods
Check which payment options are available for specific currencies and geographic locations.

### Monitor transaction trends
Identify patterns in your payment flow and reconciliation data through natural language.

## Use Cases

### Instant refund processing for support tickets
A customer says their refund hasn't arrived. Your agent uses `refund_payment` to initiate it immediately and confirm the status.

### Verifying regional payment availability
You're launching in Brazil and need to know what options customers have. Your agent checks available payment methods for that region.

### Global merchant account auditing
You need to verify your technical setup across 10 countries. Your agent uses `list_merchants` to find every active account.

### Technical metadata inspection for developers
You're testing a new checkout flow. Your agent pulls `get_payment_details` to verify the technical metadata for every successful capture.

## Benefits

- Faster refunds: Use `refund_payment` to handle customer requests in seconds instead of logging into a dashboard.
- Better visibility: Use `get_payment_details` to see exactly why a transaction was refused.
- Easier auditing: Use `list_merchants` and `get_merchant_details` to keep your global accounts organized.
- Regional accuracy: Check available payment methods for specific currencies and countries instantly.
- Reduced friction: Give your support team a way to look up transaction history without needing admin access to the full portal.

## How It Works

The bottom line is you get direct control over your Adyen payment flow through a simple chat interface.

1. Subscribe to the Adyen MCP on the Vinkius Marketplace.
2. Enter your Adyen API Key and Merchant Account ID in the configuration.
3. Ask your agent to pull payment details, list merchants, or initiate refunds.

## Frequently Asked Questions

**Can the Adyen MCP process refunds for me?**
Yes, you can initiate both full and partial refunds directly through your agent. Just provide the correct payment reference, and the Connector handles the request with Adyen.

**How do I connect the Adyen MCP to my AI client?**
Once you subscribe on Vinkius, you'll just need to provide your Adyen API Key and Merchant Account ID. Your agent can then access your payment data immediately.

**Can I use this to check if a payment was successful?**
Absolutely. You can ask your agent to pull the full authorization and capture metadata for any specific payment using its reference number.

**Does the Adyen MCP support multiple merchant accounts?**
Yes, it can list all active merchant accounts associated with your company profile and pull technical details for any specific one.

**Can I use the Adyen MCP to see what payment methods are available in other countries?**
Yes, you can ask your agent to verify available payment methods for specific regions and currencies to help with your international expansion.

**Is the Adyen MCP safe for my financial data?**
The Connector acts as a bridge between your agent and your Adyen account. It only performs the actions you specifically request through your conversation.

**How do I find my Adyen API Key?**
Log in to your Adyen Customer Area, go to **Developers** > **API credentials**, and select your web service user (ws@Company.YourCompany). You can generate and copy your API key from the 'Authentication' section.

**Can I process a refund via the agent?**
Yes! Use the `refund_payment` tool and provide the original PSP reference and the amount. Your agent will submit the refund request to Adyen for processing.

**Does this support checking payment statuses?**
Yes, the `get_payment_details` tool allows you to retrieve the full technical response for any PSP reference, including authorization codes and refusal reasons.