Nuvei Connector for AI agents.

Q: Can I query why a specific transaction was declined?

Yes. Ask the agent to use getpayment with your transaction ID. The AI will parse the complex payload returned by Nuvei and summarize the error message (e.g., Insufficient Funds, Do Not Honor) directly in human language.

10 live capabilities

Manage global merchant payments and card tokenization through a chat interface.

Live agent request Nuvei / Connector

Waiting for input…

AI Agent

Why people use Nuvei

Nuvei for Global Payment Auditing and Reconciliation

With this Connector, you just ask your agent to do the heavy lifting. It pulls the history directly from Nuvei and puts it in front of you in seconds. You get a clear view of your transactions without ever leaving your workspace.

What Vinkius changes

You get a direct line from your chat interface to your global payment gateway.

Use it from Claude, ChatGPT, Cursor or another AI client you already have.

One account · 5,900+ Connectors

Real-world use case 01

Failed Payment Audit

A finance lead sees a discrepancy.
Real-world use case 02

Support Verification

A customer calls about a charge.
Real-world use case 03

Secure Checkout Testing

An engineer wants to test a new checkout flow.

Complete set · 10capabilities

The complete Nuvei capability set.

These are the exact actions your AI can choose when you ask it to work with Nuvei.

Capability set01 / 03

01—04

4 capabilities in this set.

Part of 10 available through Nuvei.

01 Capability
Capture payment
Capture a previously authorized card payment. You can choose to capture the full amount or a specific value.
02 Capability
Create payment
Initialize a new payment intent with Nuvei. This returns the transaction ID and status.
03 Capability
Delete token
Permanently delete a vaulted payment token. Use this to stop future recurring charges or one-click purchases.
04 Capability
Get payment
Retrieve the current status mapped to a Nuvei Payment ID. Use this to check if an async payment cleared.

Capability set02 / 03

05—07

3 capabilities in this set.

Part of 10 available through Nuvei.

05 Capability
Get token
View details of a previously vaulted Nuvei Card or Payment Token. You can check expiry dates and card types.
06 Capability
Get transactions
List or enumerate historical transaction records. This helps with auditing and seeing recent account activity.
07 Capability
Refund payment
Refund a fully captured Nuvei payment. This capability supports both full and partial refund amounts.

Capability set03 / 03

08—10

3 capabilities in this set.

Part of 10 available through Nuvei.

08 Capability
Update token
Mutate specific fields inside a vaulted token. You can update an expiry date without needing the full card details again.
09 Capability
Void payment
Cancel a pending authorized payment to prevent capture. This only works for payments that haven't cleared yet.
10 Capability
Create card token
Tokenize plain card details into a vaulted payment token. This keeps sensitive data out of your systems.

Set up in minutes

One URL. Then ask Nuvei to work.

Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Nuvei from the conversation.

Choose your client

Live preview

Advanced clients IDE · CLI

Claude · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_51Syt4DGAHWALff9VkisRN0rIeEAhRTwfgvkTXCY/mcp

Step 01

Open Connectors

In Claude Web or Claude Desktop, open Settings and choose Connectors.
Step 02

Add the URL

Choose Add custom connector, name it Nuvei, and paste the URL above.
Step 03

Turn it on in chat

Select +, open Connectors, and enable Nuvei for the conversation.

ChatGPT · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_51Syt4DGAHWALff9VkisRN0rIeEAhRTwfgvkTXCY/mcp

Step 01

Open MCP settings

On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
Step 02

Add the URL

Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Nuvei URL.
Step 03

Save and start

Save the connection and enable Nuvei in your conversation. Desktop may ask you to restart once.

Cursor · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "nuvei": {
      "url": "https://edge.vinkius.com/vk_preview_51Syt4DGAHWALff9VkisRN0rIeEAhRTwfgvkTXCY/mcp"
    }
  }
}

Step 01

Open MCP Settings

Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
Step 02

