--- title: Agent Enablement Toolkit slug: ai/agent-enablement-toolkit excerpt: >- Build AI-powered payment agents with LangChain, Vercel AI SDK, and the OpenAI Agents SDK using Pine Labs Online APIs. hidden: false sidebar_order: 4 metadata: title: "Agent Enablement Toolkit — LangChain, OpenAI & Vercel AI | Pine Labs" description: >- Build AI payment agents with Pine Labs toolkit. Integrate LangChain, OpenAI Agents SDK, and Vercel AI SDK with function calling for orders, payments, refunds. keywords: "AI payment agent, LangChain payments, OpenAI Agents SDK, Vercel AI SDK, function calling, AI toolkit, payment automation, agent framework" robots: index --- ## Overview The **Pine Labs Online Agent Toolkit** lets you build AI-powered payment agents with **LangChain**, **Vercel AI SDK**, and the **OpenAI Agents SDK**. It exposes Pine Labs Online payment APIs as agent tools via function calling, so your agents can create orders, process payments, and manage transactions programmatically. ## Prerequisites Complete the following prerequisites before building PineLabs payment agents. 1. Create Pine Labs Online Merchant Account. You can register to Pine Labs Online Merchant Account **here**. 2. After Creating Successfully, **Login** to our Dashboard and generate the **`client_id`** and **`client_secret`**. 3. Ensure **`Node.js`** version **`18`** or later is installed. ## Framework support The toolkit supports the following frameworks, each accessible through a dedicated sub-path. | Framework | Import Path | Description | | :------------ | :----------------------------------------- | :--------------------- | | OpenAI | `@plural_pinelabs/agent-toolkit/openai` | For Open AI Agents SDK | | LangChain | `@plural_pinelabs/agent-toolkit/langchain` | For LangChain agents | | Vercel AI SDK | `@plural_pinelabs/agent-toolkit/ai-sdk` | For Vercel's AI SDK | ## Installation Use the below code to Install the toolkit using your preferred package manager: ```Text npm npm install @plural_pinelabs/agent-toolkit ``` ```Text yarn yarn add @plural_pinelabs/agent-toolkit ``` ```Text pnpm pnpm add @plural_pinelabs/agent-toolkit ``` ## Available Tools The table below shows the list of PineLabs Tools available. | Tool | Description | | :----------------- | :---------------------------------------------------- | | **`createOrder`** | Use this tool to create an Order. | | **`getOrder`** | Use this tool to retrieve the order by order ID. | | **`cancelOrder`** | Use this tool to cancel the Payment against an order. | | **`createRefund`** | Use this tool to initiate a refund against an order. | ## Sample Codes Use the below code samples to test and integrate quickly. [block:html] { "html": "" } [/block] [block:html] { "html": "
\n \n \n \n \n \n \n \n \n\n \n
\n \n \n \n
\n\n \n
\n \n
\n \n \n
\n\n \n
\n
\n 
import { Agent, run } from '@openai/agents';\nimport {\n  PinelabsAgentToolkit,\n  pinelabsEnvironment,\n} from '@plural_pinelabs/agent-toolkit/openai';\n\nconst pinelabs = new PinelabsAgentToolkit(\n  pinelabsEnvironment.UAT,               // or pinelabsEnvironment.PRODUCTION\n  process.env.PINE_CLIENT_ID!,\n  process.env.PINE_CLIENT_SECRET!\n);\n\nconst agent = new Agent({\n  name: 'Payment Agent',\n  instructions: 'You are a helpful payment assistant.',\n  model: 'gpt-4o',\n  tools: pinelabs.getAgentTools(),\n});\n\nconst result = await run(agent, 'Create an order for Rs. 500 for customer john@example.com');\nconsole.log(result.finalOutput);
\n
\n\n
\n

Expected Result

\n
\n 
{\n  \"token\": \"<<Redirect Token>>\",\n  \"order_id\": \"v1-5757575757-aa-hU1rUd\",\n  \"redirect_url\": \"https://api.pluralonline.com/api/v3/checkout-bff/redirect/checkout?token=<<Redirect Token>>\",\n  \"response_code\": 200,\n  \"response_message\": \"Order Creation Successful.\"\n}
\n
\n
\n
\n\n \n
\n
\n 
import OpenAI from 'openai';\nimport {\n  PinelabsAgentToolkit,\n  pinelabsEnvironment,\n} from '@plural_pinelabs/agent-toolkit/openai';\n\nconst openai = new OpenAI();\n\nconst pinelabs = new PinelabsAgentToolkit(\n  pinelabsEnvironment.UAT,\n  process.env.PINE_CLIENT_ID!,\n  process.env.PINE_CLIENT_SECRET!\n);\n\nconst response = await openai.chat.completions.create({\n  model: 'gpt-4o',\n  messages: [{ role: 'user', content: 'Create an order for Rs. 500' }],\n  tools: pinelabs.getTools(),\n});\n\nfor (const toolCall of response.choices[0].message.tool_calls ?? []) {\n  const result = await pinelabs.handleToolCall(\n    toolCall.function.name,\n    JSON.parse(toolCall.function.arguments)\n  );\n  console.log(result);\n}
\n
\n\n
\n

Expected Result

\n
\n 
{\n  \"token\": \"<<Redirect Token>>\",\n  \"order_id\": \"v1-5757575757-aa-hU1rUd\",\n  \"redirect_url\": \"https://api.pluralonline.com/api/v3/checkout-bff/redirect/checkout?token=<<Redirect Token>>\",\n  \"response_code\": 200,\n  \"response_message\": \"Order Creation Successful.\"\n}
\n
\n
\n
\n
\n\n \n
\n
\n 
import { ChatOpenAI } from '@langchain/openai';\nimport { AgentExecutor, createOpenAIFunctionsAgent } from 'langchain/agents';\nimport { ChatPromptTemplate } from '@langchain/core/prompts';\nimport {\n  PinelabsAgentToolkit,\n  pinelabsEnvironment,\n} from '@plural_pinelabs/agent-toolkit/langchain';\n\nconst pinelabs = new PinelabsAgentToolkit(\n  pinelabsEnvironment.UAT,\n  process.env.PINE_CLIENT_ID!,\n  process.env.PINE_CLIENT_SECRET!\n);\n\nconst tools = pinelabs.getTools(); // DynamicStructuredTool[]\n\nconst llm = new ChatOpenAI({ model: 'gpt-4o' });\nconst prompt = ChatPromptTemplate.fromMessages([\n  ['system', 'You are a helpful payment assistant.'],\n  ['human', '{input}'],\n  ['placeholder', '{agent_scratchpad}'],\n]);\n\nconst agent = await createOpenAIFunctionsAgent({ llm, tools, prompt });\nconst executor = new AgentExecutor({ agent, tools });\n\nconst result = await executor.invoke({ input: 'Create an order for Rs. 500' });\nconsole.log(result.output);
\n
\n\n
\n

Expected Result

\n
\n 
{\n  \"token\": \"<<Redirect Token>>\",\n  \"order_id\": \"v1-5757575757-aa-hU1rUd\",\n  \"redirect_url\": \"https://api.pluralonline.com/api/v3/checkout-bff/redirect/checkout?token=<<Redirect Token>>\",\n  \"response_code\": 200,\n  \"response_message\": \"Order Creation Successful.\"\n}
\n
\n
\n
\n\n \n
\n
\n 
import { generateText } from 'ai';\nimport { openai } from '@ai-sdk/openai';\nimport {\n  PinelabsAgentToolkit,\n  pinelabsEnvironment,\n} from '@plural_pinelabs/agent-toolkit/ai-sdk';\n\nconst pinelabs = new PinelabsAgentToolkit(\n  pinelabsEnvironment.UAT,\n  process.env.PINE_CLIENT_ID!,\n  process.env.PINE_CLIENT_SECRET!\n);\n\nconst result = await generateText({\n  model: openai('gpt-4o'),\n  tools: pinelabs.getTools(),\n  prompt: 'Create an order for Rs. 500',\n  maxSteps: 5,\n});\n\nconsole.log(result.text);
\n
\n\n
\n

Expected Result

\n
\n 
{\n  \"token\": \"<<Redirect Token>>\",\n  \"order_id\": \"v1-5757575757-aa-hU1rUd\",\n  \"redirect_url\": \"https://api.pluralonline.com/api/v3/checkout-bff/redirect/checkout?token=<<Redirect Token>>\",\n  \"response_code\": 200,\n  \"response_message\": \"Order Creation Successful.\"\n}
\n
\n
\n
\n
\n" } [/block] ## Environment Variables | Variable | Description | | :------------------- | :---------------------------------------------------------- | | `PINE_CLIENT_ID` | Client ID from the Pine Labs Online Developer Dashboard | | `PINE_CLIENT_SECRET` | Client Secret from the Pine Labs Online Developer Dashboard | ## Environments | Environment | Constant | Base URL | | :---------- | :------------------------------- | :------------------------------- | | UAT | `pinelabsEnvironment.UAT` | `https://pluraluat.v2.pinepg.in` | | Production | `pinelabsEnvironment.PRODUCTION` | `https://api.pluralpay.in` | ## Authentication Authentication is handled automatically. The toolkit uses your **`PINE_CLIENT_ID`** and **`PINE_CLIENT_SECRET`** to obtain a Bearer token via the Pine Labs Online OAuth2 token API. Tokens are cached and refreshed automatically before expiry — no manual token management required. ## Resources [block:html] { "html": "\n" } [/block] [block:html] { "html": "
\n \n \t\n\t\t\t\t\t
\n
\n
\n \n \n \n \n
\n \n \n \n \n \n
\n \n

\n GitHub Repository\n

\n \n

\n View the source code, report issues, and contribute to the toolkit.\n

\n \n
\n \n\n \n\t\t\t\t\n
\n
\n
\n \n \n \n \n \n \n
\n \n \n \n \n \n
\n \n
\n

\n npm Package\n

\n
\n \n

\n View the package on npm for installation and version details.\n

\n \n
\n
\n
" } [/block]