Integration

Cashfree Payments integration

Cashfree Payments is an Indian payment gateway. Create orders and read their payments, capture or void pre-authorised payments, issue and cancel refunds, create and cancel payment links, read settlements and reconciliation reports, check which payment methods, offers, EMI and pay-later options an order is eligible for, create offers, manage disputes, run Easy Split vendor splits, transfers and adjustments, manage subscriptions, plans, charges and their refunds, read saved cards, card BIN details and payment-method downtimes, and simulate payments and settlements in sandbox. Left out: the payment-initiation routes that take card or bank details from the customer (Order Pay, OTP submission), Easy Split vendor onboarding with bank and KYC documents, softPOS terminals and soundboxes, card cryptograms and PAR lookups, and the controlled subscription notifications. Bank account and card numbers are removed from every answer. Authentication is the Client ID and Client Secret from the Merchant Dashboard (Developers, API Keys), sent as x-client-id and x-client-secret; choose the environment, api (production) or sandbox, each with its own keys.

Connect Cashfree Payments How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Cashfree Payments.Built from the 68 Cashfree Payments tools below, on the connection you add once.

What you can do with Cashfree Payments

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Dispute, 5 operations

accept_disputeAccept disputePUTAccepts a dispute, agreeing with the customer's claim instead of contesting it: Cashfree then refunds the disputed amount to the customer. Moves real money in production.
contest_arbitration_disputeContest arbitration disputePUTContests an ARBITRATION dispute, with an optional note and no documents. For other disputes send evidence with submit_dispute_evidence.
get_disputeGet disputeGETReturns one dispute by its dispute_id: type, reason, amount, status, respond-by date, preferred evidence, evidence sent and order details.
list_order_disputesList order disputesGETLists the disputes (chargebacks) raised on an order: type, reason, amount, status, respond-by date and evidence asked for.
list_payment_disputesList payment disputesGETLists the disputes (chargebacks) raised on one payment, found by its cf_payment_id.

Refund, 4 operations

cancel_refundCancel refundPUTCancels a refund that has not been processed yet: refund_status must be CANCELLED (the only value the vendor allows). Returns the refund.
create_refundCreate refundPOSTRefunds all or part of a paid order to the customer, within six months of the payment. refund_id must be unique. In sandbox, refund_note SUCCESS, FAILED, PENDING or ACTIVE simulates that status. Moves real money in production.
get_refundGet refundGETReturns one refund of an order by its refund_id: amount, status (SUCCESS, PENDING, PENDING_APPROVAL, CANCELLED, ONHOLD or REJECTED), ARN, speed, charges and times.
list_order_refundsList order refundsGETLists every refund made on an order, with amount, status, speed, ARN and times.

Order, 3 operations

create_orderCreate orderPOSTCreates an order to collect a payment and returns payment_session_id, which your checkout uses to let the customer pay. Creating an order charges nobody.
get_orderGet orderGETReturns an order by its order_id: amount, currency, order_status (ACTIVE, PAID, EXPIRED or TERMINATED), customer details, meta, tags and splits. Use it to check whether an order is paid.
terminate_orderTerminate orderPATCHAsks Cashfree to terminate an unpaid order so it can no longer be paid. Read order_status in the answer: TERMINATION_REQUESTED means the request is still being processed.

Order split, 3 operations

get_order_split_detailsGet order split detailsGETReturns the split and settlement details of each vendor of one order: split amounts, settled and unsettled transactions.
search_order_split_detailsSearch order split detailsPOSTReturns the split and settlement details per vendor for several orders (order_ids) or a date range, cursor-paginated. Read-only despite POST.
split_order_after_paymentSplit order after paymentPOSTSplits a paid order among Easy Split vendors by amount or percentage. Wait 2 minutes after the payment succeeds before calling. disable_split true ends further splits. Moves real money in production.

Payment, 3 operations

capture_or_void_paymentCapture or void paymentPOSTCaptures (action CAPTURE, with amount) or voids (action VOID) a pre-authorised payment of an order. Capturing charges the customer; voiding releases the hold. Moves real money in production.
get_order_paymentGet order paymentGETReturns one payment attempt of an order by its cf_payment_id: status, amount, payment method, gateway details and time. Card and bank account numbers are left out.
list_order_paymentsList order paymentsGETLists every payment attempt of an order with its status, amount, payment method, bank reference and time. Card and bank account numbers are left out.

Payment link, 3 operations

cancel_payment_linkCancel payment linkPOSTCancels an ACTIVE payment link so it can no longer be paid. Returns the link.
create_payment_linkCreate payment linkPOSTCreates a payment link and returns its link_url. link_notify makes Cashfree send the link to the customer by SMS or email, and link_auto_reminders sends payment reminders.
get_payment_linkGet payment linkGETReturns a payment link by its link_id: status, amount, amount paid, link URL, QR code, customer and notification settings.