Add the server config

Paste the JSON configuration above into the mcp.json file that opens
Step 03

Save the file

Cursor will automatically detect the new Connector
Step 04

Start using Nuvei

Open Agent mode in chat and ask: "Using Nuvei, help me...". 10 tools available

VS Code Copilot · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "nuvei": {
      "url": "https://edge.vinkius.com/vk_preview_51Syt4DGAHWALff9VkisRN0rIeEAhRTwfgvkTXCY/mcp"
    }
  }
}

Step 01

Create MCP config

Create a .vscode/mcp.json file in your project root
Step 02

Add the server config

Paste the JSON configuration above
Step 03

Enable Agent mode

Open GitHub Copilot Chat and switch to Agent mode using the dropdown
Step 04

Start using Nuvei

Ask Copilot: "Using Nuvei, help me...". 10 tools available

Windsurf · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "nuvei": {
      "url": "https://edge.vinkius.com/vk_preview_51Syt4DGAHWALff9VkisRN0rIeEAhRTwfgvkTXCY/mcp"
    }
  }
}

Step 01

Open MCP Settings

Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
Step 02

Add the server

Paste the JSON configuration above into mcp_config.json
Step 03

Save and reload

Windsurf will detect the new server automatically
Step 04

Start using Nuvei

Open Cascade and ask: "Using Nuvei, help me...". 10 tools available

Cline · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "nuvei": {
      "url": "https://edge.vinkius.com/vk_preview_51Syt4DGAHWALff9VkisRN0rIeEAhRTwfgvkTXCY/mcp"
    }
  }
}

Step 01

Open Cline MCP Settings

Click the Connectors icon in the Cline sidebar panel
Step 02

Add remote server

Click "Add Connector" and paste the configuration above
Step 03

Enable the server

Toggle the server switch to ON
Step 04

Start using Nuvei

Ask Cline: "Using Nuvei, help me...". 10 tools available

Claude Code · Terminal command

Official guide ↗

Advanced setup

claude mcp add nuvei --transport http "https://edge.vinkius.com/vk_preview_51Syt4DGAHWALff9VkisRN0rIeEAhRTwfgvkTXCY/mcp"

Step 01

Install Claude Code

Run npm install -g @anthropic-ai/claude-code if not already installed
Step 02

Add the Connector

Run the command above in your terminal
Step 03

Verify the connection

Run claude mcp to list connected servers, or type /mcp inside a session
Step 04

Start using Nuvei

Ask Claude: "Using Nuvei, show me...". 10 tools are ready

Where the request belongs

Work Nuvei can move forward.

Built around the request

This is for the finance ops lead buried in spreadsheets, the support rep handling angry customers, and the e-commerce engineer who wants to automate payment flows without building extra glue code.

Finance Operations Lead

They use this to audit failed payments and reconcile daily transaction batches without logging into the Nuvei Control Panel.

Customer Support Representative

They use this to quickly locate a single transaction and verify a payment status during a live customer chat.

E-commerce Engineer

They use this to tokenize payments and simulate order testing securely within their code editor.

Build the capability set

Each Connector adds new actions and data without changing how you work.

Browse Connectors

01 7 capabilities

UnionPay Open Platform

Bring UnionPay QR Codes and secure global payments to your AI workflow. Handle card verification and online checkout.

View Connector

02 10 capabilities

Checkout.com

Manage global payments via Checkout.com. process payments, capture funds, handle refunds, and vault instruments directly from any AI agent.

View Connector

03 4 capabilities

Adyen

Global payment processing. manage payments, refunds, and merchant accounts via AI.

View Connector

04 10 capabilities

Authorize.net

Process cards, manage refunds, capture holds, and inspect settled transactions on Authorize.net directly from your AI agent.

View Connector

05 10 capabilities

Blink Payment

Manage payments, customers, and paylinks seamlessly using Blink Payment with AI Agents.

