> ## Documentation Index
> Fetch the complete documentation index at: https://www.cashfree.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Cashfree Spark

> Spark is Cashfree's agentic layer in the Merchant Dashboard. Ask about your business data, or have it process refunds, create offers, and more.

Spark is available from the search bar at the top of every Merchant Dashboard page. Instead of navigating to a specific page, filter, or workflow, type a question or use voice input, in English or in your own language, and Spark reads your account data, investigates, and acts on your behalf.

* "Why did my settlement come in lower than expected?" Spark investigates your account data and explains the discrepancy.
* "Why did this payment fail?" Spark finds the transaction and explains the failure reason.
* "Refund the second one." Spark resolves this against the failed payments it just listed, checks eligibility, asks you to confirm, and processes the refund.

## Try asking

Spark understands plain language questions about your business, including diagnostic questions that would otherwise take you across several dashboard pages to answer. Here are a few prompts to get started.

* "Sales today"
* "Why is today's settlement lower than yesterday's?"
* "Next settlement"
* "Refunds this week"
* "Success rate"
* "Check recent tickets"
* "Create a 10% discount offer for all customers"

## How Spark works

Spark is built as a multi-agent system. An orchestration layer routes each request to domain-specific agents and their own tools, which lets Spark investigate a request and act on it, rather than only generate an answer.

* **Grounded**: Every response is fetched live from the same services that power the dashboard, covering sales, settlements, refunds, disputes, and support tickets. If Spark cannot retrieve a figure, it says so instead of estimating one.
* **Gated**: Reading is free. Anything that changes data or moves money requires your explicit confirmation, and Spark shows the exact steps it will take before you approve them.
* **Auditable**: Spark follows the Merchant Dashboard's existing authorization model. If your role cannot perform an action in the dashboard, it cannot perform that action through Spark. An alias user is limited exactly as they would be when clicking through the dashboard, and reporting actions stay restricted to account owners.
* **In context**: Spark retains context within a conversation, so a follow-up such as "and refund the second one" resolves against what you were just looking at, without repeating earlier details.

Spark runs on Cashfree's own infrastructure, inside your existing account and permissions. There is nothing to install, and Spark doesn't create a separate copy of your data.

## Access Spark

You can open Spark from any page in the Merchant Dashboard by following these steps.

<Steps>
  <Step title="Open the search bar">
    Select the search bar at the top of the dashboard. It's labelled **Ask Spark about your business**.
  </Step>

  <Step title="Enter your question">
    Type your question, or select the microphone icon to ask using voice.
  </Step>

  <Step title="Review the response">
    Spark opens in a side drawer with a response, rendered as metrics, tables, charts, or a proposed action. If you ask for a report, Spark returns a summary in the drawer with a link to download the full file. You can ask follow-up questions, expand the drawer to full screen, or start a new conversation at any time.
  </Step>
</Steps>

<Note>
  Spark generates responses from your account data for guidance only. Review any suggested action before you confirm it.
</Note>

## What Spark can do

Spark supports answering questions about your business, investigating what happened, and taking action on your account.

### Query and diagnose

Ask Spark about your business performance, and it returns a structured answer with supporting charts or tables where relevant.

* Sales totals, trends, and comparisons across time periods.
* Settlement schedules and unsettled balances.
* Refund volumes and patterns.
* Payment success and failure rates, including why a specific payment failed.
* Transaction breakdowns by payment method.
* Support ticket status.
* Dispute status and details.
* Failed webhook deliveries and the reason each one failed.
* Whitelisted domains and configured limits.
* How a Cashfree feature works.

### Take action

Spark can also make changes to your account on your behalf. Before it does, it always presents the exact steps it will take and asks you to confirm.

* Process a refund.
* Create a new offer or coupon.
* Pause an active offer.
* Initiate an instant settlement.
* Create a payment link.
* Generate a report.
* Cancel an order.
* Replay a failed webhook.
* Whitelist a new domain or adjust a limit.

