# Nuvei MCP > Nuvei MCP lets your AI client manage global payments, tokenize sensitive card data, and track transaction history using natural conversation. Instead of logging into a complex merchant dashboard, you tell your agent what payment needs processing or which settlement status you need verified. This is for handling everything from initial charges to refunds and securely vaulting customer payment methods. ## Overview - **Category:** money-moves - **Price:** Free - **Tags:** global-payments, transaction-auditing, tokenization, merchant-services, ecommerce-payments, api-integration ## Description Manage global payments directly through chat. Connect this MCP to let your AI client handle the full lifecycle of transactions—from authorizing a new purchase to auditing historical settlements, all without leaving your workflow. Your agent can initiate live charges or capture previously authorized amounts using conversational prompts. Need to update customer payment details? You don't have to worry about raw card numbers; simply ask your agent to securely vault and refresh token information. Furthermore, you can pull detailed records of past activity or verify the current status of an asynchronous settlement instantly. By connecting this service through Vinkius, you give any MCP-compatible client access to a complete financial toolkit that handles everything from generating payments to canceling pending charges. ## Tools ### capture_payment Completes a payment that was previously authorized but not yet charged to the customer's card. ### create_payment Initiates a new, real money charge request through the payment network and returns the transaction ID. ### create_card_token Takes plain card details and converts them into a secure, vaulted payment token for later use. ### delete_token Permanently removes a saved payment token to prevent all future charges or one-click purchases from that account. ### get_payment Checks the current, definitive status of a specific payment ID after it's been processed by the gateway. ### get_token Retrieves and displays all known details about a card token that was previously vaulted in the system. ### get_transactions Lists or enumerates a batch of historical payment records for general auditing purposes. ### refund_payment Processes a refund amount against a fully captured and settled Nuvei payment. ### update_token Changes specific information, like an expiration date, on a vaulted token without requiring new card details. ### void_payment Cancels a payment that has been authorized but not yet captured, preventing the final charge. ## Prompt Examples **Prompt:** ``` Fetch the status of transaction ID 987654321. ``` **Response:** ``` I've queried Nuvei and the transaction `987654321` was Declined. The Gateway response noted 'Insufficient Funds' on the provided Visa card. ``` **Prompt:** ``` Show me the 10 most recent transactions on my account. ``` **Response:** ``` Here is a table summarizing your 10 most recent Nuvei transactions. You have 9 Approved charges and 1 Refund in pending status. ``` **Prompt:** ``` Retrieve the token details for Customer UUID `usr-88` in the vault. ``` **Response:** ``` The vault details for `usr-88` show an active Card Token ending in 4242, expiring 12/28. Would you like me to initiate a new payment using this token? ``` ## Capabilities ### Process new and authorized charges Start live payment requests or capture previously held funds using conversational commands. ### Securely vault card details Tokenize raw card numbers, storing them securely in a vault without exposing sensitive data. ### Audit payment history and status Retrieve current settlement statuses or list multiple historical transaction records for reconciliation. ### Manage token lifecycles Refresh expiration dates on stored tokens, delete old payment credentials, or view existing vault details. ## Use Cases ### Handling a suspicious charge inquiry A customer support agent needs to check if a client's payment failed. Instead of making the user log into their portal, the agent uses `get_payment` to fetch the current status and reports back instantly: 'I see that transaction ID 987654321 was declined due to insufficient funds.' ### Running end-of-day financial audits The finance manager needs a list of all payments processed yesterday. They ask their agent to run `get_transactions`, receiving an enumerated table showing every charge, refund, and status update for the entire day in one go. ### Simulating checkout flow for new features An e-commerce developer needs to test payment logic. They use `create_payment` followed by `capture_payment` through their IDE, simulating a full, successful purchase cycle without needing a sandbox environment. ### Managing subscription renewals The billing team locates an old customer's details and uses `get_token` to retrieve the active card token. They then use this token for a new charge, ensuring continuous service without asking the user for their credit card number again. ## Benefits - Saves time on reconciliation. Instead of manually downloading daily transaction reports to cross-reference accounting entries, you can use the `get_transactions` tool to fetch summaries directly into your chat window for immediate review. - Reduces fraud risk by never handling raw card data in plain text. You use `create_card_token` to vault sensitive payment information and reference tokens instead, keeping everything secure. - Improves customer support efficiency. When a client calls about a charge, your agent uses the `get_payment` tool to confirm if the transaction cleared or if it's still pending, giving an instant answer. - Streamlines refunds and credits. If a shipment is returned, you use `refund_payment` to process the money back immediately via chat, tracking the entire reversal instantly. - Prevents accidental charges. If a payment was authorized but needs to be stopped before settlement, you can run `void_payment` directly through your agent instead of needing manual API calls. - Maintains data integrity with updates. Need to change an expiring card's date? You use the `update_token` tool to mutate specific fields on the vault record without asking the user for full credentials. ## How It Works The bottom line is that you get real-time financial data and actionable commands without opening a web browser. 1. Subscribe to this MCP and provide your Nuvei API keys and merchant account credentials. 2. Direct your AI client to the endpoint. Your agent uses those credentials to make a secure connection to the payment gateway. 3. You issue a command like, 'Check the status of transaction X' or 'Process a $50 charge,' and your agent returns the raw data directly into your chat. ## Frequently Asked Questions **How do I check if a payment cleared using Nuvei MCP?** Use the `get_payment` tool. This function queries the gateway and provides the definitive current status of any paid transaction ID, letting you know if funds have actually settled. **Can I use Nuvei MCP to process a refund?** Yes, you can run `refund_payment` through your agent. This allows you to initiate partial or full refunds against any fully captured payment ID directly within your chat workflow. **What is the difference between create_payment and capture_payment?** They handle different stages of a transaction. `create_payment` starts the authorization process, while `capture_payment` finalizes the charge for funds that were previously authorized. **How do I securely store customer card details with Nuvei MCP?** Use the `create_card_token` tool. This converts raw card data into a secure, non-sensitive token ID that you can use for future charges without risking the original payment information. **Can I cancel an authorized charge using Nuvei MCP?** Yes, you run `void_payment`. This action cancels any pending authorization before the funds are captured, preventing the final charge from going through.