Saved card, 3 operations

delete_saved_cardDelete saved cardDELETEDeletes a card a customer saved in Cashfree's Token Vault. The customer must save it again to reuse it.
get_saved_cardGet saved cardGETReturns one saved card of a customer from the Token Vault by its instrument_id: masked number, network, bank, type and status.
list_saved_cardsList saved cardsGETLists the cards a customer saved in Cashfree's Token Vault: masked number, network, bank, type and token details. instrument_type must be card.

Settlement, 3 operations

get_order_settlementGet order settlementGETReturns the latest settlement linked to an order, including pending and failed ones, with its order, payment, customer and settlement details.
list_settlementsList settlementsPOSTLists settlements of every status (SUCCESS, PENDING, PENDING_WITH_CASHFREE, PENDING_WITH_BANK, FAILED), filtered by settlement IDs, UTRs, status or a date range. Read-only despite POST.
mark_order_for_settlementMark order for settlementPOSTPasses an order's CBRIKS ID and settlement date to Cashfree and marks the order for settlement. Affects when its funds are settled.

Subscription, 3 operations

create_subscriptionCreate subscriptionPOSTCreates a subscription for a customer on a plan and returns subscription_session_id, used for the customer's authorisation. subscription_meta.notification_channel (SMS, EMAIL) can contact the customer.
get_subscriptionGet subscriptionGETReturns a subscription by its subscription_id: status, plan, customer, authorisation, next schedule date, splits and tags. Bank account and card numbers are left out.
manage_subscriptionManage subscriptionPOSTCancels, pauses, activates or changes the plan of a subscription (action). To change the recurring amount, create a new plan and use CHANGE_PLAN with its plan_id.

Subscription payment, 3 operations

get_subscription_paymentGet subscription paymentGETReturns one payment of a subscription by its payment_id: type, status, amount, schedule and failure details.
list_subscription_paymentsList subscription paymentsGETLists the payments (authorisation and charges) of a subscription with status, amount and schedule. Bank account and card numbers are left out.
manage_subscription_paymentManage subscription paymentPOSTCancels a scheduled subscription payment or retries a failed one (action CANCEL or RETRY). A retry charges the customer again. Moves real money in production.

Downtime, 2 operations

get_downtimeGet downtimeGETReturns one payment-method downtime by its ID: status, impact, type, affected method and times.
list_downtimesList downtimesGETLists payment-method downtimes (incidents) across banks, UPI, cards and wallets, active ones by default, filtered by status, impact, type, time or method.

Easy split sandbox, 2 operations

enable_easy_split_sandboxEnable easy split sandboxPOSTSandbox only: enables Easy Split on your merchant ID and creates sample vendors asynchronously; poll get_easy_split_sandbox_status until ACTIVE. Not idempotent.
get_easy_split_sandbox_statusGet easy split sandbox statusGETSandbox only: returns the Easy Split configuration of your merchant ID; poll it after enable_easy_split_sandbox until the status is ACTIVE.

Offer, 2 operations

create_offerCreate offerPOSTCreates an offer (DISCOUNT, CASHBACK, DISCOUNT_AND_CASHBACK or NO_COST_EMI) with its code, validity window, terms and payment-method validations. Returns the offer and its offer_id.
get_offerGet offerGETReturns an offer by its offer_id: meta, terms, discount or cashback details, validations and status.

Payment simulation, 2 operations

get_payment_simulationGet payment simulationGETSandbox only: returns a payment simulation by its simulation_id.
simulate_paymentSimulate paymentPOSTSandbox only: forces the outcome (status, error code) of a payment, subscription payment or virtual account transfer you already started, to test your flow.

Plan, 2 operations

create_planCreate planPOSTCreates a subscription plan: PERIODIC (a recurring amount every interval) or ON_DEMAND (charges up to plan_max_amount when you raise them).
get_planGet planGETReturns a subscription plan by its plan_id: type, amounts, cycles, interval and status.

Settlement simulation, 2 operations

get_settlement_simulationGet settlement simulationGETSandbox only: returns a settlement simulation by its simulation_id.
simulate_settlementSimulate settlementPOSTSandbox only: simulates the settlement of successful orders (merchantOrderIds, or transactions since txnTime up to seven days back) with status SUCCESS, FAILED or PENDING.

Subscription refund, 2 operations

create_subscription_refundCreate subscription refundPOSTRefunds all or part of a successful subscription payment. In sandbox, refund_note SUCCESS, FAILED, PENDING or ACTIVE simulates that status. Moves real money in production.
get_subscription_refundGet subscription refundGETReturns a refund of a subscription payment by its refund_id: amount, status, speed and times.

Card bin, 1 operation