<Important>
  Spark never makes changes to your account without explicit confirmation. If you don't confirm a proposed action, Spark makes no change.
</Important>

## Use Spark

The following scenarios show how to use Spark for common tasks.

### Diagnostic scenarios

<AccordionGroup>
  <Accordion title="Check today's sales" icon="chart-line">
    Get an instant read on how your business is performing today.

    <Steps>
      <Step title="Ask">
        "Sales today"
      </Step>

      <Step title="Review">
        Spark returns your total sales for the day, compared to the previous day, along with a trend chart.
      </Step>

      <Step title="Refine">
        Ask a follow-up, such as comparing sales to the same day last week or breaking sales down by payment method.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Check your next settlement" icon="sack-dollar">
    Confirm when your funds will reach your bank account.

    <Steps>
      <Step title="Ask">
        "Next settlement"
      </Step>

      <Step title="Review">
        Spark shows your upcoming settlement amount and date, your last settlement, and your current unsettled balance.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Monitor refunds" icon="rotate-left">
    Track refund volumes against your normal range for a selected period.

    <Steps>
      <Step title="Ask">
        "Refunds this week"
      </Step>

      <Step title="Review">
        Spark returns your refund total for the period and flags whether it falls within your normal range.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Review payment success rate" icon="percent">
    Compare your current success rate against the previous period and see where transactions drop off.

    <Steps>
      <Step title="Ask">
        "Success rate"
      </Step>

      <Step title="Review">
        Spark returns your current success rate, compares it to the previous period, and breaks down the split between successful, dropped, failed, and pending transactions.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Break down sales by payment method" icon="chart-pie">
    See which payment methods drive the most sales on your account.

    <Steps>
      <Step title="Ask">
        "Show me a breakdown of sales by payment mode"
      </Step>

      <Step title="Review">
        Spark returns a split of sales across payment methods, such as UPI, cards, and net banking, with a chart and per-method totals.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Check support tickets" icon="headset">
    Get a quick summary of your open and recently resolved tickets.

    <Steps>
      <Step title="Ask">
        "Check recent tickets"
      </Step>

      <Step title="Review">
        Spark summarises your open and recently resolved tickets and offers to help move the oldest one forward.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Check a dispute" icon="gavel">
    Review a customer dispute without switching to the Disputes tab.

    <Steps>
      <Step title="Ask">
        "Show me the dispute for order ORD789"
      </Step>

      <Step title="Review">
        Spark returns the dispute details, including the reason, the amount, and the date your response is due.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Ask about a Cashfree feature" icon="circle-question">
    Get an answer from Cashfree product documentation without leaving the dashboard.

    <Steps>
      <Step title="Ask">
        "How does instant settlement pricing work?"
      </Step>

      <Step title="Review">
        Spark answers using Cashfree product documentation and links to the relevant page for more detail.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

### Action scenarios

