# Worldpay MCP for AI Agents AI Agent Connect

> Worldpay MCP lets you manage global payment operations through your AI agent. It handles payment orders, refunds, and settlement audits without you having to click through complex banking dashboards. It's built for high-volume transaction management and secure tokenization.

## Overview
- **Category:** money-moves
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/undefined/ai-agent-connect
- **Tags:** omnichannel-payments, refunds, transaction-processing, payment-tokens, settlements, financial-audit

## Description

This Connector gives your AI agent direct access to your Worldpay account so you can run payment operations through a simple conversation. Instead of jumping between tabs to verify a transaction or manually entering refund amounts, you just tell your agent what needs to happen. It handles the heavy lifting of creating payment orders, managing reusable tokens, and pulling settlement details for your end-of-day reconciliations. You can also check your webhook configurations to make sure your real-time notifications are actually hitting your endpoints. Because Vinkius hosts this Connector, it's ready to plug into your existing workflow immediately. It turns your AI client into a payment operations coordinator that knows your order codes, token IDs, and settlement batches by heart. You no longer have to deal with the friction of navigating complex banking portals just to confirm a single payment or audit a batch of funds. Whether you are handling a high volume of customer refunds or just need to verify that your payment gateway is reachable, your agent does the work for you. This means your team can spend less time on data entry and more time on actual business growth. It's about making your financial backend as responsive as your front-end experience.

## Tools

### list_payment_settlements
List all funds that have settled into your account. This makes it easy to see your recent deposits.

### list_webhook_endpoints
See all your registered webhook notification endpoints. Use this to verify your real-time update configurations.

### refund_payment_order
Refund a previously completed payment by providing the order code. This lets you handle customer returns instantly.

### create_payment_order
Create a new payment order using a token, amount, and currency. This lets you initiate sales without manual entry.

### create_reusable_token
Generate a reusable payment token from sensitive card data. This keeps your customer data secure and compliant.

### get_api_health
Check the current status of your Worldpay API connection. Use this to ensure your payment gateway is reachable.

### get_order_details
Pull specific details for a single payment order. This is great for quickly verifying transaction history.

### get_settlement_details
Get granular data for a specific settlement. Use this to see exactly how funds were distributed.

### get_token_details
Retrieve metadata for a specific payment token. This helps you manage and identify your stored payment methods.

## Prompt Examples

**Prompt:** 
```
Check if our Worldpay connection is active right now.
```

**Response:** 
```
I've checked your Worldpay API status. Everything looks good; the connection is active and reachable.
```

**Prompt:** 
```
Show me the last 3 settlements we received.
```

**Response:** 
```
Here are your 3 most recent settlements:

- **ID: set-992** | $1,450.00 | 2026-07-14
- **ID: set-991** | $820.50 | 2026-07-13
- **ID: set-990** | $2,100.00 | 2026-07-12

Would you like me to pull the details for any of these?
```

**Prompt:** 
```
Refund $25.00 for order ORD-5521.
```

**Response:** 
```
I've processed a partial refund of $25.00 for order ORD-5521. The status has been updated in Worldpay, and the customer should see the credit soon.
```

## Capabilities

### Create new payment orders
Your agent initiates new transactions using specific tokens, amounts, and currencies.

### Process customer refunds
Handle full or partial refunds for completed payments directly through your chat.

### Generate reusable tokens
Create secure payment tokens from sensitive card data to keep your systems compliant.

### Audit account settlements
List and monitor funds that have settled into your account with granular detail.

### Verify webhook configurations
Check your real-time notification endpoints to ensure your payment updates are delivering.

### Check gateway health
Verify the operational status of your Worldpay API connection instantly.

## Use Cases

### Refund a customer quickly
A support rep asks the agent to refund $50 on order ABC-123. The agent uses refund_payment_order to finish it in one step.

### Reconcile daily sales
A finance lead asks for the last 5 settlements. The agent uses list_payment_settlements to show the list immediately.

### Check gateway status
A developer wants to know if the API is up. The agent uses get_api_health to confirm connectivity without checking logs.

### Secure payment setup
An e-commerce lead wants to store a card for a recurring sub. The agent uses create_reusable_token to create a safe token.

## Benefits

- Stop clicking through complex dashboards to find transaction statuses. You can use get_order_details to see info instantly.
- Handle customer returns faster by using refund_payment_order to process full or partial refunds in seconds.
- Keep card data off your systems by using create_reusable_token to handle secure payment tokens.
- Speed up end-of-day reconciliation by using list_payment_settlements to see all your recent deposits.
- Ensure your system stays updated by using list_webhook_endpoints to verify your real-time notification setup.

## How It Works

The bottom line is you get a chat-based interface for your entire Worldpay payment pipeline.

1. Subscribe to the Worldpay MCP on Vinkius.
2. Enter your Worldpay Service Key into your AI client.
3. Start asking your agent to process refunds, check settlements, or create payment orders.

## Frequently Asked Questions

**Can the Worldpay MCP handle my customer refunds?**
Yes. Your AI agent can process full or partial refunds for completed payments by using the order code, saving you from manual data entry.

**How does the Worldpay MCP help with settlement audits?**
It allows your agent to list all settled funds and pull granular details for specific batches, making it much easier to reconcile your daily accounts.

**Is it safe to use the Worldpay MCP for card data?**
Yes. The Connector focuses on secure tokenization. You can create and manage reusable payment tokens without ever handling raw sensitive card information.

**Can I use the Worldpay MCP to check my webhook status?**
Absolutely. You can ask your agent to list your registered webhook endpoints to ensure your real-time notifications are configured correctly.

**How does the Worldpay MCP work with my AI agent?**
Once you connect the Connector to your AI client using your Service Key, you can simply talk to your agent to manage payments, refunds, and audits.

**Does the Worldpay MCP support partial refunds?**
Yes, the Connector supports both partial and full refunds. You just need to provide the order code and the specific amount you want to return.

**Can I process a refund through the agent?**
Yes. The `refund_payment_order` tool allows your AI agent to initiate a refund for any completed transaction. You just need to provide the order code and the amount (in minor units), and the agent will process it via the Worldpay API.

**How do I check the status of a specific payment?**
You can use the `get_order_details` tool. Provide the unique order code, and your agent will return the full transaction metadata, including current payment status, amount, and timestamp.

**Can I see a list of recent settlements made to my bank account?**
Absolutely. Use the `list_payment_settlements` tool to retrieve a summary of outgoing transfers to your account. You can then use `get_settlement_details` to see the individual payments included in each batch.