• SUCCESS
  • PENDING
  • REVERSED
  • MANUAL

How to process and refund payments with your AI

Connect Nuvei to your agent to handle the entire transaction lifecycle without leaving your chat window.

Ask AI about this page

Short answer

Can I manage Nuvei transactions through my AI?

Yes. Your agent uses Nuvei tools to authorize charges, capture funds, and handle refunds or voids directly in your chat. You'll see the specific results of each transaction immediately.

Transaction outcomes

Where your money moves

Every command you give your agent results in one of these four states.

SUCCESS

Funds captured

The agent completes the payment process. You'll get a confirmation once the money is successfully moved.

PENDING

Authorization held

The agent secures the funds on the customer's card. The transaction stays in a pending state until you capture it.

REVERSED

Refunds and voids

The agent returns money to the customer or cancels a pending charge. You'll get a receipt for the reversal.

MANUAL

Human intervention

If a transaction fails or requires extra verification, the agent will stop and ask you to handle it in the Nuvei dashboard.

The workflow

What your AI does when a payment request arrives.

Your agent translates your natural language instructions into specific API calls to Nuvei.

  1. Secure the funds

    The agent checks the customer details and requests an initial authorization to ensure the funds are available.

    create_payment

  2. Finalize the sale

    Once you confirm the order is ready, the agent moves the authorized funds into your account.

    capture_payment

  3. Cancel pending orders

    If a customer changes their mind before the funds are captured, the agent kills the transaction immediately.

    void_payment

  4. Return money

    For completed sales that need a reversal, the agent pushes the refund through to the original payment method.

    refund_payment

Try it

Copy these to start.

Use these prompts to trigger actions in Nuvei.

Starting points

Swap out the bracketed info with your actual customer names, amounts, or transaction IDs.

Nuvei Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_51Syt4DGAHWALff9VkisRN0rIeEAhRTwfgvkTXCY/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Nuvei capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "nuvei-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_51Syt4DGAHWALff9VkisRN0rIeEAhRTwfgvkTXCY/mcp"
    }
  }
}
Copy into chat04

  • Create a new payment for $50.00 for customer Jane Doe.

  • Capture the payment for transaction ID 98765.

  • Refund the last $25.00 charge to customer Acme Corp.

  • Void the pending authorization for order #12345.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Nuvei once, then ask.

Log in to your Nuvei account through the Vinkius interface. Once connected, your agent can immediately start managing your payments.

Connect Nuvei to your AI

FAQ

How the Nuvei Connector behaves

  • 01

    Can my AI change my Nuvei account settings?

    No. The agent only has permission to perform the specific payment actions listed in its toolset.

  • 02

    Does the AI handle the actual credit card numbers?

    No. The agent interacts with transaction IDs and amounts. It does not see or store raw card data.

  • 03

    Can I ask the AI to list all my past transactions?

    No. This specific connector is built for processing and reversing payments, not for retrieving transaction history.

  • 04

    What happens if a refund fails?

    The agent will report the error message returned by Nuvei. You will need to check the Nuvei dashboard to resolve the issue.

  • 05

    Can the AI delete a transaction entirely?

    No. The agent can void a pending payment or refund a captured one, but it cannot delete records from your Nuvei history.

  • More questions about Nuvei? The Connector page answers them. See everything the Nuvei Connector can do

Connect Nuvei to Claude, Cursor, ChatGPT & more