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

# Stripe

> Manage customers, payments, subscriptions, invoices, and billing in Stripe — monitor your revenue and automate financial workflows from Mantle

Connect your Stripe API key and let your AI agents manage customers, track payments, handle subscriptions, and monitor
disputes. Stripe also supports event triggers, so tasks can react to payment events.

***

## What you unlock

<CardGroup cols={2}>
  <Card title="Customer management" icon="users">
    Look up customers, list subscriptions, and review payment history — all through natural language.
  </Card>

  <Card title="Payment tracking" icon="credit-card">
    List payment intents, check balances, review invoices, and monitor disputes without opening the Stripe dashboard.
  </Card>

  <Card title="Subscription oversight" icon="rotate">
    View active subscriptions, track pricing, and monitor recurring revenue across your customer base.
  </Card>

  <Card title="Event triggers" icon="bolt">
    Fire agent tasks automatically when payments are received, refunds are issued, or subscriptions change.
  </Card>
</CardGroup>

***

## Connect Stripe

<Steps>
  <Step title="Open Settings → Integrations">
    In any workspace go to **Settings → Integrations** and select **Stripe**.
  </Step>

  <Step title="Create a restricted API key">
    Open [dashboard.stripe.com/apikeys](https://dashboard.stripe.com/apikeys), create a restricted API key with the
    permissions your agent needs (e.g., read access to customers, payments, and subscriptions), and copy it — it starts
    with `rk_live_` or `rk_test_`.
  </Step>

  <Step title="Paste and connect">Paste the key into the **API Key** field and click **Connect**.</Step>
</Steps>

<Note>
  Use a **restricted key** with only the permissions your agent needs rather than your secret key. This follows the
  principle of least privilege and keeps your Stripe account secure.
</Note>

***

## Agent tools

Add Stripe tools to agents that need them. Their access is limited by the connected key and selected tools.

### Customers & Subscriptions

| Tool               | Description                                   |
| ------------------ | --------------------------------------------- |
| List customers     | List customers with optional filters          |
| Search customers   | Search customers by email, name, or metadata  |
| List subscriptions | List all subscriptions or filter by customer  |
| List products      | List all products in your catalog             |
| List prices        | List pricing configurations for your products |

### Payments & Invoices

| Tool                 | Description                              |
| -------------------- | ---------------------------------------- |
| List payment intents | List payment intents with status filters |
| Retrieve balance     | Check your Stripe account balance        |
| List invoices        | List invoices with optional filters      |
| List disputes        | List open and resolved disputes          |
| List coupons         | List available coupons and promotions    |

### API & Documentation

| Tool                    | Description                                            |
| ----------------------- | ------------------------------------------------------ |
| Get account info        | Retrieve your Stripe account details                   |
| Search documentation    | Search Stripe's documentation for API details          |
| API details             | Get details about specific Stripe API endpoints        |
| Search API              | Search the Stripe API schema for resources and methods |
| Integration recommender | Get recommendations for your Stripe integration setup  |

***

## Triggers

Triggers start an agent task automatically when something changes in Stripe.

<Steps>
  <Step title="Create a task with a Stripe trigger">
    Open any agent, go to the **Tasks** tab, and add a new task. In the trigger picker, choose **Integration → Stripe**.
  </Step>

  <Step title="Choose which events to watch">
    Pick one or more of the available events.

    | Event                  | When it fires                          |
    | ---------------------- | -------------------------------------- |
    | Payment received       | A payment intent succeeds              |
    | Refund issued          | A refund is created or updated         |
    | Subscription started   | A new subscription is created          |
    | Subscription cancelled | A subscription is cancelled or expires |
  </Step>

  <Step title="Authorize events">
    The first time you save a Stripe trigger task, Mantle asks you to approve the event connection in Stripe.
  </Step>
</Steps>

***

## Example use cases

<AccordionGroup>
  <Accordion title="Revenue check on demand">
    Ask your agent "What's our Stripe balance?" or "How many payments came in today?" and it retrieves the data
    instantly — no dashboard login required.
  </Accordion>

  <Accordion title="Alert on failed payments">
    **Trigger:** Payment received (filtered to failures)

    When a payment fails, an agent posts the customer name, amount, and failure reason to your #billing channel so
    someone can follow up immediately.
  </Accordion>

  <Accordion title="Churn alert on subscription cancellation">
    **Trigger:** Subscription cancelled

    When a subscription is cancelled, the agent fetches the customer details, calculates their lifetime value, and
    posts a summary to #revenue — helping your team decide whether to reach out.
  </Accordion>
</AccordionGroup>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="My API key isn't working">
    Make sure the key was created at [dashboard.stripe.com/apikeys](https://dashboard.stripe.com/apikeys). Restricted
    keys start with `rk_live_` or `rk_test_`. If using test mode, make sure you're looking at test data.
  </Accordion>

  <Accordion title="Agent can read data but can't perform actions">
    Restricted API keys have granular permissions. Go to your Stripe dashboard and verify the key has write access to
    the resources the agent needs (e.g., customers, subscriptions).
  </Accordion>

  <Accordion title="Trigger tasks aren't firing">
    1. Confirm the task is **active** (green indicator on the Tasks tab). 2. Check that the trigger is set to **Stripe**
       with the right events selected. 3. Re-authorize the event connection if Mantle shows that it expired.
  </Accordion>

  <Accordion title="Test mode vs live mode">
    Stripe test keys (starting with `rk_test_`) only see test data. If you don't see your real customers, make sure
    you're using a live mode key.
  </Accordion>
</AccordionGroup>

***

<Card title="Back to Integrations" icon="plug" href="/integrations/overview">
  View all available integrations
</Card>