Checkout.com MCP. Manage payment lifecycle and global transactions via AI chat.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Checkout.com MCP Server lets you manage global payments directly from any AI agent. Track transactions, process refunds, and monitor account health across 150+ currencies using natural conversation.
You can list payments, capture funds, void transactions, and audit payment histories without opening a web dashboard.
What your AI agents can do
Capture checkout payment
Captures funds for an payment that was previously authorized.
Get checkout account info
Retrieves core account and user settings information.
Get payment details
Gets detailed information for a specific payment ID.
Retrieve core account and user settings information.
Retrieve a list of recent payment transactions.
Get detailed information for one specific payment ID.
Issue a refund for a previously captured payment.
Cancel an authorized payment before it's captured.
List every lifecycle action taken on a specific payment.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Checkout.com MCP Server: 8 Tools for Payment Operations
Use these tools to execute payment captures, retrieve account details, and manage the entire payment lifecycle directly from your AI client.
019d756ecapture checkout payment
Captures funds for an payment that was previously authorized.
019d756eget checkout account info
Retrieves core account and user settings information.
019d756eget payment details
Gets detailed information for a specific payment ID.
019d756elist checkout payments
Lists a list of recent payment transactions.
019d756elist checkout webhooks
Lists all webhooks currently configured for the account.
019d756elist payment actions
Lists every recorded action (like capture or void) for a single payment.
019d756erefund checkout payment
Processes a refund for a payment that was previously captured.
019d756evoid checkout payment
Cancels an authorized payment before funds are captured.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Checkout.com, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
You can run every global payment operation through your AI agent, linking it straight to your Checkout.com account. You'll track transactions, process refunds, and monitor account health across over 150 currencies using just natural conversation. You don't gotta open up a web dashboard to manage anything.
Get Account Status
Use get_checkout_account_info to pull core account and user settings. You'll know exactly what your account status is.
List Payment Records
list_checkout_payments gives you a list of recent payment transactions. You can see what's been going through without digging around.
Check Specific Payment Details
Need the nitty-gritty on one payment? get_payment_details pulls all the details for a specific payment ID.
Process Refunds
If a payment was captured, you use refund_checkout_payment to issue a refund. It'll process the money back.
Void Payments
Before you capture the funds, you run void_checkout_payment to cancel an authorized payment. That stops the money flow.
Audit Payment History
To see the full story on a payment, list_payment_actions lists every recorded action—like a capture or a void—for that single payment. You can audit the whole lifecycle.
Manage Webhooks
list_checkout_webhooks shows you all the webhooks set up for the account. You can check that your payment integration is running right.
Capture Funds
After authorizing a payment, you use capture_checkout_payment to actually take the money. It finalizes the transaction.
How Checkout.com MCP Works
- 1 Subscribe to the Checkout.com server and input your Secret Key and API Prefix.
- 2 Tell your AI agent what you need: 'List the last 10 payments' or 'Refund pay_xyz for $5.'
- 3 Your agent calls the relevant tool, processes the transaction, and gives you the resulting status and data.
The bottom line is: you talk to your agent, and it executes the payment logic against Checkout.com.
Who Is Checkout.com MCP For?
This is for Finance teams who need to process refunds and monitor transaction volumes using natural language. It's for E-commerce Managers who must audit payment statuses without logging into the merchant dashboard. Customer Support staff who need to quickly verify payment results or capture authorizations straight from a chat interface also rely on this.
Monitors transaction volumes and executes refunds using plain language commands.
Audits payment statuses and tracks payment lifecycle actions without leaving their main workspace.
Verifies payment results and captures outstanding authorizations directly from their chat interface.
What Changes When You Connect
- Process refunds instantly. Use
refund_checkout_paymentto issue a refund for a captured payment, all through conversation. No dashboard clicks required. - Audit every payment status.
list_payment_actionstracks the full history of a payment, showing exactly when it was captured or voided. - Control payment flow. You can
capture_checkout_paymentorvoid_checkout_paymentpayments on the fly, ensuring funds are secured when needed. - See the full picture. Use
list_checkout_paymentsto get a quick list of recent transactions, orget_payment_detailsfor deep dives into one specific payment. - Keep integrations healthy.
list_checkout_webhookslets you review configured webhooks to confirm your connection is running without errors. - Handle complex numbers. The server works with minor units, so you don't have to worry about rounding errors when managing finance-heavy transactions.
Real-World Use Cases
Investigating a disputed payment.
A support agent needs to know why a payment failed. They ask their agent to check payment ID 'pay_xyz'. The agent calls get_payment_details and list_payment_actions, immediately showing the full history and the failure point. The agent gives the customer a concrete answer without transferring the call to Tier 2 support.
Batch processing end-of-month refunds.
The finance team needs to refund 50 customers. Instead of logging into the merchant portal 50 times, they prompt their agent: 'Refund the last 50 payments.' The agent calls refund_checkout_payment repeatedly, confirming the status for each one in a single chat session.
Verifying payment capture for a sale.
An e-commerce manager just took an order. Before closing the sale, they ask their agent to confirm the payment status. The agent uses list_checkout_payments to verify the authorization status, then calls capture_checkout_payment to finalize the funds transfer. The entire process is logged and confirmed instantly.
Checking webhook delivery after an update.
A developer finished an integration update. They ask their agent to check webhook delivery. The agent runs list_checkout_webhooks, confirming the endpoint is registered and active. They also run get_checkout_account_info to validate the primary API connection settings.
The Tradeoffs
Mixing up listing and details
Trying to find a payment's history by just listing payments. You see the ID, but you have no way to know if it was captured, voided, or just authorized.
→
First, use list_checkout_payments to find the ID. Then, immediately use get_payment_details or list_payment_actions with that specific ID to get the full, accurate history.
Assuming payment status
Assuming an authorized payment is guaranteed money. If you don't explicitly call capture_checkout_payment, the funds aren't secured, and the sale fails later.
→
Always use list_checkout_payments to check the current status, then explicitly call capture_checkout_payment when the sale is confirmed. Never skip the capture step.
Forgetting the audit trail
Only processing a refund and then forgetting to check the status. You send the refund request, but you don't know if the gateway accepted it or if it failed.
→
After running refund_checkout_payment, always call list_payment_actions on that payment ID. This confirms the refund request was logged successfully.
When It Fits, When It Doesn't
Use this server if your workflow requires managing the full payment lifecycle—authorizing, capturing, refunding, or voiding funds—and you need that control via conversational chat. You need transactional certainty. Don't use this if you just need to view a static report; use a dedicated BI or accounting tool for that. If your only need is to check a single API key, use get_checkout_account_info. But if you need to do anything with the money, you need this full payment control.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Checkout.com. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 8 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Manually checking payment statuses shouldn't require 10 clicks.
Right now, checking a payment's status means logging into the merchant portal. You navigate to 'Payments,' then search for the ID. You might have to open a separate 'Actions' tab, and sometimes the status update is buried deep in a 'History' log. It's a copy-paste, tab-switching nightmare.
With the Checkout.com MCP Server, you just ask your agent: 'What happened to pay_xyz?' It runs `get_payment_details` and `list_payment_actions` and gives you the full, precise answer immediately. You get the status, the timestamp, and the action—all in one response.
Checkout.com MCP Server: Manage payment actions from chat.
Manual operations like voiding an authorized payment or processing a refund require navigating multiple pages, confirming details, and hitting 'Submit' multiple times. It's slow, and it's easy to miss a confirmation step.
Now, you tell your agent: 'Void payment pay_abc.' The agent executes `void_checkout_payment`. You get an immediate, confirmed status update. You don't touch a dashboard; the payment state changes directly through the chat interface.
Common Questions About Checkout.com MCP
How do I find out what actions were taken on a payment using list_payment_actions? +
You use list_payment_actions with the payment ID. This tool returns a complete, chronological list of every event—like authorization, capture, or void—that has happened to that specific payment ID.
Can I refund a payment using refund_checkout_payment? +
Yes, refund_checkout_payment processes the refund request. You must ensure the original payment was captured first, as the refund tool requires a captured payment to operate.
What is the difference between listing payments and getting payment details? +
Use list_checkout_payments to see a quick summary list of recent transactions. Use get_payment_details when you need the full, detailed data record for one specific payment ID.
Do I need to call capture_checkout_payment every time? +
Yes, if you authorize money and need the funds secured, you must call capture_checkout_payment. Authorization just holds the money; capture moves the money.
How do I check my account info using get_checkout_account_info? +
This tool retrieves core account and user data. You can use it to verify API credentials, check user settings, or confirm account limits without needing a separate dashboard login.
What does list_checkout_webhooks do? +
It shows all configured webhooks. This is crucial for ensuring your integration works correctly, letting you list and review endpoints for payment status updates.
When should I use void_checkout_payment instead of refund_checkout_payment? +
Voiding cancels an authorized payment before it settles. Refunds process money back to the customer after the payment has already captured funds.
Can I list all payments and filter by a specific date range using list_checkout_payments? +
Yes, you can filter payments using the API parameters. This allows you to narrow down the results, for example, showing only transactions that occurred last week.
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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Mercury
Equip your AI agent with direct access to Mercury — check account balances, review transactions, and manage recipients without opening the banking dashboard.
Mollie
Accept online payments across Europe with a payment gateway that supports iDEAL, credit cards, PayPal, and local methods seamlessly.
Younium
Manage B2B subscriptions, accounts, and financial metrics on Younium — the leading subscription management and billing platform.
You might also like
BrandMentions
Monitor social listening and brand mentions via BrandMentions — track keywords, manage projects, and list influencers directly from any AI agent.
Eventbrite
Create events, sell tickets, and manage attendees with the world largest self-service ticketing platform for any occasion.
Aliyun CAPTCHA / 阿里云验证码
Alibaba Cloud's dominant anti-bot service — verify tickets and audit security risk via AI.