On This Page {#jumplink-list} [Markdown](/docs/vas/en-us/agent-toolkit/quick-start/all/na/agent-toolkit.md) Introduction to the `Visa Acceptance Agent Toolkit` {#agent-toolkit-intro} ========================================================================== Use the `Visa Acceptance Agent Toolkit` to simplify the process of integrating the `Visa Acceptance Solutions` APIs into your agentic workflows. The specialized tools in the toolkit are designed to enable your AI agents to utilize the `Pay by Link` and Invoicing APIs. This allows your agents to create and manage payment links and invoices. The toolkit is built in TypeScript, and you can integrate it with the Vercel AI SDK or use it to access a Model Context Protocol (MCP) server. This guide provides step-by-step instructions that explain how to begin using the toolkit with IDE tools or applications, such as the Claude Desktop, for development and testing purposes. This toolkit is in the pilot phase. AI applications do not always produce the same results. Users are responsible for evaluating their own AI applications, and it is recommended that users evaluate such applications in a controlled test environment. ![](/content/dam/new-documentation/documentation/en-us/topics/platform/bam/agent-toolkit/images/agent-toolkit-options-650x275.svg/jcr:content/renditions/original) **Quick Start Options** : * [Visa Acceptance Agent Toolkit Quick Start](/docs/vas/en-us/agent-toolkit/quick-start/all/na/agent-toolkit/agent-toolkit-options/agent-toolkit-install.md "") * [MCP Server Quick Start](/docs/vas/en-us/agent-toolkit/quick-start/all/na/agent-toolkit/agent-toolkit-options/agent-toolkit-mcp.md "") Requirements ------------ These are the prerequisite requirements for using the `Visa Acceptance Agent Toolkit`: * Node.js version 18 or later. * `Visa Acceptance Solutions` merchant ID (MID) or organization ID. To sign up for a sandbox account, see the [Sandbox Account Sign Up](https://developer.visaacceptance.com/hello-world/sandbox.md "") page. * REST API shared secret key. To create a key with an existing organization or merchant account, see the [*Creating and Using Security Keys User Guide*](https://developer.visaacceptance.com/docs/vas/en-us/security-keys/user/all/ada/security-keys/keys-intro.md ""). If you need to sign up for a sandbox account, the sign up process creates a test key. * Invoicing or `Pay by Link` APIs enabled. To enable these APIs, contact your account manager. For additional information, see the [*Invoicing Developer Guide for the REST API*](https://developer.visaacceptance.com/docs/vas/en-us/invoicing/developer/all/rest/invoicing/Introduction.md "") and the [*`Pay by Link` Developer Guide for the REST API*](https://developer.visaacceptance.com/docs/vas/en-us/paybylink/developer/all/rest/paybylink/paybylink-intro.md ""). GitHub Additional Resources --------------------------- To access the most up to date `Visa Acceptance Agent Toolkit` files in GitHub, see: [`https://github.com/visaacceptance/agent-toolkit`](https://github.com/visaacceptance/agent-toolkit "") MCP Additional Information -------------------------- For additional information about MCP, see: [`https://modelcontextprotocol.io/docs/getting-started/intro`](https://modelcontextprotocol.io/docs/getting-started/intro "") Quick Start Options {#concept} ============================== This section describes the two quick start options for adding the `Visa Acceptance Platform` APIs to your agentic workflows: * [Visa Acceptance Agent Toolkit Quick Start](/docs/vas/en-us/agent-toolkit/quick-start/all/na/agent-toolkit/agent-toolkit-options/agent-toolkit-install.md "") * [MCP Server Quick Start](/docs/vas/en-us/agent-toolkit/quick-start/all/na/agent-toolkit/agent-toolkit-options/agent-toolkit-mcp.md "") `Visa Acceptance Agent Toolkit` Quick Start {#agent-toolkit-install} ==================================================================== Follow these steps to install and configure the `Visa Acceptance Agent Toolkit`. 1. Run this command to install the `Visa Acceptance Agent Toolkit`: ``` npm install @visaacceptance/agent-toolkit ``` 2. To enable environment variables, create a new *.env* file and insert this code snippet in the file. Replace the sample values with your merchant credentials. To create a REST API shared secret key, see the [*Creating and Using Security Keys User Guide*](https://developer.visaacceptance.com/docs/vas/en-us/security-keys/user/all/ada/security-keys/keys-intro.md ""). ``` VISA_ACCEPTANCE_MERCHANT_ID=your_merchant_id_here VISA_ACCEPTANCE_API_KEY_ID=your_api_key_id_here VISA_ACCEPTANCE_SECRET_KEY=your_secret_key_here ``` 2. Use this sample code for your AI agents. In this sample, the toolkit is configured to use the test environment and has all of the Invoicing and `Pay by Link` tools enabled. ``` import { VisaAcceptanceAgentToolkit } from "@visaacceptance/agent-toolkit/ai-sdk"; const toolkit = new VisaAcceptanceAgentToolkit({ merchantId: process.env.VISA_ACCEPTANCE_MERCHANT_ID, apiKeyId: process.env.VISA_ACCEPTANCE_API_KEY_ID, secretKey: process.env.VISA_ACCEPTANCE_SECRET_KEY, configuration: { context: { environment: "SANDBOX", }, actions: { invoices: { create: true, update: true, list: true, get: true, send: true, cancel: true }, paymentLinks: { create: true, update: true, list: true, get: true, }, }, }, }); ``` Example: Creating a Chatbot with the `Visa Acceptance Agent Toolkit` -------------------------------------------------------------------- This example shows the toolkit being used to create an AI chatbot. ``` require('dotenv').config(); import { VisaAcceptanceAgentToolkit } from '@visaacceptance/agent-toolkit/ai-sdk'; import { openai } from '@ai-sdk/openai'; import { generateText } from 'ai'; const configuration = { actions: { paymentLinks: { create: true } }, }; const visaAcceptanceAgentToolkit = new VisaAcceptanceAgentToolkit( process.env.VISA_ACCEPTANCE_MERCHANT_ID, process.env.VISA_ACCEPTANCE_API_KEY_ID, process.env.VISA_ACCEPTANCE_SECRET_KEY, "SANDBOX", configuration ); async function aiGeneratedPaymentLink() { console.log("Attempting to generate a payment link..."); const userPrompt = `Create a payment link for a Ski trip to Whistler Canada with a compelling selling point in the description. The total amount is $1000.00.`; const result = await generateText({ model: openai('gpt-4o'), tools: { ...visaAcceptanceAgentToolkit.getTools(), }, maxSteps: 5, prompt: userPrompt, }); console.log(result); } aiGeneratedPaymentLink(); ``` MCP Server Quick Start {#agent-toolkit-mcp} =========================================== The MCP server enables you to integrate the Visa Acceptance APIs using tool calling. This process supports multiple tools that can access the `Visa Acceptance Platform` APIs, such as `Pay by Link` and Invoicing. This is a local MCP server. Follow these steps to create a MCP server using npx with your merchant credentials and preferred tools. 1. Run one of these commands to access the Visa Acceptance MCP server. These commands use the test environment. Enable all tools: : ``` npx -y @visaacceptance/mcp --tools=all --merchant-id=MERCHANT_ID --api-key-id=API_KEY_ID --secret-key=SECRET_KEY ``` Enable specific tools: : ``` npx -y @visaacceptance/mcp --tools=tool.values --merchant-id=YOUR_MERCHANT_ID --api-key-id=YOUR_API_KEY_ID --secret-key=YOUR_SECRET_KEY ``` To enable specific tools, choose the tools you want to utilize and concatenate their values in the tools parameter using the comma character (`,`): | `Visa Acceptance Platform` Tools | API Service | Field | |----------------------------------|-------------|---------------------| | Invoicing | Create | invoices.create | | Invoicing | Update | invoices.update | | Invoicing | List | invoices.list | | Invoicing | Retrieve | invoices.get | | Invoicing | Send | invoices.send | | Invoicing | Cancel | invoices.cancel | | Pay by Link | Create | paymentLinks.create | | Pay by Link | Update | paymentLinks.update | | Pay by Link | List | paymentLinks.list | | Pay by Link | Retrieve | paymentLinks.get | [`Visa Acceptance Solutions` Tools] Example of concatenated tool values : ``` --tools=invoices.create,invoices.update,paymentLinks.create,paymentLinks.update ``` Support for Claude Desktop -------------------------- If you use the Claude Desktop, add this to your *claude_desktop_config.json* file: ``` { "mcpServers": { "visa-acceptance": { "command": "npx", "args": [ "-y", "@visaacceptance/mcp", "--tools=all", "--merchant-id=YOUR_MERCHANT_ID", "--api-key-id=YOUR_API_KEY_ID", "--secret-key=YOUR_SECRET_KEY" ] } } } ``` Test Prompts {#agent-toolkit-test-prompts} ========================================== Enter these prompts in your test environment to verify that the `Visa Acceptance Platform` APIs are successfully integrated into your agentic workflows. Edit the prompts as needed to meet your organization's needs. **Prompts for Your AI Agents** : * Create a payment link for $450 in EUR for ACME Corp, due in 15 days. * Create an invoice for $450 in EUR for ACME Corp, due in 15 days. * Find all unpaid invoices over $500. * Update invoice #5 to change due date to June 1st. Validate Your Agents' Output ---------------------------- To verify that your agents used the APIs to create transactions, follow these steps to search for the transactions in the `Business Center`. 1. Log in to the `Business Center`: * **Test:** [`https://businesscentertest.visaacceptance.com`](https://businesscentertest.visaacceptance.com/ebc2/ "") * **Production:** [`https://businesscenter.visaacceptance.com`](https://businesscenter.visaacceptance.com/ebc2/ "") 2. On the left navigation panel, click ![](/content/dam/new-documentation/documentation/en-us/common/images/ebc/ebc-icon-trxn-mgmt.svg/jcr:content/renditions/original) **Transaction Management** **\>** **Transactions** . The Transaction page appears. 3. Choose **Add filter** . The **New Filter** field appears. 4. Click the **New Filter** field and enter Client Application or choose **Client Application** from the drop-down menu. 5. Click the **New Filter** field again and enter the product type you want to verify or choose it from the drop-down menu. 6. When done, click **Search** . The Search Results table displays only the transactions that belong to the product you chose. ![](/content/dam/new-documentation/documentation/en-us/topics/platform/bam/agent-toolkit/images/invoice-trxn-mgmt-filter.png/jcr:content/renditions/original) Customer Support {#agent-toolkit-cs} ==================================== For additional help, contact the `Visa Acceptance Agent Toolkit` team at this email address: [GDLdeveloper@visa.com](mailto:GDLdeveloper@visa.com "") You can also contact `Visa Acceptance Platform` customer support here: [`https://support.visaacceptance.com/`](https://support.visaacceptance.com/ "") Recent Revisions to This Pilot Document {#agent-toolkit-recent-revisions} ========================================================================= 25.08.01 -------- Pilot release.