get_card_bin_detailsGet card bin detailsPOSTReturns the network, issuing bank, type, sub-type and country of a card from its BIN. Send only the first 8 digits, never a full card number. Read-only despite POST.

Cardless emi, 1 operation

list_eligible_cardless_emiList eligible cardless emiPOSTLists the cardless EMI options a customer is eligible for on an order or amount, found by the customer's phone number. Read-only despite POST.

Customer, 1 operation

create_customerCreate customerPOSTCreates a customer profile in Cashfree (phone number required) and returns its customer_uid for later payments, subscriptions or saved cards.

Dispute evidence, 1 operation

submit_dispute_evidenceSubmit dispute evidencePOSTUploads one evidence document (jpeg, jpg, png or pdf, up to 20 MB) to contest a dispute. Not for ARBITRATION disputes: use contest_arbitration_dispute.

Eligible offer, 1 operation

list_eligible_offersList eligible offersPOSTLists the offers an order or amount is eligible for, optionally filtered by offer type. Read-only despite POST.

Order extended, 1 operation

get_order_extendedGet order extendedGETReturns the extended data of an order: addresses, cart, offers, customer details, shipment details and delivery status.

Order shipment, 1 operation

update_order_shipmentUpdate order shipmentPUTAdds or updates the shipment details (courier, tracking numbers and URLs) or the delivery status of a PAID order. Send shipment_details, order_delivery_status, or both.

Paylater, 1 operation

list_eligible_paylaterList eligible paylaterPOSTLists the pay-later options a customer is eligible for on an order or amount. Read-only despite POST.

Payment link order, 1 operation

list_payment_link_ordersList payment link ordersGETLists the orders created through a payment link; status ALL returns every order, PAID (the vendor default) only paid ones.

Payment method, 1 operation

list_eligible_payment_methodsList eligible payment methodsPOSTLists the payment methods enabled for an amount or an order, optionally filtered. Read-only despite POST.

Payment reconciliation, 1 operation

get_payment_reconciliationGet payment reconciliationPOSTReturns payment gateway reconciliation events of your account for a date range (filters.start_date and end_date), cursor-paginated. Read-only despite POST.

Settlement reconciliation, 1 operation

get_settlement_reconciliationGet settlement reconciliationPOSTReturns settlement reconciliation events (with their order, payment, refund, dispute and settlement details) for settlement IDs, UTRs or a date range, cursor-paginated. Read-only despite POST.

Static split, 1 operation

create_static_splitCreate static splitPOSTCreates or deactivates a static split scheme: the vendor-wise percentages applied automatically to payment gateway (PG) or subscription (SBC) payments.

Subscription charge, 1 operation

raise_subscription_chargeRaise subscription chargePOSTRaises a charge of payment_amount on a subscription (payment_type CHARGE), processed on payment_schedule_date: it debits the customer. Moves real money in production.

Subscription payment method, 1 operation

list_subscription_payment_methodsList subscription payment methodsPOSTLists the payment methods available for a subscription's authorisation, with the banks and account types each supports. Read-only despite POST.

Vendor adjustment, 1 operation

create_vendor_adjustmentCreate vendor adjustmentPOSTCreates an adjustment that credits or debits (type) an Easy Split vendor's balance against the merchant. adjustment_id must be unique. Moves real money in production.

Vendor balance, 1 operation

get_vendor_balanceGet vendor balanceGETReturns the Easy Split balances of a vendor: amount available with the merchant and the vendor, and the unsettled amount of each.

Vendor reconciliation, 1 operation

get_vendor_reconciliationGet vendor reconciliationPOSTReturns Easy Split vendor reconciliation details filtered by settlement ID, vendor or date range, cursor-paginated (limit at least 10). Wait 15 minutes after a VENDOR_SETTLEMENT_SUCCESS webhook.

Vendor settlement simulation, 1 operation

simulate_vendor_settlementSimulate vendor settlementPOSTSandbox only: drives an Easy Split vendor settlement to INITIATED, SUCCESS or FAILED (and its VENDOR_SETTLEMENT_* webhook) for orders or a start time.

Vendor transfer, 1 operation

create_vendor_transferCreate vendor transferPOSTTransfers an Easy Split vendor's on-demand balance to the vendor or to the merchant (transfer_from), or moves funds between their ledgers (transfer_type ADJUSTMENT). Moves real money in production.

Vendor transfer charge, 1 operation

get_vendor_transfer_chargesGet vendor transfer chargesGETReturns the service charge and tax Cashfree applies to an on-demand vendor balance transfer of a given amount (rate_type VENDOR_ON_DEMAND).

Use Cashfree Payments from Claude Code, Cursor or Codex

Connect Cashfree Payments in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Cashfree Payments operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Cashfree Payments

Create your workspace
Sign up free. Nothing to install.
Connect Cashfree Payments once
Add your Cashfree Payments connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.