<AccordionGroup>
  <Accordion title="Process a refund" icon="hand-holding-dollar">
    Resolve a customer refund request directly from your conversation with Spark.

    <Steps>
      <Step title="Ask">
        "Refund payment PAY456"
      </Step>

      <Step title="Review the plan">
        Spark checks refund eligibility, then confirms the amount it will refund.
      </Step>

      <Step title="Confirm or adjust">
        Select **Yes, process it** to proceed, or specify a different amount.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Create a new offer" icon="tag">
    Set up a discount offer without leaving your conversation with Spark.

    <Steps>
      <Step title="Ask">
        "Create a 10% discount offer for all customers"
      </Step>

      <Step title="Review the plan">
        Spark shows the exact configuration it will create, including the coupon code, discount value, eligible customers, and validity.
      </Step>

      <Step title="Confirm or adjust">
        Select **Yes, create it** to proceed, or describe a change you'd like instead.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Pause an active offer" icon="circle-pause">
    Stop a live offer from accepting further redemptions, without affecting past ones.

    <Steps>
      <Step title="Ask">
        "Pause offer OFF10"
      </Step>

      <Step title="Review the plan">
        Spark confirms which offer it will pause and clarifies that existing redemptions aren't affected.
      </Step>

      <Step title="Confirm or adjust">
        Select **Yes, pause it** to proceed, or select **Keep it live** to cancel.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Initiate an instant settlement" icon="bolt">
    Move your available balance to your bank account ahead of your regular settlement cycle.

    <Steps>
      <Step title="Ask">
        "Settle now" or "Instant settlement"
      </Step>

      <Step title="Review the plan">
        Spark shows the available balance, the instant settlement fee, the net amount, and the destination bank account.
      </Step>

      <Step title="Confirm or adjust">
        Select **Yes, settle now** to proceed.
      </Step>
    </Steps>

    <Note>
      Cashfree deducts instant settlement fees from the settled amount. Funds typically arrive in your bank account within 15 minutes of confirmation.
    </Note>
  </Accordion>

  <Accordion title="Create a payment link" icon="link">
    Generate a payment request without opening the payment links form.

    <Steps>
      <Step title="Ask">
        "Create a payment link for ₹2,000 for customer Rahul Sharma, valid for 24 hours"
      </Step>

      <Step title="Review the plan">
        Spark shows the exact link configuration it will create, including the amount, customer details, and validity period.
      </Step>

      <Step title="Confirm or adjust">
        Select **Yes, create it** to proceed, or describe a change you'd like instead.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Generate a report" icon="file-lines">
    Get a reconciliation or summary report without opening the Reports section.

    <Steps>
      <Step title="Ask">
        "Generate a settlement reconciliation report for last month"
      </Step>

      <Step title="Review">
        Spark generates the report and returns a summary with a link to download the full file.
      </Step>
    </Steps>

    <Note>
      Report generation is restricted to account owners, matching the Merchant Dashboard's existing permissions.
    </Note>
  </Accordion>

  <Accordion title="Cancel an order" icon="ban">
    Stop an order before it's paid, without opening the orders table.

    <Steps>
      <Step title="Ask">
        "Cancel order ORD12345"
      </Step>

      <Step title="Review the plan">
        Spark confirms which order it will cancel and that no further payments can be made against it.
      </Step>

      <Step title="Confirm or adjust">
        Select **Yes, cancel it** to proceed, or select **Keep it open** to cancel the request.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Find and replay a failed webhook" icon="webhook">
    Catch a silent integration failure and resend it, without checking your webhook logs manually.

    <Steps>
      <Step title="Ask">
        "Which webhook alerts to my system failed yesterday? Resend them."
      </Step>

      <Step title="Review">
        Spark lists the failed webhook deliveries and the reason each one failed.
      </Step>

      <Step title="Confirm or adjust">
        Select **Yes, resend them** to proceed, or ask Spark to resend only specific ones.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Whitelist a domain or adjust a limit" icon="shield-check">
    Update an account preference without raising a support ticket.

    <Steps>
      <Step title="Ask">
        "Whitelist checkout.mystore.com for webhooks"
      </Step>

      <Step title="Review the plan">
        Spark confirms the domain or limit it will update and the current value it will replace.
      </Step>

      <Step title="Confirm or adjust">
        Select **Yes, update it** to proceed, or describe a change you'd like instead.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## Resources

Explore other tools in the Cashfree AI Stack that work alongside Spark.

<CardGroup cols={2}>
  <Card title="MCP Server" icon="server" href="/docs/tools-ai/mcp-server">
    Connect AI clients such as Claude and ChatGPT to your Cashfree account using the Model Context Protocol.
  </Card>

  <Card title="Web Dashboard" icon="table-columns" href="/docs/payments/dashboard">
    Explore the full Merchant Dashboard structure that Spark operates within.
  </Card>
</CardGroup>