Cashfree Agent Toolkit

Build AI-powered payment agents with LangChain, Vercel AI SDK, and OpenAI Agents SDK.

The Cashfree Payments Agent Toolkit enables popular agent frameworks including LangChain, Vercel’s AI SDK, and OpenAI’s Agents SDK to integrate with Cashfree APIs through function calling. Build AI-powered payment agents that can create orders, process refunds, and manage customers programmatically.

Pre-requisites

Ensure you meet the following requirements to get started with the Cashfree Agent Toolkit:

• Create a Cashfree Merchant Account.
• Log in to the Merchant Dashboard and generate App ID and Secret Key. Learn how to generate API keys.
• Ensure Node.js version 18 or later is installed.

Installation

Install the toolkit using your preferred package manager:

npm

npm install @cashfreepayments/agent-toolkit

Framework support

The toolkit supports multiple frameworks, exposed through sub-paths:

Framework	Import path	Description
OpenAI	@cashfreepayments/agent-toolkit/openai	For Chat Completions API and Agents SDK
LangChain	@cashfreepayments/agent-toolkit/langchain	For LangChain agents
Vercel AI SDK	@cashfreepayments/agent-toolkit/ai-sdk	For Vercel’s AI SDK

Usage

Each toolkit is initialised with your Cashfree credentials and environment configuration.

OpenAI

import {
  CashfreeAgentToolkit,
  CFEnvironment,
} from '@cashfreepayments/agent-toolkit/openai';

const environment = CFEnvironment.SANDBOX; // or PRODUCTION
const clientId = process.env.CASHFREE_CLIENT_ID;
const clientSecret = process.env.CASHFREE_CLIENT_SECRET;

const cashfree = new CashfreeAgentToolkit(environment, clientId, clientSecret);

Available tools

The toolkit provides the following tools for payment operations:

Tool	Description
createOrder	Create a new order
getOrder	Retrieve details of an existing order
terminateOrder	Terminate or cancel an order
createRefund	Initiate a refund for an order
getAllRefunds	List all refunds for an order
getRefund	Retrieve details of a specific refund
orderPayUsingUpi	Pay for an order using UPI
orderPayUsingNetbanking	Pay for an order using Netbanking
orderPayUsingApp	Pay for an order using a payment app
orderPayUsingPlainCard	Pay for an order using a plain card
orderPayUsingSavedCard	Pay for an order using a saved card
createCustomer	Create a new customer in Cashfree
fetchCustomerInstruments	Fetch saved payment instruments for a customer

Framework-specific examples

The following examples demonstrate how to use the toolkit with each supported framework.

OpenAI

The OpenAI integration works with both Chat Completions API and the Agents SDK.

Initialise the toolkit

Set up the Cashfree Agent Toolkit with your credentials and environment configuration.

Initialisation

import {
  CashfreeAgentToolkit,
  CFEnvironment,
} from "@cashfreepayments/agent-toolkit/openai";

const cashfreeToolkit = new CashfreeAgentToolkit(
  CFEnvironment.SANDBOX,
  process.env.CASHFREE_CLIENT_ID,
  process.env.CASHFREE_CLIENT_SECRET,
);

With Chat Completions API

Use the toolkit with OpenAI’s Chat Completions API by passing the tools as JSON schema.

Chat Completions

const completion = await openai.chat.completions.create({
  model: 'gpt-4o',
  messages: [...],
  tools: cashfreeToolkit.getTools(), // Returns JSON schema
});

With OpenAI Agents SDK

Integrate the toolkit with OpenAI’s Agents SDK for building autonomous payment agents.

All tools

import { Agent } from "@openai/agents";

const agent = new Agent({
  model: "gpt-4o",
  tools: cashfreeToolkit.getAgentTools(),
});

For detailed OpenAI documentation, see the OpenAI integration guide.

LangChain

The LangChain integration enables LangChain agents to integrate with Cashfree APIs.

Initialise the toolkit

Set up the Cashfree Agent Toolkit with your credentials and environment configuration.

Initialisation

import {
  CashfreeAgentToolkit,
  CFEnvironment,
} from "@cashfreepayments/agent-toolkit/langchain";

const cashfreeToolkit = new CashfreeAgentToolkit(
  CFEnvironment.SANDBOX,
  process.env.CASHFREE_CLIENT_ID,
  process.env.CASHFREE_CLIENT_SECRET,
);

Load tools into an agent

Load all available Cashfree payment tools into your LangChain agent or select specific tools your agent needs for more focused functionality.

All tools

import { createAgent } from "langchain";

const tools = cashfreeToolkit.getTools();
const agent = createAgent({ model, tools });

For detailed LangChain documentation, see the LangChain integration guide.

Vercel AI SDK

The Vercel AI SDK integration enables Vercel’s AI SDK to integrate with Cashfree APIs through function calling.

Initialise the toolkit

Set up the Cashfree AI SDK Toolkit with your credentials and environment configuration.

Initialisation

import {
  CashfreeAISDKToolkit,
  CFEnvironment,
} from "@cashfreepayments/agent-toolkit/ai-sdk";

const cashfreeToolkit = new CashfreeAISDKToolkit(
  CFEnvironment.SANDBOX,
  process.env.CASHFREE_CLIENT_ID,
  process.env.CASHFREE_CLIENT_SECRET,
);

Use tools with generateText

Load all available Cashfree payment tools for comprehensive functionality or select specific tools your application needs for more focused functionality.

Specific tools

import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";

const result = await generateText({
  model: openai("gpt-4o"),
  tools: {
    createOrder: cashfreeToolkit.tools.createOrder,
    getOrder: cashfreeToolkit.tools.getOrder,
  },
  prompt: "Create an order for Rs. 500",
});

For detailed Vercel AI SDK documentation, see the AI SDK integration guide.

Example payment agent

The following example demonstrates a complete payment agent using the OpenAI Agents SDK:

Payment agent

import { Agent, run } from '@openai/agents';
import {
  CashfreeAgentToolkit,
  CFEnvironment,
} from '@cashfreepayments/agent-toolkit/openai';

// Initialize the toolkit
const cashfree = new CashfreeAgentToolkit(
  CFEnvironment.SANDBOX,
  process.env.CASHFREE_CLIENT_ID,
  process.env.CASHFREE_CLIENT_SECRET
);

// Create an agent with all payment tools
const agent = new Agent({
  name: 'Payment Agent',
  instructions: 'You are a helpful payment assistant.',
  model: 'gpt-4o',
  tools: cashfree.getAgentTools(),
});

// Run the agent
const result = await run(
  agent,
  'Look up customer cust_123 and create an order for Rs. 500'
);

Resources

Explore additional resources to help you get started with the Cashfree Agent Toolkit.

GitHub Repository

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

npm Package

View the package on npm for installation and version details.