View Connector

06 31 capabilities

Marqeta

Issue cards, manage users, and process payments via Marqeta's modern card issuing platform.

View Connector

Bring your own AI

Change the model, client or framework. Keep Nuvei connected.

Claude
ChatGPT
Gemini
Cursor
VS Code
Windsurf
ZCode
Cline
Zed
Continue
Kiro
Roo Code
Zencoder
Goose
Void
Augment Code
Amp
Qodo
Tabnine
Pieces
Sourcegraph Cody
JetBrains
Warp
Amazon Q
Antigravity
BoltAI
Raycast
Jan
LM Studio
AnythingLLM
Open WebUI
Msty
Cherry Studio
LibreChat
TypingMind
Chorus
5ire
n8n
LangChain
LlamaIndex
CrewAI
Vercel AI SDK

Before you connect

Questions about Nuvei.

The practical details behind the request, access and result.

Can the Nuvei MCP handle international payments?

Yes, it connects to the Nuvei platform which is built for global transactions. It allows you to manage payments across different regions directly through your AI agent.

How do I use Nuvei MCP to check if a payment cleared?

You can ask your agent to check a specific payment ID. It will pull the live status from your merchant account and tell you if the funds were successfully captured.

Does Nuvei MCP keep my customer data safe?

Yes, it uses card tokenization. This means your AI agent handles secure tokens rather than raw card numbers, keeping your sensitive customer data out of the chat history.

Can I process refunds through the Nuvei MCP?

Yes, you can ask your agent to issue a full or partial refund for any captured payment. It handles the request and confirms the status for you.

Is the Nuvei MCP good for subscription management?

It is excellent for managing recurring charges. You can use it to delete vaulted tokens to stop subscriptions or update token details without needing the card info again.

How do I find old transactions with Nuvei MCP?

Your agent can pull a list of historical records from your merchant account instantly. You just need to tell it the timeframe or the specific transaction details you are looking for.

How can I securely pass card inputs if the chat format is plain text?

The integration routes direct requests to Nuvei's sandbox or live vault using the create_card_token feature natively. Since the AI environment is localized and isolated by default, inputs made within Claude or Cursor are ephemeral and pass straight into Nuvei via the secure connection layer without persisting in logs.

Can I query why a specific transaction was declined?

Yes. Ask the agent to use get_payment with your transaction ID. The AI will parse the complex payload returned by Nuvei and summarize the error message (e.g., Insufficient Funds, Do Not Honor) directly in human language.

Is it possible to track batch settlements?

Use the get_transactions capability. Your prompt can specify that you want to list out the last 20 payments, and the AI will structure them neatly as a tabular view in your chat interface.

One connection away

Give your agent a direct line to Nuvei.

Connect Nuvei once. Keep it beside 5,900+ managed Connectors when the next task needs more.

Explore every Connector No credit card required · Free tier available

Nuvei for Global Payment Auditing and Reconciliation

You get a direct line from your chat interface to your global payment gateway.

Failed Payment Audit

Support Verification

Secure Checkout Testing

Capture payment

Create payment

Delete token

Get payment

Get token

Get transactions

Refund payment

Update token

Void payment

Create card token

Open Connectors

Add the URL

Turn it on in chat

Open MCP settings

Add the URL

Save and start

Open MCP Settings

Add the server config

Save the file

Start using Nuvei

Create MCP config

Add the server config

Enable Agent mode

Start using Nuvei

Open MCP Settings

Add the server

Save and reload

Start using Nuvei

Open Cline MCP Settings

Add remote server

Enable the server

Start using Nuvei

Install Claude Code

Add the Connector

Verify the connection

Start using Nuvei

Finance Operations Lead

Customer Support Representative

E-commerce Engineer

UnionPay Open Platform

Checkout.com

Adyen

Authorize.net

Blink Payment

Marqeta

Give your agent a direct line to Nuvei.